Как отправлять сообщения в WhatsApp по ходу диалога

Подготовка к отправке сообщений

Перед настройкой сценария для отправки сообщения в whatsapp, вам нужно выполнить эти 2 шага:

1. Зарегистрировать аккаунт WhatsApp Business и привязать его к чату. 
   

   О том, как завести аккаунт Whatsapp Business, можно узнать в этой статье.

2. Получить название и пространство имён шаблона Whatsapp.
   

   Для получения пространства имен и шаблона WhatsApp обратитесь в сервис технической поддержки с просьбой создать шаблон WhatsApp.

   Все необходимые данные вам сообщат.

Подготовка сценария к рассылке сообщений

Первым делом нужно подготовить сценарий, который привязан к чату. Этот сценарий будет стартовать чат-сессию при рассылке уведомлений.
В нём указываются шаблон WhatsApp и пространство имён, полученное в техподдержке.

1. Добавить действие - Нажмите кнопку Добавить действие и выберите действие Прикрепить шаблон WhatsApp.
2. ID шаблона - Введите пространство имен шаблонов, которое вы получили от технической поддержки.
3. Название шаблона - Введите название шаблона, которое вы получили от технической поддержки.
4. Сообщение на кнопку - Введите любой текст. Он не будет отображаться клиенту, но обязателен к заполнению.
5. Тип кнопок - Выберите тип кнопки. Если в шаблоне кнопки не используются, то выберите вариант Быстрый ответ.
   

   Подробнее о типах кнопок вы можете узнать в этой статье.

Данный сценарий можно сохранить и закрыть, либо дополнить, например, переводом на другой сценарий на ваше усмотрение.

Также стоит скопировать айди этого сценария, так как он будет использоваться далее в запросе к серверу.

Отправка сообщения по ходу диалога

На этом этапе будет происходить отправка сообщений внутри сценария при помощи запроса к Twin API.

В сценарии, из которого нужно отправлять сообщения, первым делом стоит авторизоваться в системе, используя метод авторизации в блоке Запрос к серверу.

1. В блоке Результат задаются переменные, содержащие данные для входа в личный кабинет, а также номер телефона собеседника, которому отправится сообщение в Whatsapp.
   
   

   email - Электронная почта для входа в личный кабинет.

   password - Пароль для входа в личный кабинет.

   destination - Номер телефона собеседника. В звонке можно использовать переменную {системные.телефон}.
   
   

2. В блоке Запрос к серверу нужно заполнить поля для метода авторизации в системе.
    
   Тип авторизации - Отсутствует
   Тип запроса - POST
   URL - https://iam.twin24.ai/api/v1/auth/login
   Тело запроса:
   email - {email}
   password - {password}
   
   
3. В стрелке от блока Запрос к серверу нужно выставить следующие значения:
   
   
   • Тип - Результат
   • Успешность запроса - Успешно
   • Присвоить переменные при выборе ветки - token = result.token
   
   Тип - Результат
   Успешность запроса - Успешно
   Присвоить переменные при выборе ветки - token = result.token
   
   
4. В следующем блоке Запрос к серверу осуществляется отправка сообщения в 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.destinations.0.phone	{destination}	Номер телефона клиента.

   
   После прохождения этого блока, по номеру телефона клиенту будет отправлено сообщение, содержащееся в шаблоне WhatsApp, указанном в сценарии из начала статьи.