| Предупреждение | ||
|---|---|---|
| ||
Рассылка сообщений в вайбер через номер телефона невозможна, вместо номера телефона используется айди клиента, полученный в вайбере при помощи переменной {messengerUserId} внутри сценария. |
Подготовка к рассылке
Для того, чтобы рассылать сообщения в вайбер, нужно создать бота в вайбере, о том, как его создать, можно почитать в этой статье.Затем нужно привязать бота к чату, что описано в этой статье создайте сценарий бота и интегрируйте его с вайбером.
Когда бот в вайбере создан и привязан к чату, можно начинать рассылкупереходить к подготовке рассылки.
...
Рассылка через 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": "20182023-0801-24T10:25:07+00:00", "destinations": [ { "messengerUserId": "<айдиайди клиента в вайбере>вайбере" } ] } ] } ' |
...
- Зайдите в Twin API и найдите метод Create message batch.
...
- В поле Bearer введите свой токен авторизации из личного кабинета.
...
Раскрыть title
...
Как получить токен авторизации Чтобы получить авторизационный токен, откройте
...
вкладку Помощь – API и скопируйте оттуда ваш токен.
...
...
- Для добавления необходимых для отправления сообщения параметро, в пункте messages
...
- нажмите ADD OBJECT.
...
- Для определения даты и времени, когда будет отправлено сообщение, нужно ввести дату и время в поле sendAt.
Подсказка title Формат даты и времени
...
2023-
...
Для отправки сообщения без задержки, можно01-24T10:25:07+00:00
...
- оставить поле пустым.
...
- Также можно отправлять сообщения в определённый промежуток времени, для этого нужно в
...
- поле allowedTimeRanges нажать кнопку ADD ARRAY OF STRINGS, затем добавить 2 даты в подходящем формате.
...
- Для определения адресата сообщения, в пункте destinations нажмите ADD OBJECT.
...
- В поле messengerUserId записывается айди пользователя в вайбере, который получается в сценарии через переменную {messengerUserId} во время общения с пользователем в чате
...
- вайбер.
Вы можете сохранять айди клиентов в отчёт, чтобы затем использовать их для старта сессии, подробнее о сохранении информации в отчёт можно узнать в этой статье.
...
- В поле channels нужно нажать кнопку CHANNELS OBJECT.
В открывшемся списке в поле chat нужно нажать на кнопку CHAT OBJECT.
...
- Внутри объекта chat, нужно заполнить следующие поля:
...
- chatId
...
- - Айди чата из личного кабинета. К чату должен быть привязан бот, созданный в вайбере, ссылка на инструкцию по его созданию приведена в начале статьи.
- botId
...
- - Айди сценария бота из личного кабинета, с которым будет начата сессия,
...
- сценарий должен быть из того же личного кабинета, через токен которого вы авторизовались.
- messengerType
...
- - VIBER
- provider
...
- - TWIN
Если после нажатия кнопки Try It! вы увидели код 201, значит всё прошло успешно и у клиента должна начаться чат сессия в вайбер с выбранным сценарием.
| Примечание |
|---|
Если после нажатия кнопки Try It! вместо кода 201 появляется код 400, либо 500, значит произошла ошибка и стоит перепроверить введённые значения. |
...