Вывод Агента в WhatsApp (360dialog)
В этой статье описан вывод Агента в WhatsApp через 360dialog и возможности общения в этом канале.
360dialog — официальный провайдер WhatsApp Business. Используя коннектор Dialog360 можно подключить бота в WhatsApp Business Account (WABA). Подробнее о правилах WhatsApp можно узнать в документации 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.
Все настройки будут применены только после сохранения.
Канальная переменная | Переменная в теле входящего запроса из канала |
---|---|
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 сообщение не дойдет до Собеседника |
Кнопки | Частично |
|
Перевод на оператора | Нет | В 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 символов от Агента до Собеседника | Да | |
Использование маркдауна | Нет | |