chatme.ai
Search
K
Comment on page

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

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

Подключение

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

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

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

Агенту необходимо создать и настроить Канал Агента с коннектором Dialog360
  1. 1.
    Войдите в меню редактирования (Edit) настроек вашего Агента
  2. 2.
    В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
    1. 1.
      выберите тип канала Messaging
    2. 2.
      Нажмите кнопку Add another channel.
      messaging.png
  3. 3.
    Установите коннектор Dialog360 в поле Channel.
  4. 4.
    По необходимости пропишите заголовок для данного канала в поле Title.
    1. 1.
      Заголовки разных каналов агента могут совпадать.
  5. 5.
    После выбора Dialog360 вам станет доступно для записи поле Token, в которое нужно вставить предварительно скопированный API ключ.
  6. 6.
    Активируйте канал переключением тумблера для того, чтобы Агент начал отвечать в нем после сохранения.
    1. 1.
      Если Агент не был обучен, появится предупреждение. В таком случае необходимо обучить Агента, после чего повторить попытку активации Канала Агента.
  7. 7.
    После активации Канала Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы):
    1. 1.
      "Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
      image.png
    2. 2.
      ”Couldn’t register agent webhook” — выводится в случае, если не удалось зарегистрировать вебхук в удаленном канале.
      image.png
  8. 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 символов от Агента до Собеседника
Да
Использование маркдауна
Нет