Edna

Для начала работы с Edna необходимо завести аккаунт. Чтобы это сделать, свяжитесь со службой поддержки на сайте: https://edna.ru. После того как вам откроют доступ и создадут персональный субдомен, можно переходить к настройке интеграции.

Шаг 1. Настройка в Edna

Для корректной передачи сообщений между Edna и Лией необходимо создать несколько ключевых сущностей в Edna:

1. Сегмент — определяет, с какого события запускается маршрут. В нашем случае — когда пользователь открывает чат или пишет сообщение.

2. Маршрут — описывает, как будет обрабатываться сообщение и куда оно будет перенаправлено.

3. Канал — указывает, откуда поступает событие (например, чат на сайте или мессенджер).

4. Чат-бот — сущность в Edna, которая перенаправляет входящие сообщения в Лию и получает от неё ответы, чтобы вернуть их пользователю.

Подробная инструкция по созданию и настройке этих сущностей доступна в официальной документации Edna.

Далее расскажем о базовой настройке каждой из необходимых сущностей в Edna, которые потребуются для настройки интеграции.

Сегмент

Укажите произвольное название, по которому вы сможете быстро его найти в будущем.

В выпадающем списке Параметр выберите Состояние треда, а в значениях укажите: NEW, UNASSIGNED, SUSPENDED. После этого нажмите Сохранить.

Чат-бот

Чтобы создать чат-бот:

• Перейдите на вкладку Чат-боты и нажмите кнопку "+" для добавления нового.

• Задайте произвольное имя.

• В полях, отмеченных красной рамкой на картинке, вставьте ссылку из раздела Настройка в Лии.

Рекомендации:

• Установите увеличенные значения таймаутов:

Тайм-аут ожидания ответа — 5 минут.

Тайм-аут завершения треда — 10 минут. Это важно для начальной отладки: позже вы сможете скорректировать значения под свои задачи.

• Убедитесь, что включён чекбокс "Разрешать клиенту отправлять сообщения при наличии быстрых ответов-кнопок" — по умолчанию он активен, и его стоит оставить включённым.

Важно: После заполнения всех полей и сохранения чат-бота, обязательно сгенерируйте токен — он потребуется для дальнейшей настройки интеграции в Лии.

Маршрут

Для создания маршрута перейдите на вкладку "Маршруты" и нажмите кнопку "+".

Укажите произвольное имя маршрута — оно поможет вам быстро ориентироваться в списке.

Затем выполните следующие шаги:

• В поле Сегмент выберите тот сегмент, который вы создали ранее.
• В разделе Маршрут установите параметр Чат-бот и назначьте на него чат-бот, созданный ранее.

После заполнения всех полей нажмите Сохранить.

Канал

Для того чтобы сообщения от клиентов могли попадать в Edna, необходимо настроить хотя бы один канал.

Для запуска подойдёт виджет Edna.

1. Перейдите на вкладку "Каналы" и нажмите кнопку "+", чтобы создать новый канал. Система предложит настроить веб-виджет.

2. На вкладке "Параметры":

• Укажите произвольные значения в полях Название канала и Название приложения.

• Выберите нужный тип авторизации.

• Убедитесь, что чекбокс "Виджет размещен на сервере edna Chat Center" активен (по умолчанию он включён — оставьте его включённым).

1. На вкладке "Редактор settings.json":

• Найдите параметр unauthorizedHistory.

• Внутри него замените значение параметра count с 20 на 200 (или укажите другое значение, в зависимости от ваших потребностей):

Расширенная настройка производится с помощью редактирования файла settings.json. Перед настройкой рекомендуем ознакомиться с инструкциями: Структура конфигурационного файла settings.json, Настройка темы оформления, Настройка языковой локализации

1. На вкладке "Установка" будет показана инструкция по размещению виджета и сгенерированный HTML-код. Этот код нужно вставить в разметку вашей веб-страницы, чтобы виджет начал работать.

Не забудьте сохранить и включить канал. После этого он будет готов к использованию.

Для запуска тестового виджета в браузере вы можете использовать прикреплённый скрипт, который нужно запустить через консоль в Developer Tools.

2KB

Скрипт.txt

Перед запуском скрипта, отредактируйте последнюю строчку скрипта, указав данные вашего проекта:

"https://укажите тут свой субдомен/api/channels/web/идентификатор ваших настроек можно посмотреть в ЛК Edna в URL на вкладке Редактор settings.json/settings"

Идентификатор настроек можно найти в Личном кабинете Edna в URL на вкладке Редактор settings.json в разделе settings.

Шаг 2. Настройка в Лия

Теперь, когда маршрут в Edna настроен, нужно настроить интеграцию в Лия:

1. Войдите в аккаунт Лия под учётной записью администратора.

2. Перейдите в раздел Интеграции.
3. Нажмите кнопку Добавить.

В выпадающем списке выберите Edna.

После выбора канала Edna отобразится форма настроек. Заполните её следующим образом:

1. Инициализация чата Активируйте свитч, если вы хотите, чтобы Лия реагировала на открытие чата пользователем (например, запускала приветственное сообщение).

2. Субдомен Укажите субдомен вашего проекта в Edna — он отображается в URL, например: lia.edna.ru

3. Токен Edna Вставьте токен, сформированный ранее в разделе Чат-бот в Edna.
4. Максимальная длина сообщения Установите максимальное количество символов, допустимое для одного сообщения от пользователя.

5. Намерение для длинных сообщений Укажите, какое намерение будет использоваться для обработки сообщений, превышающих установленную длину. Это важная настройка, например, для перевода на оператора.

Не забудьте Включить и Сохранить канал

Перед началом тестирования обязательно свяжитесь с поддержкой Edna для донастройки параметров. Сообщите следующее:

• Ссылку для Edna, которую вы получили в настройках Лия.

• Уточните, что вы будете использовать текстовые кнопки.

После подтверждения со стороны поддержки вы можете запустить тестовый виджет и протестировать коммуникацию с Лия, чтобы убедиться, что интеграция работает корректно.