Edna Chat Center
Edna – одна из омниканальных платформ для общения с клиентами в текстовых каналах. Вы можете использовать её в качестве канала для публикации вашего Агента в качестве бота-оператора. Ознакомиться с пользовательской документацией вы можете по этой ссылке.
Важно: Подключение бота в каналы общения происходит через техподдержку Edna.
Подключение
1. Конфигурация бота на стороне Edna
В первую очередь нужно произвести конфигурацию на стороне Edna.
Авторизуйтесь в Edna как администратор.
Перейдите в раздел Настройка → Чат-бот.
Создайте нового бота и заполните следующие поля:
Имя чат-бота — любое удобное имя.
URL бекенда чат-бота для обработки сообщений клиента — URL полученный при конфигурации бота на платформе.
URL бекенда чат-бота для инициации диалога с клиентом — URL полученный при конфигурации бота на платформе.
Таймаут ожидания ответа чат-бота — время, при отсутствии ответа чат-бота, по истечении которого обращение распределяется в соответствии со следующим правилом, указанным в маршрутизации.
Создайте токен используя кнопку +Token и запишите его. Он понадобится при настройке канала агента на платформе. Эта кнопка появляется при наведении курсора на поле с именем и настройками нужного Бота.
На этом конфигурация Бота в Edna завершена.
2. Конфигурация канала агента в Платформе
Агенту необходимо создать и настроить Канал Проекта с Коннектором “Edna Chat Center”.
Кликните по кнопке настроек Агента.
Нажмите кнопку Add channel.
Откроется панель выбора Конечный канал.
Выберите Edna Chat Center.
Откроется панель создания Канал Проекта.
По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.
Пропишите адрес для вашего аккаунта в поле Edna Chat Center webhook URL в виде https://<some-name>.<edna-domen>/api/v1/chatbot, где <some-name> - имя поддомена вашего аккаунта Edna, а <edna-domen> - имя домена Edna(threads.im либо edna.io).
Установите полученный в настройках бота Edna Chat Center токен в поле Edna Chat Center token.
Скопируйте URL из поля Chatbot webhook URL нажатием кнопки Copy this webhook и вставьте в поля URL бекенда чат-бота для обработки сообщений клиента и URL бекенда чат-бота для инициации диалога с клиентом в настройках бота в Edna Chat Center.
По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.
Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.
Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.
Канал Проекта будет сохранен и активирован, если:
Агент обучен;
токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
Для отмены создания Канал Проекта нажмите кнопку CANCEL.
Редактирование и удаление Канала Агента
Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.
Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
Изменения будут применены, если:
Агент обучен;
токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Изменения не будут применены, если одно или больше условий не будут выполнены.
Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
Изменения будут применены и Канал Проекта будет активирован, если:
Агент обучен;
токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
Чтобы удалить Канал Проекта, нажмите кнопку DELETE.
Общение
Взаимодействие с Edna происходит через Edna external API и согласно настройкам вашего аккаунта Edna. Агент является ботом-оператором в Edna.
Важно: Edna не может гарантировать порядок доставки сообщений до Собеседника: если интервал их поступления от Агента очень маленький, чтобы устранить данное негативное поведение, на Коннекторе к Edna введена задержка в 0,5 секунд между отправкой сообщений.
channel_visitor_id
Edna Chat Center
threadsClientId
channel_conversation_id
Edna Chat Center
sessionId
channel_visitor_firstname
Edna Chat Center
client_data.name
channel_visitor_lastname
Edna Chat Center
Нет
channel_visitor_phone
Edna Chat Center
client_data.phoneПосле отправки рассылки Слотом Notification в эту переменную попадает номер телефона, на который была отправлена рассылка
channel_visitor_email
Edna Chat Center
client_data.email
channel_visitor_account
Edna Chat Center
channel_info.channelType
channel_visitor_auth
Edna Chat Center
Нет
channel_visitor_source
Edna Chat Center
Нет
Кнопки
Edna Chat Center
Да
Максимальная длина текста кнопки — 20 символов. При превышении длины в 20 символов происходит зависание Сценария. Увеличить лимит можно через техподдержку Edna.
При работе Агента в Viber кнопки не отображаются и общение переводится на оператора
Перевод на оператора
Edna Chat Center
Да
Для перевода диалога на оператора используется слот Change Chat Mode.Также возможен перевод на оператора через метод API.по External Request
Передача файлов в виде файлов от Агента (Attachment)
Edna Chat Center
Нет
Передача файлов в виде ссылок от Агента (Attachment)
Edna Chat Center
Да
Получение файла от Собеседника в сценарий
Edna Chat Center
Частично
Зависит от канала, виджет Edna не принимает файлы. Метаданные файла (тип, ссылка) записываются в client_message, файл в платформу не закачивается
Получение геолокации от собеседника в сценарии
Edna Chat Center
Нет
Доставка сообщений более 1000 символов от Агента до Собеседника
Edna Chat Center
Да
Доставка сообщений до 4000 символов
Использование маркдауна
Edna Chat Center
Частично
Поддерживается в виджете. Отображение текста, размеченного с помощью Markdown, в остальных каналах не поддерживается.Поддерживаются следующие типы разметки:*курсив*_курсив___жирный шрифт__*__жирный курсив__*[ссылка](http://www.example.com/)`инлайн код`
Рассылки с помощью Notification
Edna Chat Center
Нет
Открытие виджета Edna Chat Center
Edna Chat Center
Строка: edna: chat initialized
При открытии виджета Edna на веб-странице в переменную client_message пробрасывается сообщение ‘edna: chat initialized’.
Бот может реагировать на открытие виджета на веб-странице приветственным сообщением
О том, что такое сервисные сообщения и как активировать их передачу из Конечный канал: Принцип вывода Агента в различные каналы
Last updated