Livechat Realtime API
This API is intended to be used for having a Livechat conversation;
- First of all you need to generate a visitor token (any random string);
- Call livechat:getInitialData passing
visitorToken
as first argument, the response will be an object containing a Livechat configuration object with following properties:
Field | Type | Description |
---|---|---|
enabled |
Boolean |
If whether Livechat is enabled for that server or not |
title |
String |
The Livechat widget title |
color |
Hexadecimal |
The hexadecimal color of the Livechat widget title bar when the Livechat is online |
registrationForm |
Boolean |
If the registration form should be displayed or not. |
room |
Object |
The current conversation room for the current guest user |
visitor |
Object |
The current guest user |
triggers |
Array |
Array of Livechat triggers. |
departments |
Array |
Array of Livechat departments. |
allowSwitchingDepartments |
Boolean |
If client-side department switching is allowed |
online |
Boolean |
If there are Livechat agents online |
offlineColor |
Hexadecimal |
The hexadecimal color of the Livechat widget title bar when the Livechat is offline |
offlineMessage |
String |
The message that will be displayed on the Livechat offline form |
offlineSuccessMessage |
String |
The message that will be displayed after send a message using the offline form |
offlineUnavailableMessage |
String |
The message that will be displayed when the Livechat is offline |
displayOfflineForm |
Boolean |
If the offline form will be displayed when the Livechat is offline |
videoCall |
Boolean |
If the VideoCall feature is available |
conversationFinishedMessage |
Boolean |
The system message that will be send to the current guest user when the conversation is closed |
nameFieldRegistrationForm |
Boolean |
If the name field will be displayed on Livechat registration form |
emailFieldRegistrationForm |
Boolean |
If the email field will be displayed on Livechat registration form |
offlineTitle |
String |
The title of the widget when the Livechat is offline |
language |
String |
The default user language to be set in the Livechat widget |
transcript |
Boolean |
If the Livechat widget will ask the current guest user if they would like a transcript after the conversation is closed |
transcriptMessage |
String |
The message to be displayed when asking about transcript |
agentData |
Object |
The current agent attending the chart |
- Call livechat:registerGuest to register guest and get the response containing the visitor’s data.
- Before sending the first message you have to generate a random
room _id
; - Now you can send messages to method sendMessageLivechat
- Subscribe to: stream-room-messages and
stream-livechat-room
- Get agent info by calling
livechat:getAgentData