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

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

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

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

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

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



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

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

НомерНазвание поляОписание поля
1Добавить действиеНажмите кнопку Добавить действие и выберите действие Прикрепить шаблон WhatsApp.
2ID шаблонаВведите пространство имен, которое вы получили от технической поддержки.
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

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

    Тип авторизации - Заголовок
    Тип авторизации - Bearer
    Значение ключа - {token}
    Тип запроса - POST
    URL - https://notify.twin24.ai/api/v1/messages 

    Тело запроса:
    Поле ЗначениеОписание
    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.sendAt2018-10-31T11:56:07+00:00Дата отправки. Для мгновенной отправки можно использовать любую уже прошедшую дату.
    messages.0.destinations.0.phone {destination}Номер телефона клиента.

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