Перейти к основному содержимому

Chatwoot

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

warning

Важное замечание: Интеграция с 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 и будет назначен живому сотруднику.