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. Нажмите «Сохранить».

Сохраните токен! После сохранения чат-бота 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, чтобы отправить сообщение и убедиться, что оно корректно обрабатывается в «Лие» и ответ возвращается обратно в виджет.