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:

FieldTypeDescription

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

Last updated

Rocket.Chat versions receive support for six months after release.