Class ChatSdk

constructor

• new ChatSdk(options): ChatSdk

• Parameters

  • options: ChatSDKOptions

  Returns ChatSdk

channelId

isLivechat

Optional onError

Optional onRawEvent

authorize

• authorize(authorizationCode?, visitorId?): Promise<ConsumerAuthorizationSuccessPayloadData | CustomerReconnectSuccessPayloadData>

• Send Authorization Event

  Parameters

  • Optional authorizationCode: string

    authorization code

  • Optional visitorId: VisitorId

    visitor id

  Returns Promise<ConsumerAuthorizationSuccessPayloadData | CustomerReconnectSuccessPayloadData>

  Throws

  AuthorizationError

  • This exception is thrown when the authorization or refresh token fails

generateAuthorizationToken

• generateAuthorizationToken(threadIdOnExternalPlatform, url): Promise<AuthorizationToken>

• Generate Authorization Token from the given url

  Parameters

  • threadIdOnExternalPlatform: ThreadIdOnExternalPlatform

    Thread Id

  • url: string

    Authorization Service URL

  Returns Promise<AuthorizationToken>

getChannelAvailability

• getChannelAvailability(): Promise<ChannelAvailabilityResponse>

• Get channel availability Returns channel availability Online/Offline

  Returns Promise<ChannelAvailabilityResponse>

  ChannelAvailabilityResponse

  Throws

  ChatSDKError

getChannelInfo

• getChannelInfo(): Promise<ChannelInfo>

• Get channel info Returns channel info like feature toggle status, translations, file upload restrictions, theme color settings etc.

  Returns Promise<ChannelInfo>

  ChannelInfo

  Throws

  ChatSDKError

getCustomer

• getCustomer(): null | Customer

• Get Customer instance

  Returns null | Customer

getThread

• getThread(id): Thread | LivechatThread

• Get Thread instance by id

  Parameters

  • id: ThreadIdOnExternalPlatform

    thread id

  Returns Thread | LivechatThread

  instance of thread based on channel settings

getThreadList

• getThreadList(): Promise<null | ThreadView[]>

• Get list of available threads

  Returns Promise<null | ThreadView[]>

  list of threads

getWebsocketClient

• getWebsocketClient(): null | WebSocketClient

• Get access to a websocket connection

  Returns null | WebSocketClient

  WebSocketClient instance

onChatEvent

• onChatEvent(type, handler): RemoveListenerFunction

• Register handler to chat event

  Parameters

  • type: ChatEventType

    type of chat event

  • handler: ((event) => void)

    event handler

    • • (event): void

      • Parameters

        • event: ChatCustomEvent<ChatEventData>

        Returns void

  Returns RemoveListenerFunction

  function to unregister handler

onErrorHandler

• onErrorHandler(error): void

• Parameters

  • error: unknown

  Returns void

recoverLivechatThreadData

• recoverLivechatThreadData(threadIdOnExternalPlatform?): AbortablePromise<ThreadRecoveredChatEvent>

• Recover livechat thread data

  Parameters

  • threadIdOnExternalPlatform: undefined | ThreadIdOnExternalPlatform = undefined

    thread id on external platform

  Returns AbortablePromise<ThreadRecoveredChatEvent>

  thread livechat session data

recoverThreadData

• recoverThreadData(threadIdOnExternalPlatform?): AbortablePromise<ThreadRecoveredChatEvent>

• Recover thread data

  Parameters

  • threadIdOnExternalPlatform: undefined | ThreadIdOnExternalPlatform = undefined

    thread id on external platform

  Returns AbortablePromise<ThreadRecoveredChatEvent>

  thread session data

sendOfflineMessage

• sendOfflineMessage(offlineMessageData): Promise<MessageSuccessEventData>

• Send the Offline Message

  Parameters

  • offlineMessageData: OfflineMessageData

    offline message data (name, email, message)

  Returns Promise<MessageSuccessEventData>

  success

  Throws

  SendMessageFailedError

  • This exception is thrown when a message fails to send. The error contains (error.data) a response from the backend with details.