chatme.ai
Search…
Создание Агента на платформе
ДЛЯ РАЗРАБОТЧИКОВ
Вывод Агента в WhatsApp (360dialog)
В этой статье описан вывод Агента в WhatsApp через 360dialog и возможности общения в этом канале.
360dialog — официальный провайдер WhatsApp Business. Используя коннектор Dialog360 можно подключить бота в WhatsApp Business Account (WABA). Подробнее о правилах WhatsApp можно узнать в документации 360dialog.

Подключение

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

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

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

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