Инструкция: интеграция бота Chatme.ai с Edna Chat Center
Edna – одна из омниканальных платформ для общения с клиентами в текстовых каналах. Вы можете использовать её в качестве канала для публикации вашего бота от Chatme.ai в качестве бота-оператора.
⚠️ Важно: Подключение бота в каналы общения происходит через техподдержку 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<br>После отправки рассылки Слотом 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.<br>При работе Агента в 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, в остальных каналах не поддерживается.<br>Поддерживаются:*курсив*,_курсив_,__жирный шрифт__,*__жирный курсив__*,[ссылка](http://www.example.com/),инлайн код |
|
Рассылки с помощью Notification |
Edna Chat Center |
Нет |
— |
| Сервисное сообщение |
Конечный канал |
Client message |
Описание |
|---|---|---|---|
| Открытие виджета Edna Chat Center |
Edna Chat Center |
edna: chat initialized |
При открытии виджета Edna на веб-странице в переменнуюclient_messageпробрасывается это сообщение. Бот может реагировать на открытие виджета на веб-странице приветственным сообщением |


