| Message Box | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
Подготовка к отправке сообщений
Перед тем, как начать делать сценарий настройкой сценария для отправки сообщения в whatsappWhatsApp, вам нужно выполнить эти 2 шага:
- Зарегистрировать аккаунт Whatsapp WhatsApp Business и привязать его к чату.
Подсказка О том, как завести аккаунт Whatsapp Business, можно узнать в этой статье.
- Получить название и пространство имён шаблона WhatsappWhatsApp.
Подсказка Для получения пространства имен и шаблона WhatsApp обратитесь в сервис технической поддержки с просьбой создать шаблон WhatsApp, все .
Все необходимые данные вам сообщат.
Подготовка сценария к рассылке сообщений
Первым делом нужно подготовить сценарий, который привязан к чату, им будет начинаться . Этот сценарий будет начинать чат-сессия сессию при рассылке уведомлений.
В нём после стартового блока создаётся блок информации или вопроса, в котором указываются шаблон WhatsApp и пространство имён, полученное полученные в техподдержке.
...
| Предупреждение |
|---|
В этом блоке обязательно должен содержаться любой текст. Он не будет отображаться клиенту. Этот блок обязательно должен располагаться сразу после стартового блока, иначе бот может работать неправильно. |
...
- Добавить действие -
- Нажмите кнопку Добавить действие и выберите действие Прикрепить шаблон WhatsApp.
...
- ID шаблона
...
- - Введите пространство имен шаблонов, которое вы получили от технической поддержки.
...
- Название шаблона
...
- - Введите название шаблона, которое вы получили от технической поддержки.
...
- Сообщение на кнопку
...
- - Введите любой текст. Он не будет отображаться клиенту, но обязателен к заполнению.
...
- Тип
...
- кнопок - Выберите тип кнопки. Если в шаблоне кнопки не используются, то выберите вариант Быстрый ответ.
Подсказка Подробнее о типах кнопок вы можете узнать в этой статье.
Данный сценарий можно сохранить и закрыть, либо дополнить, например, переводом на другой сценарий на ваше усмотрение.
Также стоит скопировать Далее, в последнем шаге этой инструкции, айди этого сценария для того, чтобы использовать его далее в запросе к серверубудет использоваться в блоке Запрос к серверу в шаге №4.
Отправка сообщения по ходу диалога
На этом этапе будет происходить отправка сообщений внутри сценария сценария при помощи запроса к к Twin API.
В сценарии, из которого нужно отправлять сообщения, первым делом стоит авторизоваться в системе, используя метод авторизации в блоке "блоке Запрос к серверу".
- В блоке "блоке Результат" задаются переменные, содержащие данные для входа в личный кабинет, а также номер телефона собеседника, которому отправится сообщение в WhatsappWhatsApp.
Fancy Bullets email - Электронная почта для входа в личный кабинет.
password - Пароль для входа в личный кабинет.
destination - Номер телефона собеседника. Используйте системную переменную {системные.телефон}.
- В блоке "Запрос к серверу" нужно нужно заполнить поля для метода авторизации в системе.
-Fancy Bullets - Тип авторизации
Метод -- – Отсутствует
-- Тип запроса – POST
- URL
-- – https://iam.twin24.ai/api/v1/auth/login
- Тип содержимого – JSON
- Тело запроса:
-- – {email}
- password
- – {password}
- В стрелке от блока "блока Запрос к серверу" нужно нужно выставить следующие значения:
-Fancy Bullets - Тип
запроса -- – Результат
- Успешность
-- запроса – Успешно
- Присвоить переменные при выборе ветки
- – token = result.token
- В следующем блоке "Запрос к серверу" осуществляется отправка сообщения в WhatsappWhatsApp.
- Тип авторизации
...
- – Заголовок
- Тип авторизации
...
- – Bearer
- Значение
...
- ключа – {token}
- Тип запроса
...
- – POST
- URL
...
- – https://notify.twin24.ai/api/v1/messages
Тело запроса:
| Поле | Значение | Описание |
|---|---|---|
| messages.0.channels.chat.messengerType | Мессенджер, в который будет отправлено сообщение. | |
| messages.0.channels.chat.provider | TWIN | Провайдер сервиса для рассылок. |
| messages.0.channels.chat.chatId | Айди чата | Айди чата, привязанный к WhatsApp Business. |
| messages.0.channels.chat.botId | Айди бота | Айди сценария, который привязан к чату и в котором хранится пространство имён шаблонов и название шаблона WhatsApp. |
| messages.0 |
...
| . |
...
| destinations.0.phone |
...
| {destination} | Номер телефона клиента. |
После прохождения этого блока, по номеру телефона клиенту будет отправлено сообщение, содержащееся в шаблоне WhatsApp, указанном в сценарии из начала статьи.