Cтарт чат-сессий в Вайбере по API

Подготовка к рассылке

Для того, чтобы рассылать сообщения в вайбер, создайте сценарий бота и интегрируйте его с вайбером.

Когда бот в вайбере создан и привязан к чату, можно переходить к подготовке рассылки.

Рассылка через Twin API

Пример итогового запроса:

curl --request POST 
     --url https://notify.twin24.ai/api/v1/messages \
     --header 'accept: application/json' \
     --header 'authorization: Bearer ваш токен' \
     --header 'content-type: application/json' \
     --data '
{
  "messages": [
    {
      "useShortLinks": false,
      "channels": {
        "chat": {
          "provider": "TWIN",
          "messengerType": "VIBER",
          "chatId": "айди чата, привязанного к боту в вайбер",
          "botId": "айди бота, сценарий которого будет использован в этой сессии"
        }
      },
      "sendAt": "2023-01-24T10:25:07+00:00",
      "destinations": [
        {
          "messengerUserId": "айди клиента в вайбере"
        }
      ]
    }
  ]
}
'

    1)Зайдите в Twin API и найдите метод Create message batch.

    2) В поле Bearer введите свой токен авторизации из личного кабинета.

    3)В пункте messages нажмите ADD OBJECT.

    4)Для определения даты и времени, когда будет отправлено сообщение, нужно ввести дату и время в поле sendAt.

Для отправки сообщения без задержки, можно поставить неактуальную дату, например, как в подсказке выше.

Также можно отправлять сообщения в определённый промежуток времени, для этого нужно в поле allowedTimeRanges нажать кнопку ADD ARRAY OF STRINGS, затем добавить 2 даты в подходящем формате.

    5)В пункте destinations нажмите ADD OBJECT.

    6)В поле messengerUserId записывается айди пользователя в вайбере, который получается в сценарии через переменную {messengerUserId} во время общения с пользователем в чате вайбер.

    7)В поле channels нужно нажать кнопку CHANNELS OBJECT

В открывшемся списке в поле chat нужно нажать на кнопку CHAT OBJECT

    8)Внутри объекта chat, нужно заполнить следующие поля:

• chatId - Айди чата из личного кабинета. К чату должен быть привязан бот, созданный в вайбере, ссылка на инструкцию по его созданию приведена в начале статьи.
• botId - Айди сценария бота из личного кабинета, с которым будет начата сессия, сценарий должен быть из того же личного кабинета, через токен которого вы авторизовались.
• messengerType - VIBER
• provider - TWIN

Если после нажатия кнопки Try It! вы увидели код 201, значит всё прошло успешно и у клиента должна начаться чат сессия в вайбер с выбранным сценарием.