Edna Chat Center

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

Важно: Подключение бота в каналы общения происходит через техподдержку Edna.

Подключение

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

В первую очередь нужно произвести конфигурацию на стороне Edna.

  1. Авторизуйтесь в Edna как администратор.

  2. Перейдите в раздел Настройка → Чат-бот.

  4. Создайте нового бота и заполните следующие поля:

    1. Имя чат-бота — любое удобное имя.

    2. URL бекенда чат-бота для обработки сообщений клиента — URL полученный при конфигурации бота на платформе.

    3. URL бекенда чат-бота для инициации диалога с клиентом — URL полученный при конфигурации бота на платформе.

    4. Таймаут ожидания ответа чат-бота — время, при отсутствии ответа чат-бота, по истечении которого обращение распределяется в соответствии со следующим правилом, указанным в маршрутизации.

  6. Создайте токен используя кнопку +Token и запишите его. Он понадобится при настройке канала агента на платформе. Эта кнопка появляется при наведении курсора на поле с именем и настройками нужного Бота.

На этом конфигурация Бота в Edna завершена.

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

Агенту необходимо создать и настроить Канал Проекта с Коннектором “Edna Chat Center”.

  1. Кликните по кнопке настроек Агента.

  2. Нажмите кнопку Add channel.

  3. Откроется панель выбора Конечный канал.

  4. Выберите Edna Chat Center.

  5. Откроется панель создания Канал Проекта.

  6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.

  7. Пропишите адрес для вашего аккаунта в поле Edna Chat Center webhook URL в виде https://<some-name>.<edna-domen>/api/v1/chatbot, где <some-name> - имя поддомена вашего аккаунта Edna, а <edna-domen> - имя домена Edna(threads.im либо edna.io).

  8. Установите полученный в настройках бота Edna Chat Center токен в поле Edna Chat Center token.

  10. Скопируйте URL из поля Chatbot webhook URL нажатием кнопки Copy this webhook и вставьте в поля URL бекенда чат-бота для обработки сообщений клиента и URL бекенда чат-бота для инициации диалога с клиентом в настройках бота в Edna Chat Center.

  11. По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.

  12. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.

  13. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.

    1. Канал Проекта будет сохранен и активирован, если:

      1. Агент обучен;

      2. токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.

  15. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.

  1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

  2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.

    1. Изменения будут применены, если:

      1. Агент обучен;

      2. токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    3. Изменения не будут применены, если одно или больше условий не будут выполнены.

  4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.

  5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.

  6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.

    1. Изменения будут применены и Канал Проекта будет активирован, если:

      1. Агент обучен;

      2. токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.

  8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.

  9. Чтобы удалить Канал Проекта, нажмите кнопку 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

Нет

Сообщение
Конечный канал
Client message
Описание
Примечания

Открытие виджета Edna Chat Center

Edna Chat Center

Строка: edna: chat initialized

При открытии виджета Edna на веб-странице в переменную client_message пробрасывается сообщение ‘edna: chat initialized’.

Бот может реагировать на открытие виджета на веб-странице приветственным сообщением

О том, что такое сервисные сообщения и как активировать их передачу из Конечный канал: Принцип вывода Агента в различные каналы

PreviousLivetexNextEdna Pulse

Last updated