Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 3 Следующий »

Метод: 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

НетОтсутствует

Фильтр по статусу сообщения. 

Возможные статусы:

  • CREATED 
  • SENT
  • PENDING
  • DELAYED
  • QUEUED
  • SKIPPED
  • DELIVERED
  • UNDELIVERED
  • CANCELED
  • ERROR
  • PAUSED
  • READ

channel

НетОтсутствует

Фильтр по каналу отправки. 

Например, CHAT


Ответ в формате JSON
{
    "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

Статус сообщения

Возможные статусы:

  • CREATED 
  • SENT
  • PENDING
  • DELAYED
  • QUEUED
  • SKIPPED
  • DELIVERED
  • UNDELIVERED
  • CANCELED
  • ERROR
  • PAUSED
  • READ

|    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Имя компании ресселлера


  • Нет меток