USuspacy
chats

Get all chats

Retrieves a list of all chats available to the authenticated user. Optionally filter by chat type.

get/messenger/v1/chats

Request

Query parameters

typestring

Filter chats by type (e.g., PRIVATE, PUBLIC, GROUP, DIRECT, EXTERNAL)

Response

The chats list

idstring required

Chat id

membersstring required

Members ids

timestampnumber required

Timestamp of last message in chat

ownerIdnumber required

Owner id

namestring required

Chat name

pictureUrlstring required

Chat picture url

type'PRIVATE' | 'PUBLIC' | 'GROUP' | 'DIRECT' | 'EXTERNAL' required

Chat type

groupIdnumber required

Group id

portalsstring[] required

Portals

activeboolean required

Chat active

unreadCountnumber required

Unread messages count

pinnedboolean required

Pinned chat

pinnedTimestampnumber required

Pinned timestamp

Example response

[
  {
    "id": "76bfc2ff-207c-4b5a-8543-f7009b7f8872",
    "timestamp": 1709043064088,
    "ownerId": 1,
    "name": "Chat name",
    "pictureUrl": "https://example.com/picture.jpg",
    "type": "GROUP",
    "groupId": 1,
    "portals": [
      "portal1",
      "portal2"
    ],
    "externalLines": [
      {
        "id": "659ff121fd62e43063340f2f",
        "name": "Main line",
        "icon": "https://example.com/icon.png",
        "externalId": "externalId",
        "timestamp": 1620211200000,
        "portal": "portal",
        "phoneNumber": "+1234567890"
      }
    ],
    "lastMessage": {
      "id": "76bfc2ff-207c-4b5a-8543-f7009b7f8872",
      "timestamp": 1709043064088,
      "message": "Hello, world!",
      "type": "MESSAGE",
      "chatId": "76bfc2ff-207c-4b5a-8543-f7009b7f8872",
      "readBy": [
        1,
        2,
        3,
        4
      ],
      "externalLine": {
        "id": "659ff121fd62e43063340f2f",
        "name": "Main line",
        "icon": "https://example.com/icon.png",
        "externalId": "externalId",
        "timestamp": 1620211200000,
        "portal": "portal",
        "phoneNumber": "+1234567890"
      },
      "attachedFiles": [
        {
          "entityId": "659ff121fd62e43063340f2f",
          "entityType": "chat_message",
          "lastModified": 1613491200000,
          "originalFilename": "file.jpg",
          "size": "1024",
          "url": "https://example.com/file.jpg"
        }
      ],
      "relations": [
        {
          "action": "create",
          "service": "crm",
          "entity": "contact",
          "name": "659ff121fd62e43063340f2f",
          "pictureUrl": "https://example.com/picture.jpg",
          "entityId": "659ff121fd62e43063340f2f"
        }
      ],
      "externalAuthorId": "123456",
      "externalId": "123456",
      "ref": {
        "chatId": "76bfc2ff-207c-4b5a-8543-f7009b7f8872",
        "authorId": 1,
        "messageId": "76bfc2ff-207c-4b5a-8543-f7009b7f8872"
      },
      "meta": {
        "body": [
          {
            "text": "Hello, world!",
            "url": "https://www.instagram.com"
          }
        ]
      }
    },
    "meta": [
      {
        "type": "telegram",
        "value": "1234567890"
      }
    ],
    "active": true,
    "unreadCount": 1,
    "pinned": true,
    "pinnedTimestamp": 1709043064088
  }
]

Changes

No recorded changes to this operation across all 2 revisions of this API.