1MSG
ReferenceInbox API

Список диалогов

GET
/api/v1/inbox/conversations

Сначала диалоги с самым свежим lastMessageAt. Для следующей страницы передайте pagination.nextCursor в cursor.

Authorization

bearer
headerAuthorizationBearer <token>

Ключ выдаётся в Settings → Developer → API key. Методам Inbox нужен доступ Inbox, методам Campaigns — доступ Campaigns.

Query Parameters

limit?number

Размер страницы. По умолчанию 50.

cursor?string

pagination.nextCursor из предыдущей страницы (lastMessageAt в ISO).

channelId?string

Только один канал.

status?string

Статус диалога.

Value in"OPEN""CLOSED"
unread?boolean

true оставляет только диалоги с непрочитанными сообщениями.

tab?string

mine_open: открытые и назначенные на этот ключ. unassigned: открытые и ни на кого не назначенные. all: без дополнительного фильтра по вкладке.

Value in"mine_open""unassigned""all"
assigneeId?string

Только диалоги, назначенные на этого пользователя.

Response Body

application/json
  1. response
data*array<>
pagination*
curl -X GET 'https://api.1msg.io/api/v1/inbox/conversations'
{  "data": [    {      "id": "string",      "channelId": "string",      "contactId": "string",      "status": "OPEN",      "assignedTo": "string",      "assignedUser": {        "id": "b2bb82f0-2253-4e05-b955-a21f3d699caa",        "name": "QA Stage",        "avatar": null      },      "lastMessageAt": "2019-08-24T14:15:22Z",      "isUnread": true,      "tags": [        "string"      ],      "lastMessagePreview": "string",      "lastMessageType": "string",      "lastMessageDirection": "INBOUND",      "lastMessageStatus": "string",      "unreadCount": 0,      "isBlocked": true,      "title": "string",      "lastCustomerMessageAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "contact": {        "id": "string",        "phoneNumber": "79001234567",        "name": "string",        "avatar": "string"      },      "channelType": "WABA",      "customerPhone": "string"    }  ],  "pagination": {    "hasMore": true,    "nextCursor": "2019-08-24T14:15:22Z",    "limit": 50  }}