Get a list of User's UserChats

Retrieve UserChat of a particular User.

Parameter

Accessible via URL https://api.channel.io/open/v3/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

Optional

Sorting order.

  • available values : asc, desc, both
  • default value : 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

GET https://api.channel.io/open/v3/users/12345/user-chats?states=open&sortField=updatedAt&sortOrder=desc&since=500000&limit=40

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,
      "unsubscribed": true,
      "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
    }
  ]
}