Вывод Агента в омниканальные платформы

icon picker
Edna

– одна из омниканальных платформ для общения с клиентами в текстовых каналах. Вы можете использовать её в качестве канала для публикации вашего
@Агент
а в качестве бота-оператора. Ознакомиться с пользовательской документацией вы можете по .
Важно: Подключение бота в каналы общения происходит через техподдержку Edna.


Подключение

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

В первую очередь нужно произвести конфигурацию на стороне Edna.
Авторизуйтесь в Edna как администратор.
Перейдите в раздел НастройкаЧат-бот.
image.png
Создайте нового бота и заполните следующие поля:
Имя чат-бота — любое удобное имя.
URL бекенда чат-бота для обработки сообщений клиента — URL полученный при .
URL бекенда чат-бота для инициации диалога с клиентом — URL полученный при .
Таймаут ожидания ответа чат-бота — время, при отсутствии ответа чат-бота, по истечении которого обращение распределяется в соответствии со следующим правилом, указанным в маршрутизации.
image.png
Создайте токен используя кнопку +Token и запишите его. Он понадобится при . Эта кнопка появляется при наведении курсора на поле с именем и настройками нужного
@Бот
а.
image.png
На этом конфигурация
@Бот
а в Edna завершена.

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

@Агент
у необходимо создать и настроить
@Канал Агента
с
@Коннектор
ом “Edna Chat Center”.
Войдите в меню редактирования (Edit) настроек вашего
@Агент
а
image.png
В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
выберите тип канала Omnichannel
Нажмите кнопку Add channel ​
Снимок экрана 2023-07-03 в 17.59.51.png
Выберите в поле Channel
@Коннектор
“Edna Chat Center”. ​
Снимок экрана 2023-07-03 в 18.02.38.png
По необходимости пропишите заголовок для данного
@Канал Агента
в поле Title. ​
Снимок экрана 2023-07-03 в 18.04.17.png
После выбора “Edna Chat Center” вам станет доступна ссылка на вебхук канала агента (поле Chatbot webhook: URL), которую нужно скопировать и вставить в поля URL бекенда чат-бота для обработки сообщений клиента и URL бекенда чат-бота для инициации диалога с клиентом в настройках бота в Edna. Выделить URL полностью можно двойным кликом.
Снимок экрана 2023-07-03 в 18.19.32.png
Установите полученный в настройках бота Edna токен в поле Channel webhook: Token в окне настроек
@Канал Агента
.
Также пропишите адрес для вашего аккаунта в поле Channel webhook: URL в виде https://<some-name>.<edna-domen>/api/v1/chatbot, где <some-name> - имя поддомена вашего аккаунта Edna, а <edna-domen> - имя домена Edna(threads.im либо edna.io).
image.png
Активируйте канал переключением тумблера для того, чтобы
@Агент
начал отвечать в нем.
Если
@Агент
не был обучен, появится предупреждение. В таком случае необходимо обучить
@Агент
а, после чего повторить попытку активации
@Канал Агента
.
image.png
После активации
@Канал Агента
, если есть проблемы с его доступностью, будет выведено предупреждение (
@Канал Агента
будет активирован несмотря на проблемы):
"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
image.png
Сохраните
@Канал Агента
— нажмите Save.
Важно: Все настройки будут применены только после сохранения.

Общение

Взаимодействие с Edna происходит через и согласно настройкам вашего аккаунта Edna.
@Агент
является ботом-оператором в Edna.
Важно: Edna не может гарантировать порядок доставки сообщений до
@Собеседник
а: если интервал их поступления от
@Агент
а очень маленький, чтобы устранить данное негативное поведение, на
@Коннектор
е к Edna введена задержка в 0,5 секунд между отправкой сообщений.
Маппинг Канальных переменных из канала Edna
Канальная переменная
Конечный канал
Переменная в теле входящего запроса из канала
1
channel_visitor_id
Edna Chat Center
threadsClientId
2
channel_conversation_id
Edna Chat Center
sessionId
3
channel_visitor_firstname
Edna Chat Center
client_data.name
4
channel_visitor_lastname
Edna Chat Center
Нет
5
channel_visitor_phone
Edna Chat Center
client_data.phone
После отправки рассылки
@Слот
ом
@Notification
в эту переменную попадает номер телефона, на который была отправлена рассылка
6
channel_visitor_email
Edna Chat Center
client_data.email
7
channel_visitor_account
Edna Chat Center
channel_info.channelType
8
channel_visitor_auth
Edna Chat Center
Нет
9
channel_visitor_source
Edna Chat Center
Нет
10
channel_reply_to
Edna Chat Center
нет
There are no rows in this table
Возможности общения в канале Edna
Функционал
Конечный канал
Наличие в канале
Описание
1
Кнопки
Edna Chat Center
Да
Максимальная длина текста кнопки — 20 символов. При превышении длины в 20 символов происходит зависание Сценария. Увеличить лимит можно через техподдержку Edna.
Проблема: при работе
@Агент
а в Viber кнопки не отображаются и общение переводится на оператора
2
Перевод на оператора
Edna Chat Center
Да
Для перевода диалога на оператора используется слот .
Также возможен перевод на оператора через по
3
Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Edna Chat Center
Нет
4
Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Edna Chat Center
Да
5
Получение файла от Собеседника в сценарий
Edna Chat Center
Частично
Зависит от канала, виджет Edna не принимает файлы. Метаданные файла (тип, ссылка) записываются в
@client_message
, файл в платформу не закачивается
6
Получение геолокации от собеседника в сценарии
Edna Chat Center
Нет
7
Доставка сообщений более 1000 символов от Агента до Собеседника
Edna Chat Center
Да
Доставка сообщений до 4000 символов
8
Использование маркдауна
Edna Chat Center
Частично
Поддерживается в виджете. Отображение текста, размеченного с помощью
@Markdown
, в остальных каналах не поддерживается.
Поддерживаются следующие типы разметки:
*курсив*
_курсив_
__жирный шрифт__
*__жирный курсив__*
[ссылка](http://www.example.com/)
`инлайн код`
9
Рассылки с помощью Notification
Edna Chat Center
Нет
There are no rows in this table
Сервисные сообщения в канале Edna
Сообщение
Конечный канал
Client message
Описание
Кейсы
1
Открытие виджета Edna Chat Center
Edna Chat Center
Строка: edna: chat initialized
При открытии виджета Edna на веб-странице в переменную
@client_message
пробрасывается сообщение ‘edna: chat initialized’.
Бот может реагировать на открытие виджета на веб-странице приветственным сообщением
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.