Предупреждение | ||
---|---|---|
| ||
Рассылка сообщений в вайбер через номер телефона невозможна, вместо номера телефона используется айди клиента, полученный в вайбере при помощи переменной {messengerUserId} внутри сценария. |
Подготовка к рассылке
Для того, чтобы рассылать сообщения в вайбер, нужно создать бота в вайбере, о том, как его создать, можно почитать в этой статье.Затем нужно привязать бота к чату, что описано в этой статье создайте сценарий бота и интегрируйте его с вайбером.
Когда бот в вайбере создан и привязан к чату, можно начинать следующие шаги.
Шаг 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": "айди клиента в вайбере"
}
]
}
]
}
' |
...
- Зайдите в 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, значит произошла ошибка и стоит перепроверить введённые значения. |