Метод: POST
Authorization: Bearer Token (Метод для получения токена по логину и паролю)
URL: https://analyse.twin24.ai/api/v1/search/messaging/messages
| Блок кода | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
https://analyse.twin24.ai/api/v1/search/messaging/messages?limit=1000&page=0&from=2023-10-31T00%3A00%3A00%2B00%3A00&to=2023-11-01T00%3A00%3A00%2B00%3A00&sort=+createdAt&companyId=1&keyword=74992868344&bulkId=e27ebd69-046f-42fc-98e0-9df074dbd12d&groupId=e9319d2a-866f-41a4-bca6-b170a2e4eeb4&flowId=6e0fef0e-2349-400b-91e5-c636a8925718&status=READ&channel=CHAT |
Описание параметров метода:
Параметр | Обязательно | Значение по умолчанию | Описание |
|---|---|---|---|
limit | Нет | 10 | Количество элементов в ответе (максимум 1000) |
page | Нет | 0 | Номер "страницы" с элементами (начиная с 0). Например, если в limit указано 1000, а всего элементов 1500, то первая 1000 будет в ответе при page = 0, а остальные 500 при page =1 |
from | Да | Отсутствует | Дата начала промежутка поиска. Задается в формате: 2023-10-31T00:00:00+00:00 ГГГГ-ММ-ДДTчч:мм:сс+чч:мм Обязательно url-encoded |
to | Да | Отсутствует | Дата окончания промежутка поиска. Задается в формате: 2023-10-31T00:00:00+00:00 ГГГГ-ММ-ДДTчч:мм:сс+чч:мм Обязательно url-encoded |
sort | Нет | +createdAt | Способ сортировки. Задается в формате: +(по возрастанию)/-(по убыванию)название поля сортировки (см пример в значении по умолчанию) Возможные поля для сортировки: createdAt, sentAt, deliveredAt, sendAt, expiredAt, billedAt |
companyId | Нет | Отсутствует | Фильтр по идентификатору компании |
keyword | Нет | Отсутствует | Фильтр по значению в любом из полей: message body, messageId, bulkId, groupId, flowId, taskId, templateId, status, statusCode, channel, destination, from, text, network, mccMnc, templateName |
bulkId | Нет | Отсутствует | Фильтр по bulkId |
groupId | Нет | Отсутствует | Фильтр по groupId |
flowId | Нет | Отсутствует | Фильтр по flowId |
status | Нет | Отсутствует | Фильтр по статусу сообщения. Возможные статусы:
|
channel | Нет | Отсутствует | Фильтр по каналу отправки. Например, CHAT |
| Блок кода | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"count": 2,
"items": [
{
"id": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"bulkId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"groupId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"flowId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"taskId": null,
"status": "READ",
"statusRu": "Сообщение прочитано.",
"statusEn": null,
"statusCode": 11,
"companyId": 1,
"companyName": "Компания",
"channel": "CHAT",
"destination": "74992868344",
"from": null,
"text": null,
"price": "0.000000",
"network": null,
"mccMnc": null,
"templateId": null,
"templateName": null,
"variables": "null",
"partCount": 1,
"tracks": [],
"read": null,
"createdAt": "2023-10-31T04:00:33.135139Z",
"sentAt": "2023-10-31T04:01:55.587763Z",
"deliveredAt": "2023-10-31T04:02:02.873465Z",
"sendAt": "2023-10-31T04:00:33.135139Z",
"expiredAt": null,
"billedAt": "2023-10-31T04:02:02.876837Z",
"providerMessageId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"resellerPrice": "0.000000",
"resellerCompanyId": 1,
"resellerCompanyName": "1 | Компания"
},
{
"id": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"bulkId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"groupId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"flowId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"taskId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"status": "READ",
"statusRu": "Сообщение прочитано.",
"statusEn": null,
"statusCode": 11,
"companyId": 1,
"companyName": "Компания",
"channel": "CHAT",
"destination": "74992868344",
"from": null,
"text": null,
"price": "0.000000",
"network": null,
"mccMnc": null,
"templateId": null,
"templateName": null,
"variables": "{\"phoneNo\": 74992868344, \"fullName\": \"Иванов Иван Иванович\"}",
"partCount": 1,
"tracks": [],
"read": null,
"createdAt": "2023-10-31T06:49:45.337901Z",
"sentAt": "2023-10-31T06:49:49.642247Z",
"deliveredAt": "2023-10-31T06:49:55.432778Z",
"sendAt": "2023-10-31T06:49:45.337901Z",
"expiredAt": null,
"billedAt": "2023-10-31T06:49:55.439442Z",
"providerMessageId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
"resellerPrice": "0.000000",
"resellerCompanyId": 1,
"resellerCompanyName": "1 | Компания"
}
]
} |
Описание полей ответа:
Поле | Тип | Описание |
|---|---|---|
count | Int | Общее количество найденных элементов |
items | Array[Object] | Массив найденных элементов |
| id | String | Идентификатор сообщения |
| bulkId | String | Идентификатор рассылки |
| groupId | String | Внутренний идентификатора |
| flowId | String | Внутренний идентификатора |
| taskId | String | Идентификатор задания на отправку (при отправке из личного кабинета) |
| status | String | Статус сообщения Возможные статусы:
|
| statusRu | String | Статус сообщения в человеко читаемом формате на русском языке |
| statusEn | String | Статус сообщения в человеко читаемом формате на английском языке |
| statusCode | Int | Код статуса |
| companyId | Int | Идентификатор компании, отправившей сообщение |
| companyName | String | Имя компании, отправившей сообщение |
| channel | String | Канал отправки сообщения |
| destination | String | Идентификатор клиента в мессенджере. Для WhatsApp - номер телефона |
| from | String | Отправитель сообщения. Не актуально для канала CHAT |
| text | String | Текст сообщения |
| price | String | Цена за сообщение |
| network | String | Не актуально для канала CHAT |
| mccMnc | String | Не актуально для канала CHAT |
| templateId | String | Идентификатор шаблона для отправки |
| templateName | String | Имя шаблона для отправки |
| variables | String | Список переменных, приложенных к отправке |
| partCount | Int | Не актуально для канала CHAT |
| tracks | Array | Не актуально для канала CHAT |
| read | String | Не актуально для канала CHAT |
| createdAt | String | Дата создания сообщения |
| sentAt | String | Дата отправки сообщения |
| deliveredAt | String | Дата доставки сообщения |
| sendAt | String | Дата попадания сообщения в очередь отправки |
| expiredAt | String | Дата истечения срока доставки сообщения |
| billedAt | String | Дата билинга за сообщение |
| providerMessageId | String | Идентификатор сообщения у провайдера |
| resellerPrice | String | Стоимость сообщения у ресселлера |
| resellerCompanyId | Int | Идентификатор компании ресселлера |
| resellerCompanyName | String | Имя компании ресселлера |