Chatwoot

Chatwoot — это популярное open-source решение для омниканальной поддержки клиентов. Эта инструкция поможет вам настроить интеграцию между «Лией» и вашим аккаунтом Chatwoot.

Важное замечание: Интеграция с Chatwoot требует предварительной координации с нашей командой. Перед началом настройки, пожалуйста, свяжитесь с вашим менеджером в «Лие». Мы поможем учесть все особенности вашего проекта.

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

Начнем с создания и настройки канала Chatwoot в вашем проекте «Лия».

Шаг 1. Создание канала

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

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

3. В открывшейся форме заполните следующие поля:

   • API ключ: Его нужно скопировать из вашего аккаунта Chatwoot. Для этого:

     • Нажмите на иконку вашего профиля в левом нижнем углу и выберите «Настройки профиля».

     • Прокрутите вниз до раздела «Токен доступа» и скопируйте ключ.

   • Домен Chatwoot: Укажите URL вашего личного кабинета (например, https://app.chatwoot.com) или адрес вашего собственного сервера, если вы используете self-hosted версию.

   • Намерение для длинных сообщений: (Опционально) Выберите намерение, которое будет срабатывать, если сообщение пользователя превысит заданный лимит.

   • Длина сообщения: Установите лимит символов для опции выше.

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

Шаг 2. Получение Webhook URL

После сохранения канала «Лия» сгенерирует для вас уникальный Webhook URL. Этот URL необходим для того, чтобы Chatwoot мог отправлять сообщения в «Лию».

Свяжитесь с вашим менеджером в «Лие», чтобы получить этот URL. Он будет иметь следующий формат: https://app.lia.chat/channels/chatwoot?key=ВАШ_УНИКАЛЬНЫЙ_КЛЮЧ

Этап 2: Настройка в Chatwoot

Теперь настроим Chatwoot для взаимодействия с «Лией», создав источник, бота-агента и правило автоматизации.

Шаг 3. Создание источника (Inbox)

1. В настройках Chatwoot перейдите в раздел Inboxes → Add Inbox.

2. Выберите канал, который вы хотите автоматизировать (например, Website для чат-виджета).

3. Следуйте инструкциям на экране, чтобы завершить настройку. Этот источник будет принимать сообщения от ваших клиентов.

Шаг 4. Создание бота (Agent Bot)

1. Перейдите в Настройки → Боты.

2. Нажмите «+ Добавить бота».

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

   • Имя бота: Дайте боту имя (например, Lia Bot).

   • URL вебхука: Вставьте сюда Webhook URL, который вы получили от вашего менеджера на шаге 2.

4. Нажмите «Создать бота».

Шаг 5. Настройка ответственного бота для источника

1. Перейдите в Источники → Выбирите источник → Настройки бота.

2. Выбирите бота, созданного на шаге 4.

3. Нажмите «Сохранить».

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