Вывод Агента в 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 символов от Агента до Собеседника
Да
​
Использование маркдауна
Нет
​

Канальная переменная	Переменная в теле входящего запроса из канала
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	—

Функционал	Наличие в канале	Описание
Переменная 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 символов от Агента до Собеседника	Да
Использование маркдауна	Нет

Размещение агента в каналах - Previous

Вывод Агента в Telegram

Подключение аккаунта WhatsApp Business через 360dialog

Last modified 1mo ago