.getChats()

This API is used to get a list of all the chats had by a visitor along with the details of each chat. It returns an array of VisitorChat objects.

Callbacks:

NameDescription
error

Error is returned if an error occurs while using the API. The list of possible error codes returned by the API are listed below.

chatsList of chats

​Error Codes:

CodeMessage
500mobilisten not initialised
605mobilisten disabled
600no network connection 
609salesiq api exception

Chat map contains the following properties:

PropertyDatatypeDescription
idStringThe  ID of the chat
questionStringThe question with which the chat was initiated
attenderNameStringName of the chat attender
attenderEmailStringEmail of the chat attender
attenderIDStringThe ID of the chat attender
departmentNameStringName of the department to which the chat is associated
feedbackStringFeedback provided for the chat
lastMessage 
(Deprecated)
StringLast message in the chat
statusSIQChatStatusThe status of the chat
ratingStringRating given for the chat
unreadCountintUnread message count for the chat
isBotAttenderboolFlag to check if the last chat was attended by a bot
lastMessageSender 
(Deprecated)
StringName of the last message sender
lastMessageTime 
(Deprecated)
longTime of the last message in the chat
queuePositionintPosition of the chat in current queue
recentMessageMapIt contains the last message's content and its metadata.

RecentMessage:

The RecentMessage object contains the last message's content and its metadata.

PropertyData typeDescription
timelongTime of the last message sent in chat
textStringLast message text in the chat
senderStringName of the sender of the last message
isReadbooleanTo check if the last message was read.
fileMapThis property will return the details of the file.

File:

If the last message is a file, this property provides details of the file.

PropertyData typeDescription
nameStringFile name of the last message
sizeintFile size of the last message
contentTypeStringFile MIME type of the last message (Ex: image/jpeg, video/mp4, audio/mp3, etc..)
commentStringFile comment of the last message

Syntax

CopiedZohoSalesIQ.getChats(callback: (error: CallbackError, chats: SalesIQChat[] | null) => void)

Example:

CopiedZohoSalesIQ.getChats( (error, chats) => 
{
    //your code
});