Вывод Агента в мессенджеры

icon picker
WhatsApp (Edna Platform)

Edna — официальный провайдер WhatsApp Business. Используя коннектор “Edna Platform” можно создать
@Бот
а в WhatsApp Business Account (WABA).

Подключение

1. Конфигурация бота на стороне Edna

В первую очередь нужно произвести конфигурацию на стороне Edna.
Авторизуйтесь в . Аккаунт создается через техподдержку Edna.
Перейдите в раздел Настройки → Каналы. ​
image.png
В разделе должен быть как минимум один существующий канал. В ином случае обратитесь в техподдержку Edna для его создания. ​
image.png
Перейдите в раздел Каскады. Нажмите на кнопку Добавить каскад +. ​
image.png
Пропишите название каскада. ​
image.png
В разделе Создание каскада в поле Сообщение в канале выберите канал. На данный момент для интеграции доступны только каналы WhatsApp, т.е. доступны для создания только каскады с одним пунктом. ​
image.png
Сохраните каскад, нажав кнопку Сохранить. ​
image.png
Подтвердите действие во всплывающем окне.
image.png
После сохранения каскада появится его ID в поле ID каскада. Он понадобится позже при . ​
image.png
Перейдите в раздел Интеграция → Тестирования. ​
image.png
Скопируйте значение из поля Ваш API-ключ. Он понадобится позже при .

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

@Агент
у необходимо создать и настроить
@Канал Агента
с
@Коннектор
ом “Edna Platform”.
Войдите в меню редактирования (Edit) настроек вашего
@Агент
а.
image.png
В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
выберите тип канала Messaging.
Нажмите кнопку Add another channel ​
image.png
Выберите в поле Channel
@Коннектор
“Edna Platform”. ​
image.png
По необходимости пропишите заголовок для данного
@Канал Агента
в поле Title. ​
image.png
В поле Token раздела Channel webhook вставьте следующее значение: |. ​
image.png
Активируйте канал переключением тумблера для того, чтобы
@Агент
начал отвечать в нем.
image.png
Если
@Агент
не был обучен, появится предупреждение. В таком случае необходимо обучить
@Агент
а, после чего повторить попытку активации
@Канал Агента
.
image.png
После активации
@Канал Агента
, если есть проблемы с его доступностью, будет выведено предупреждение (
@Канал Агента
будет активирован несмотря на проблемы):
"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
image.png
Couldn’t register agent webhook” — выводится в случае, если не удалось зарегистрировать вебхук в удаленном канале.
image.png
Сохраните
@Канал Агента
— нажмите Save.
Важно: Все настройки будут применены только после сохранения.

Общение

Шаблоны рассылок

Шаблоны — это сообщения, с помощью которых
@Бот
в WhatsApp стартует
@Чат
с
@Собеседник
ом. Чтобы произвести рассылку по
@Собеседник
ам в WhatsApp, необходимо создать шаблон, отправить на согласование, в случае неуспеха переформулировать и отправить новый шаблон, а в случае согласования инициировать рассылку с помощью
@Слот
а
@Notification
.
Важно: стартовать
@Диалог
с
@Собеседник
ом возможно только через отправку шаблона рассылки через
@Слот
@Notification
. Подробнее: .
Маппинг Канальных переменных из канала Edna Platform
Канальная переменная
Конечный канал
Переменная в теле входящего запроса из канала
1
channel_visitor_id
Edna Pulse
subscriber.identifier
2
channel_conversation_id
Edna Pulse
subscriber.identifier
3
channel_visitor_firstname
Edna Pulse
userInfo.firstName
4
channel_visitor_lastname
Edna Pulse
userInfo.lastName
5
channel_visitor_account
Edna Pulse
userInfo.userName
6
channel_visitor_phone
Edna Pulse
subscriber.identifier
После отправки рассылки
@Слот
ом
@Notification
в эту переменную попадает номер телефона, на который была отправлена рассылка
7
channel_visitor_email
Edna Pulse
Нет
8
channel_visitor_source
Edna Pulse
Нет
9
channel_visitor_auth
Edna Pulse
Нет
10
channel_visitor_location
Edna Pulse
Нет
11
channel_message_id
Edna Pulse
Нет
12
channel_message_recipient
Edna Pulse
Нет
13
channel_reply_to
Edna Pulse
нет
There are no rows in this table

Возможности общения в канале Edna Platform
Функционал
Конечный канал
Наличие в канале
Описание
1
channel_chat_id
Edna Pulse
Да
Формат: channel_visitor_id|edna platform
2
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате
Edna Pulse
Да
3
Кнопки
Edna Pulse
Да
Кнопки в количестве от 1 до 3 передаются в виде кнопок, 4 и более кнопок преобразуются в нумерованный список.
4
Перевод на оператора
Edna Pulse
Нет
5
Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Edna Pulse
Да
6
Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Edna Pulse
Да
7
Получение файла от Собеседника в сценарий
Edna Pulse
Да
Формат: file:тип файла|id передаваемого файла|ссылка на файл
8
Получение геолокации от собеседника в сценарии
Edna Pulse
Нет
@Агент
не реагирует никак на отправку геолокации
9
Доставка сообщений более 1000 символов от Агента до Собеседника
Edna Pulse
Да
10
Получить ссылку на источник лида
Edna Pulse
Нет
11
Использование маркдауна
Edna Pulse
Да
Поддерживаются следующие типы разметки: *жирный шрифт* _курсив_ *_жирный курсив_*
12
Рассылки с помощью Notification
Edna Pulse
Да
Перед созданием слота Notification необходимо проделать следующие действия:
Создать шаблон в WhatsApp.
Создать канал (без этого
@Слот
не удастся сохранить).
Важно: к одному WABA можно подключить только одного
@Агент
а.
There are no rows in this table

Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.