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 введите свой токен авторизации из личного кабинета.
   
   
   Как получить токен авторизации

   Чтобы получить авторизационный токен, откройте вкладку Помощь – API и скопируйте оттуда ваш токен.

   

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

   Формат даты и времени

   2023-01-24T10:25:07+00:00

   Для отправки сообщения без задержки, можно оставить поле пустым.
   
   Также можно отправлять сообщения в определённый промежуток времени, для этого нужно в поле 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, значит всё прошло успешно и у клиента должна начаться чат сессия в вайбер с выбранным сценарием.