Edna

Это руководство поможет вам шаг за шагом настроить интеграцию между платформой «Лия» и омниканальным решением Edna.

к сведению

Для начала работы вам потребуется аккаунт в Edna. Если у вас его еще нет, пожалуйста, свяжитесь со службой поддержки на сайте edna.ru, чтобы получить доступ и персональный субдомен.

Этап 1: Настройка в Edna

На этом этапе мы подготовим ваш личный кабинет Edna, создав все необходимые сущности для маршрутизации сообщений в «Лию».

Шаг 1. Создание Сегмента

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

1. В личном кабинете Edna перейдите в Настройки → Сегменты.
2. Нажмите «+», чтобы создать новый сегмент.
3. Дайте ему понятное имя (например, Новые диалоги для Лии).
4. В поле «Параметр» выберите Состояние треда.
5. В поле «Значения» укажите: NEW, UNASSIGNED, SUSPENDED.
6. Нажмите «Сохранить».

Шаг 2. Создание Чат-бота

Чат-бот в Edna — это сущность, которая будет выступать в роли связующего звена с «Лией».

1. Перейдите на вкладку Чат-боты и нажмите «+».
2. Задайте боту имя (например, Лия).
3. В поля URL webhook и URL для запроса статуса вставьте ссылку, которую вы получите позже, на этапе настройки в «Лие».
4. Рекомендация: Установите таймауты с запасом для отладки (например, 5-10 минут). Позже их можно будет уменьшить.
5. Нажмите «Сохранить».

warning

Сохраните токен! После сохранения чат-бота Edna сгенерирует для него токен. Скопируйте его — он понадобится для финальной настройки в «Лие».

Шаг 3. Создание Маршрута

Маршрут связывает сегмент с чат-ботом, направляя новые диалоги на обработку в «Лию».

1. Перейдите на вкладку Маршруты и нажмите «+».
2. Дайте маршруту имя (например, Перевод на Лию).
3. В поле «Сегмент» выберите сегмент, созданный на шаге 1.
4. В разделе «Маршрут» установите параметр Чат-бот и выберите чат-бота, созданного на шаге 2.
5. Нажмите «Сохранить».

Шаг 4. Настройка Канала

Канал — это источник сообщений, например, веб-виджет на вашем сайте.

1. Перейдите на вкладку Каналы и нажмите «+», чтобы создать новый канал (например, веб-виджет).
2. На вкладке «Параметры» задайте имя канала и приложения.
3. На вкладке «Редактор settings.json» найдите параметр unauthorizedHistory и увеличьте значение count до 200 для более удобного тестирования.
4. На вкладке «Установка» вы найдете HTML-код для вставки виджета на ваш сайт.
5. Включите и сохраните канал.

Этап 2: Настройка в «Лие»

Теперь, когда Edna готова, завершим интеграцию, настроив соответствующий канал в «Лие».

Шаг 5. Настройка канала в «Лие»

1. В личном кабинете «Лия» перейдите в раздел Интеграции.

2. Нажмите «Добавить» и выберите из списка Edna.

3. Заполните форму:

   Поле	Описание	Обязательно
   Инициализация чата	Активируйте, если бот должен реагировать на открытие чата, а не только на первое сообщение.	Нет
   Субдомен	Ваш субдомен в Edna (например, mycompany.edna.ru).	Да
   Токен Edna	Токен, скопированный на шаге 2 при создании чат-бота в Edna.	Да
   Максимальная длина сообщения	Лимит символов для опции ниже.	Нет
   Намерение для длинных сообщений	Поведение для очень длинных сообщений.	Нет

4. Активируйте «Включить канал» и нажмите «Сохранить».

Этап 3: Финальная настройка и запуск

Осталось сделать последний шаг — связать две системы.

1. Вернитесь в Edna в настройки чат-бота, созданного на шаге 2.
2. В поля URL webhook и URL для запроса статуса вставьте ссылку, которая появилась в настройках канала Edna в «Лие» после его сохранения.

к сведению

Готово! Теперь интеграция настроена. Вы можете использовать тестовый виджет Edna, чтобы отправить сообщение и убедиться, что оно корректно обрабатывается в «Лие» и ответ возвращается обратно в виджет.