История страницы

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

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

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

Шаг 1: подготовка рассылки в Twin 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.
   Image Modified
   

...

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

...

1. Раскрыть
   title

...

1. Как получить токен авторизации

   Чтобы получить авторизационный токен, откройте вкладку

...

1. Помощь

...

1. –

...

1. API

...

1. и скопируйте оттуда ваш токен.

Image Removed

...

1. Image Added

2.    Для добавления необходимых для отправления сообщения параметро, в пункте messages нажмите ADD OBJECT.
   Image Modified
   

...

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

   Подсказка
   title Формат даты и времени

...

1. 2023-

...

1. 01-

...

1. 24T10:25:07+00:00

   Для отправки сообщения без задержки,

...

1. можно оставить поле пустым.
   
   Image AddedТакже можно отправлять сообщения в определённый промежуток времени, для этого нужно в поле allowedTimeRanges нажать кнопку ADD ARRAY OF STRINGS, затем добавить 2 даты в подходящем формате.
   
   
2. Для определения адресата сообщения, в пункте destinations нажмите ADD OBJECT.
   Image Added
   
3. В поле messengerUserId записывается айди пользователя в вайбере, который получается в сценарии через переменную {messengerUserId} во время общения с пользователем в чате вайбер.
   Image Added
   
4. В поле channels нужно нажать кнопку CHANNELS OBJECT.
   Image Added
   В открывшемся списке в поле chat нужно нажать на кнопку CHAT OBJECT.
   Image Added
   
5. Внутри объекта chat, нужно заполнить следующие поля:
   Image Added
   

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

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

...