Вывод Агента в WhatsApp (360dialog)

В этой статье описан вывод Агента в WhatsApp через 360dialog и возможности общения в этом канале.

360dialog — официальный провайдер WhatsApp Business. Используя коннектор Dialog360 можно подключить бота в WhatsApp Business Account (WABA). Подробнее о правилах WhatsApp можно узнать в документации 360dialog.

Подключение

Конфигурация на стороне 360dialog

В первую очередь нужно произвести конфигурацию на стороне 360dialog.

1. Зайдите в аккаунт 360dialog. На главной странице будет выведен список зарегистрированных бизнес-аккаунтов WhatsApp (подробнее о том, как зарегистрировать WhatsApp Business Account).
2. Выберите бизнес-аккаунт, к которому необходимо подключить Агента.

3. Получите токен доступа по инструкции.

4. Скопируйте токен доступа.

Конфигурация канала Агента в Платформе

Агенту необходимо создать и настроить Канал Агента с коннектором Dialog360

1. Войдите в меню редактирования (Edit) настроек вашего Агента
2. В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:

   1. выберите тип канала Messaging

   2. Нажмите кнопку Add another channel.
3. Установите коннектор Dialog360 в поле Channel.
4. По необходимости пропишите заголовок для данного канала в поле Title.

   1. Заголовки разных каналов агента могут совпадать.

5. После выбора Dialog360 вам станет доступно для записи поле Token, в которое нужно вставить предварительно скопированный API ключ.
6. Активируйте канал переключением тумблера для того, чтобы Агент начал отвечать в нем после сохранения.

   1. Если Агент не был обучен, появится предупреждение. В таком случае необходимо обучить Агента, после чего повторить попытку активации Канала Агента.
7. После активации Канала Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы):

   1. "Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
   2. ”Couldn’t register agent webhook” — выводится в случае, если не удалось зарегистрировать вебхук в удаленном канале.
8. Сохраните Канал Агента — нажмите Save.

Все настройки будут применены только после сохранения.

Общение

Маппинг Канальных переменных из канала 360dialog

Канальная переменная	Переменная в теле входящего запроса из канала
channel_conversation_id	response["messages"][0]["from"]
channel_visitor_id	response["messages"][0]["from"]
channel_visitor_firstname	response["contacts"][0]["profile"]["name"]
channel_visitor_lastname	response["contacts"][0]["profile"]["name"]
channel_visitor_phone	response["messages"][0]["from"]
channel_visitor_email	—
channel_visitor_account	response["messages"][0]["from"]
channel_visitor_auth	—
channel_visitor_source	—

Возможности общения в канале WhatsApp

Функционал	Наличие в канале	Описание
Переменная channel_chat_id	Да	Формат: номер телефона собеседника начиная с телефонного кода страны без знака +|dialog360
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате	Частично	Агент может стартовать диалог с помощью отправки согласованного шаблона рассылки. Однако в 360dialog диалог длится 24 часа, по истечении этого времени отправленное Агентом в уже существующий чат через Incoming Request сообщение не дойдет до Собеседника
Кнопки	Частично	Если в кнопочном меню не более 3х кнопок, то они будут отправлены как кнопки; Если в кнопочном меню более 3х кнопок, то они будут отправлены как нумерованный список.
Перевод на оператора	Нет	В 360dialog нет операторского софта
Передача файлов в виде файлов от Агента (слот Attachment)	Частично	Изображения не передаются, видео передаются, аудио передаются в виде аудиофайлов, файлы передаются в виде файлов для скачивания
Передача файлов в виде ссылок от Агента (слот Attachment)	Да	Происходит попытка отправки картинки\файла спец.методом, если формат файла по ссылке не подходит, канал ответит техническим сообщением об ошибке и тогда Агент повторит отправку сообщения но уже отправит ссылку на файл\картинку простым текстом.
Получение файла от Собеседника в сценарий	Да	Формат: file:document|id передаваемого файла|https://waba.360dialog.io/v1/media/id передаваемого файла Пример: file:document|7b825480-9148-44a7-9454-b60d7f433e14|https://waba.360dialog.io/v1/media/7b825480-9148-44a7-9454-b60d7f433e14
Получение геолокации от собеседника в сценарии	Нет	В WhatsApp нет функции отправки геолокации
Доставка сообщений более 1000 символов от Агента до Собеседника	Да
Использование маркдауна	Нет