-
Создана пользователем
Максим Хмелевцев. Последнее обновление: 14 авг., 2023
Время чтения: 3 мин.
Подготовка к отправке сообщений
Перед тем, как начать делать сценарий для отправки сообщения в whatsapp, вам нужно выполнить эти 2 шага:
- Зарегистрировать аккаунт Whatsapp Business и привязать его к чату.
О том, как завести аккаунт Whatsapp Business, можно узнать в этой статье.
- Получить название и пространство имён шаблона Whatsapp.
Для получения пространства имен и шаблона WhatsApp обратитесь в сервис технической поддержки с просьбой создать шаблон WhatsApp, все необходимые данные вам сообщат.
Подготовка сценария к рассылке сообщений
Первым делом нужно подготовить сценарий, который привязан к чату, им будет начинаться чат-сессия при рассылке уведомлений. В нём указываются шаблон WhatsApp и пространство имён, полученное в техподдержке.
| Номер | Название поля | Описание поля |
|---|---|---|
| 1 | Добавить действие | Нажмите кнопку Добавить действие и выберите действие Прикрепить шаблон WhatsApp. |
| 2 | ID шаблона | Введите пространство имен, которое вы получили от технической поддержки. |
| 3 | Название шаблона | Введите название шаблона, которое вы получили от технической поддержки. |
| 4 | Сообщение на кнопку | Введите любой текст. Он не будет отображаться клиенту, но обязателен к заполнению. |
| 5 | Тип кнопки | Выберите тип кнопки. Если в шаблоне кнопки не используются, то выберите вариант Быстрый ответ. Подробнее о типах кнопок вы можете узнать в этой статье. |
Данный сценарий можно сохранить и закрыть, либо дополнить, например, переводом на другой сценарий на ваше усмотрение.
Также стоит скопировать айди этого сценария для того, чтобы использовать его далее в запросе к серверу.
Отправка сообщения по ходу диалога
На этом этапе будет происходить отправка сообщений внутри сценария при помощи запроса к Twin API.
В сценарии, из которого нужно отправлять сообщения, первым делом стоит авторизоваться в системе, используя метод авторизации в блоке "Запрос к серверу".
- В блоке "Результат" задаются переменные, содержащие данные для входа в личный кабинет, а также номер телефона собеседника, которому отправится сообщение в Whatsapp.
email - Электронная почта для входа в личный кабинет.
password - Пароль для входа в личный кабинет.
destination - Номер телефона собеседника
- В блоке "Запрос к серверу" нужно заполнить поля для метода авторизации в системе.
Тип авторизации - Отсутствует
Метод - POST
URL - https://iam.twin24.ai/api/v1/auth/login
Тело запроса:
email - {email}
password - {password} - В стрелке от блока "Запрос к серверу" нужно выставить следующие значения:
Тип - Результат
Успешность запроса - Успешно
Присвоить переменные при выборе ветки - token = result.token - В следующем блоке "Запрос к серверу" осуществляется отправка сообщения в Whatsapp.
Тип авторизации - Заголовок
Тип авторизации - Bearer
Значение ключа - {token}
Тип запроса - POST
URL - https://notify.twin24.ai/api/v1/messages
Тело запроса:Тело запроса Поле Значение Описание messages.0.channels.chat.messengerType WHATSAPP Мессенджер, в который будет отправлено сообщение. messages.0.channels.chat.provider TWIN Провайдер сервиса для рассылок. messages.0.channels.chat.chatId Айди чата Айди чата, привязанный к WhatsApp Business. messages.0.channels.chat.botId Айди бота Айди сценария, который привязан к чату и в котором хранится пространство имён шаблонов и название шаблона WhatsApp. messages.0.sendAt 2018-10-31T11:56:07+00:00 Дата отправки. Для мгновенной отправки можно использовать любую уже прошедшую дату. messages.0.destinations.0.phone {destination} Номер телефона клиента.