Constructor Detail

• OrigonClient

  OrigonClient(Context context, ClientConfig config)

Method Detail

• getStartMessage

   final String getStartMessage()

• getIsChatEnabled

   final Boolean getIsChatEnabled()

• getIsCallEnabled

   final Boolean getIsCallEnabled()

• getMultipleChannels

   final Boolean getMultipleChannels()

• getAttachmentPolicy

   final AttachmentPolicy getAttachmentPolicy()

• getServerConfig

   final ServerConfig getServerConfig()

• close

   Unit close()

• setAttributes

   final Unit setAttributes(JsonObject attributes)

  Replace session-level attributes injected as data.attributes on subsequent startSession calls. Pass null to clear.

• getSessions

   final List<SessionSummary> getSessions()

  GET /sessions — prior sessions for the configured userId.

• getSession

   final SessionHistory getSession(String id)

  GET /session/<id> — history for one session.

• startSession

   final StartSessionResponse startSession(StartSessionOptions options)

• joinSession

   final Unit joinSession(JoinSessionInput input)

  Attach to a session whose StartSessionResponse was obtained out of band (multi-device handoff, deeplink, persisted session).

• endSession

   final Unit endSession(String id)

• endAllSessions

   final Unit endAllSessions()

• activeSessions

   final List<ActiveSession> activeSessions()

  Snapshot of every active session.

• setMute

   final Unit setMute(String id, Boolean muted)

• setMuteAll

   final Unit setMuteAll(Boolean muted)

• toggleHold

   final Boolean toggleHold(String id)

  Returns the new hold state.

• sendDtmf

   final Unit sendDtmf(String id, Character digit, Integer durationMs)

  digit must be one of 0-9, *, #, A-D per RFC 4733.

• sendMessage

   final Message sendMessage(String id, SendMessagePayload payload)

  Chat-only — send a text / HTML message on the named session.

  Requires an active chat session for id (call startSession first). The SDK fires ClientEvent.MessageAdded (provisional, status == SENDING) before the wire round-trip and ClientEvent.MessageUpdated (delivered or failed) after — both surface on pollEvent. Returns the server-issued Message.

• notifyTyping

   final Unit notifyTyping(String id)

  Chat-only — register a keystroke on the named session. Cheap to call from a TextWatcher; the SDK debounces outbound <sessionUrl>/typing POSTs so only one wire call fires per typing burst.

• stopTyping

   final Unit stopTyping(String id)

  Chat-only — force outbound typing state to "off" immediately, cancelling any in-flight debounce. UI fires this on empty-text transitions; the SDK also fires it implicitly on sendMessage and on endSession.

• uploadAttachment

   final Attachment uploadAttachment(String sessionId, String path, String fileName, String uploadId, Function1<UploadProgress, Unit> onProgress)

  Upload a file from the local filesystem to the named session and return the server-issued Attachment. The SDK streams the body straight from disk; auto-detects MIME from a 256-byte head plus the fileName extension. Runs on Dispatchers.IO.

  uploadId doubles as the cancellation key — pass it as attachmentId to deleteAttachment while the upload is in flight to abort it (throws with kind = ERROR_CANCELLED). After completion, use the server-issued attachment.id for deletion.

  onProgress fires from a JNI worker thread; hop to the main thread before touching UI state. percent is null when the total size is unknown.

  Throws SessionException: ERROR_OTHER for filesystem errors, ERROR_ATTACHMENT for precheck failures (empty_file, policy_unsupported_type, policy_type_disabled, policy_too_large), ERROR_HTTP / ERROR_SERVER_UNAVAILABLE for wire failures, ERROR_CANCELLED when cancelled.

• uploadAttachment

   final Attachment uploadAttachment(String sessionId, Context context, Uri uri, String fileName, String uploadId, Function1<UploadProgress, Unit> onProgress)

  Convenience overload that copies a content:// (or file:// / android.resource://) uri into context.cacheDir before uploading, then deletes the cache file once the upload settles. The SDK can't open content:// URIs directly.

• uploadAttachment

   final Attachment uploadAttachment(String sessionId, Context context, ByteArray bytes, String fileName, String uploadId, Function1<UploadProgress, Unit> onProgress)

  Convenience overload for in-memory bytes: writes them to context.cacheDir first, then delegates to the path-based overload.

• deleteAttachment

   final Unit deleteAttachment(String sessionId, String attachmentId)

  Cancel an in-flight upload or delete a completed attachment on the named session.

  attachmentId is dual-purpose: it can be either the uploadId passed to uploadAttachment (cancels the in-flight upload — no network call, the upload's awaiter throws SessionException with kind = SessionBridge.ERROR_CANCELLED) or the server-issued attachment.id of a completed upload (issues DELETE on the server). The SDK figures it out: it checks its in-flight uploads table first, then falls through to the wire call.

  Runs on Dispatchers.IO. A 404 from the server surfaces as SessionException with kind = SessionBridge.ERROR_HTTP and statusCode == 404 — safe to treat as success when your intent was "remove the draft from the UI".

• pollEvent

   final ClientEvent pollEvent()

  Polls the next event. Returns null when the queue is idle.