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

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

Two Factor Authentication

livechat:registerGuest

Last modified 8mo ago