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. Перейдите в Settings → Agent Bots.

2. Нажмите «+ Add Agent Bot».

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

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

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

4. Нажмите «Create Agent Bot».

Шаг 5. Настройка правила автоматизации

Это правило будет автоматически назначать все новые диалоги нашему боту.

1. Перейдите в Settings → Automation → Add Automation Rule.

2. Настройте правило следующим образом:

   • Rule Name: Assign new conversations to Lia Bot

   • Event: Conversation Created

   • Conditions: Status → is equal to → Open

   • Actions: Assign to Agent → Lia Bot (выберите бота, созданного на предыдущем шаге).

3. Нажмите «Create».

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