Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Блок кода
languagejs
themeDJango
firstline1
titleТело запроса в формате Json
linenumberstrue
{
    "messages": [
        {
            "channels": {
                "chat": {
                    "chatId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
                    "botId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
                    "messengerType": "WHATSAPP",
                    "chatSessionName": "Название сессии",
                    "text": "Текст сообщения",

                    "provider": "TWIN"
                }
            },
            "callbackUrl": "http://example.com",
            "callbackData": "123",
            "sendAt": "2023-12-31T12:00:00+00:00",
            "allowedTimeRanges": [
                [
                    "00:00:00",
                    "05:00:00"
                ],
                [
                    "08:00:00",
                    "12:00:00"
                ],
                [
                    "19:30:00",
                    "23:55:00"
                ]
            ],
            "destinations": [
                {
                    "variables": {
                        "name": "Иван",
                        "age": "23"
                    },
                    "phone": "74992868344",
                    "messengerUserId": "74992868344",
                    "externalId": "qwerty12345"
                }
            ]
        }
    ]
} 

Описание полей метода:

Собственный идентификатор для удобства определения чат-сессии/чат-сессий с клиентом

Поле

Тип

Обязательно

Описание

messages

Array[Object]

Да

Массив сообщений для отправки

|    channels

ObjectДаИспользуемые каналы отправки

|    |    chat

ObjectДаОбъект канала "чат" для отправки

|    |    |    chatId

StringДаИдентификатор чата (к которому подключен WhatsApp)

|    |    |    botId

StringДаИдентификатора бота (в котором настроен шаблон для WhatsApp)

|    |    |    messengerType

StringДаТип мессенджера для отправки: Для WhatsApp всегда указываем "WHATSAPP"

|    |    |    chatSessionName

StringНетИмя сессии для удобства ее определения при получении статистики

|    |    |    text

StringДа

Текст сообщения. 

Для WhatsApp указываем любой текст, так как текст будет браться из шаблона

|    |    |    provider

StringДа

Провайдер для отправки сообщения. 

Всегда указываем TWIN

|    callbackUrl

StringНетАдрес для отправки вебхука по статусу отправленного сообщения (только сообщения рассылки, а не все сообщения чат-сессии)

|    callbackData

StringНетДополнительные данные, которые нужно прикладывать к вебхуку

|    sendAt

StringНетДата и время старта рассылки

|    allowedTimeRanges

Array[Array[String]]НетМассив разрешенных периодов времени для отправки (часовой пояс определяет по часовому поясу, где зарегистрирован номер абонента)
|    destinationsArray[Object]ДаМассив "клиентов" для отправки сообщений
|    |    variablesArray[Dictionary]НетМассив дополнительных переменных, которые нужно отправить в чат-сессию
|    |    phoneStringДаНомер телефона клиента
|    |    messengerUserIdStringДа

Идентификатор клиента. 

Для WhatsApp всегда равен номеру телефона

|    |    externalIdStringНет


Блок кода
languagejs
themeDJango
firstline1
titleОтвет в формате JSON
linenumberstrue
[
    {
        "id": "09f0591d-7e62-4311-8d92-d9a287e55118",
        "bulkId": "e27ebd69-046f-42fc-98e0-9df074dbd12d",
        "groupId": "e9319d2a-866f-41a4-bca6-b170a2e4eeb4",
        "flowId": "6e0fef0e-2349-400b-91e5-c636a8925718",
        "status": "DELAYED",
        "channel": "CHAT",
        "error": null
    }
]

Описание полей ответа:

Поле

Тип

Обязательно

Описание


Array[Object]

Да

массив отправленных сообщений

|    id

String

Да

Идентификатор сообщения

|   bulkId

String

Да

Общий идентификатор всех сообщений из рассылки

|   groupId

String

Да

Внутренний идентификатор

|   flowId

String

Да

Внутренний идентификатор

|    status

String

Да

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

|    channel

String

Да

Канал отправки

|    error

Object

Да

Объект ошибки. Равен null, если ошибки нет

|   |   message

String

Нет

Сообщение об ошибке. Отсутствует, если ошибки нет.