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

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

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

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

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

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

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

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

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

В этом блоке обязательно должен содержаться любой текст. Он не будет отображаться клиенту.

Этот блок обязательно должен располагаться сразу после стартового блока, иначе бот может работать неправильно.


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

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

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

Далее, в последнем шаге этой инструкции, айди этого сценария будет использоваться в блоке Запрос к серверу в шаге №4.

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

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

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

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

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

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

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



  2. В блоке Запрос к серверу нужно заполнить поля для метода авторизации в системе.
     
    • Тип авторизации – Отсутствует
    • Тип запроса – POST
    • URL – https://iam.twin24.ai/api/v1/auth/login
    • Тип содержимого – JSON
    • Тело запроса:
    • email – {email}
    • password – {password}


  3. В стрелке от блока Запрос к серверу нужно выставить следующие значения:

    • Тип – Результат
    • Успешность запроса – Успешно
    • Присвоить переменные при выборе ветки – token = result.token


  4. В следующем блоке Запрос к серверу осуществляется отправка сообщения в WhatsApp.

Поле ЗначениеОписание
messages.0.channels.chat.messengerTypeWHATSAPPМессенджер, в который будет отправлено сообщение.
messages.0.channels.chat.providerTWINПровайдер сервиса для рассылок.
messages.0.channels.chat.chatIdАйди чатаАйди чата, привязанный к WhatsApp Business.
messages.0.channels.chat.botIdАйди ботаАйди сценария, который привязан к чату и в котором хранится пространство имён шаблонов и название шаблона WhatsApp.
messages.0.destinations.0.phone{destination}Номер телефона клиента.


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