Рассылка сообщений в вайбер через номер телефона невозможна, вместо номера телефона используется айди клиента, полученный в вайбере при помощи переменной {messengerUserId} внутри сценария. |
Для того, чтобы рассылать сообщения в вайбер, создайте сценарий бота и интегрируйте его с вайбером.
Когда бот в вайбере создан и привязан к чату, можно переходить к подготовке рассылки.
Пример итогового запроса:
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": "2018-08-24T10:25:07+00:00", "destinations": [ { "messengerUserId": "айди клиента в вайбере" } ] } ] } ' |
1)Зайдите в Twin API и найдите метод Create message batch.
2) В поле Bearer введите свой токен авторизации из личного кабинета.
Чтобы получить авторизационный токен, откройте вкладку Помощь – API и скопируйте оттуда ваш токен. |
3)В пункте messages нажмите ADD OBJECT.
4)Для определения даты и времени, когда будет отправлено сообщение, нужно ввести дату и время в поле sendAt.
2018-08-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, значит всё прошло успешно и у клиента должна начаться чат сессия в вайбер с выбранным сценарием.
Если после нажатия кнопки Try It! вместо кода 201 появляется код 400, либо 500, значит произошла ошибка и стоит перепроверить введённые значения. |