Get a list of User's UserChats
Retrieve UserChat of a particular User.
Parameter
Accessible via URL https://api.channel.io/open/v4/users/{userId}/user-chats and HTTP GET
Present parameters in query string
| Parameter | Example | Required | Description | Parameter type |
|---|---|---|---|---|
| userId | 12345 | Required | ID of User | Path |
| sortOrder | desc (or asc) | Optional | Sorting order. Default value is desc. (descending order means latest message first) | Query |
| since | 500000 | Optional | Epoch time in microseconds of the first message to be retrieved. If the since parameter is left empty, the list retrieved will start with the first message (as specified by the order parameter). | Query |
| limit | 40 | Optional | Restrict the maximum number of direct chats to be retrieved. - min : 1 - max : 500 - default : 25 | Query |
Example
Response
Returns a set of UserChat along with related information
{
"prev": "string",
"next": "string",
"messages": [
{
"chatKey": "string",
"id": "string",
"mainKey": "string",
"threadKey": "string",
"root": true,
"channelId": "string",
"chatType": "string",
"chatId": "string",
"personType": "string",
"personId": "string",
"requestId": "string",
"language": "string",
"createdAt": 1624422361866,
"version": 0,
"blocks": [
{
"type": "bullets",
"language": "string",
"value": "string",
"blocks": [
null
]
}
],
"plainText": "string",
"updatedAt": 1624422361868,
"buttons": [
{
"title": "string",
"colorVariant": "cobalt",
"url": "string"
}
],
"files": [
{
"id": "string",
"type": "string",
"name": "string",
"size": 0,
"contentType": "string",
"duration": 0,
"width": 0,
"height": 0,
"orientation": 0,
"animated": true,
"bucket": "string",
"key": "string",
"previewKey": "string",
"channelId": "string",
"chatId": "string",
"chatType": "string"
}
],
"webPage": {
"id": "string",
"url": "string",
"title": "string",
"description": "string",
"imageUrl": "string",
"videoUrl": "string",
"publisher": "string",
"author": "string",
"width": 0,
"height": 0,
"bucket": "string",
"previewKey": "string",
"logo": "string",
"name": "string"
},
"log": {
"action": "changeName",
"values": [
"string"
],
"triggerType": "string",
"triggerId": "string"
},
"reactions": [
{
"emojiName": "string",
"personKeys": [
"string"
]
}
],
"profileBot": [
{
"id": "string",
"key": "string",
"type": "string",
"name": "string",
"value": {
"s": "string",
"n": "string",
"b": {
"short": 0,
"char": "string",
"int": 0,
"long": 0,
"float": 0,
"double": 0,
"direct": true,
"readOnly": true
},
"m": {},
"l": [
null
],
"ss": [
"string"
],
"ns": [
"string"
],
"bs": [
{
"short": 0,
"char": "string",
"int": 0,
"long": 0,
"float": 0,
"double": 0,
"direct": true,
"readOnly": true
}
],
"null": true,
"bool": true
}
}
],
"state": "sending",
"options": [
"actAsManager"
],
"marketing": {
"type": "string",
"id": "string",
"advertising": true,
"exposureType": "fullScreen"
},
"supportBot": {
"id": "string",
"revisionId": "string",
"sectionId": "string",
"stepIndex": 0,
"buttons": [
{
"text": "string",
"nextSectionId": "string"
}
],
"submitButtonIndex": 0
},
"threadMsg": true,
"broadcastedMsg": true,
"rootMessageId": "string"
}
],
"sessions": [
{
"key": "string",
"chatId": "string",
"chatKey": "string",
"updatedKey": "string",
"unreadKey": "string",
"channelId": "string",
"alert": 0,
"unread": 0,
"watch": "all",
"readAt": 1624422354163,
"receivedAt": 1624422354163,
"postedAt": 1624422354163,
"updatedAt": 1624422354079,
"createdAt": 1624422354055,
"version": 0,
"id": "string",
"chatType": "string",
"personType": "string",
"personId": "string"
}
],
"userChats": [
{
"id": "string",
"channelId": "string",
"appUserKey": "string",
"state": "closed",
"managed": true,
"userId": "string",
"name": "string",
"description": "string",
"handling": "waiting",
"supportBot": {
"id": "string",
"revisionId": "string",
"sectionPath": [
"string"
]
},
"marketing": {
"type": "string",
"id": "string",
"enableSupportBot": true,
"supportBotId": "string"
},
"pluginId": "string",
"sourcePage": "string",
"messengerType": "string",
"messengerId": "string",
"managerIds": [
"string"
],
"assigneeId": "string",
"tags": [
"string"
],
"firstOpenedAt": 1624422369490,
"openedAt": 1624422369490,
"createdAt": 1624422369491,
"frontMessageId": "string",
"frontUpdatedAt": 1624422369491,
"deskMessageId": "string",
"deskUpdatedAt": 1624422369493,
"firstAssigneeIdAfterOpen": "string",
"firstRepliedAtAfterOpen": 1624422369490,
"oneStop": true,
"waitingTime": 0,
"avgReplyTime": 0,
"totalReplyTime": 0,
"replyCount": 0,
"resolutionTime": 0,
"operationWaitingTime": 0,
"operationAvgReplyTime": 0,
"operationTotalReplyTime": 0,
"operationReplyCount": 0,
"operationResolutionTime": 0,
"askedAt": 1624422369490,
"closedAt": 1624422369490,
"snoozedAt": 1624422369553,
"expiresAt": 1624422369554,
"version": 0
}
],
"users": [
{
"id": "string",
"channelId": "string",
"memberId": "string",
"veilId": "string",
"unifiedId": "string",
"name": "string",
"profile": {
"name": "string",
"empty": true,
"email": "string",
"avatarUrl": "string",
"mobileNumber": "string",
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
},
"profileOnce": {
"name": "string",
"empty": true,
"email": "string",
"avatarUrl": "string",
"mobileNumber": "string",
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
},
"tags": [
"string"
],
"alert": 0,
"unread": 0,
"popUpChatId": "string",
"blocked": true,
"unsubscribeEmail": false,
"unsubscribeTexting": false,
"hasChat": true,
"hasPushToken": true,
"language": "string",
"country": "string",
"city": "string",
"latitude": 0,
"longitude": 0,
"web": {
"device": "string",
"os": "string",
"osName": "string",
"browser": "string",
"browserName": "string",
"sessionsCount": 0,
"lastSeenAt": 1624422372181
},
"mobile": {
"device": "string",
"os": "string",
"osName": "string",
"appName": "string",
"appVersion": "string",
"sessionsCount": 0,
"lastSeenAt": 1624422372181
},
"sessionsCount": 0,
"lastSeenAt": 1624422361664,
"createdAt": 1624422361767,
"updatedAt": 1624422361664,
"version": 0,
"managedKey": 0,
"member": true,
"email": "string",
"avatarUrl": "string",
"mobileNumber": "string",
"systemLanguage": "string"
}
],
"managers": [
{
"id": "string",
"channelId": "string",
"accountId": "string",
"username": "string",
"name": "string",
"description": "string",
"email": "string",
"mobileNumber": "string",
"role": "owner",
"removed": true,
"createdAt": 1624422361892,
"defaultGroupWatch": "all",
"defaultDirectChatWatch": "all",
"defaultUserChatWatch": "all",
"operatorScore": 0,
"touchScore": 0,
"avatar": {
"bucket": "string",
"key": "string",
"width": 0,
"height": 0
},
"operatorEmailReminder": true,
"operator": true,
"operatorScheduling": true,
"operatorTimeRanges": {
"timeRanges": [
{
"dayOfWeeks": [
"mon"
],
"from": 0,
"to": 0
}
]
},
"avatarUrl": "string",
"managerId": "string"
}
],
"chatTags": [
{
"id": "string",
"channelId": "string",
"colorVariant": "red",
"name": "string",
"key": "string",
"description": "string",
"followerIds": [
"string"
],
"createdAt": 1624422354264
}
]
}
Updated about 1 year ago