1MSG
ReferenceInbox API

Один диалог

GET
/api/v1/inbox/conversations/{conversationId}

Вместе с контактом, ответственным и телефоном клиента.

Authorization

bearer
headerAuthorizationBearer <token>

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

Path Parameters

conversationId*string

id диалога

Response Body

application/json
  1. response
id*string
channelId*string

id канала, например QAF261225002

contactId*string
status*string

Через ключ можно поставить только OPEN или CLOSED. В старых записях могут встречаться другие значения.

Value in"OPEN""CLOSED""ASSIGNED""RESOLVED""BLOCKED"
assignedTo?|

id ответственного пользователя. null, если ответственного нет.

assignedUser?|null
lastMessageAt?|
Formatdate-time
isUnread*boolean
tags*array<string>
lastMessagePreview?string|null
lastMessageType?string|null
lastMessageDirection?|
Value in"INBOUND""OUTBOUND"
lastMessageStatus?string|null
unreadCount*number
isBlocked*boolean
title?|

Своё название. null, пока диалог не переименовали.

lastCustomerMessageAt?|

Последнее входящее сообщение клиента. По нему считается окно 24 часа WhatsApp.

Formatdate-time
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
contact?|

Есть в ответах на запрос диалога, списка и поиска. Нет в ответах на блокировку, переименование и смену статуса.

channelType?string

Есть в ответах на чтение.

customerPhone?|

Телефон клиента из контакта.

curl -X GET 'https://api.1msg.io/api/v1/inbox/conversations/string'
{  "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"}