Chatwoot
Chatwoot — это open-source омниканальное решение, которое можно развернуть на собственном сервере или использовать в облаке. Сервис гибко настраивается под задачи вашего бизнеса.
Перед интеграцией или тестированием обязательно свяжитесь с вашим менеджером в Лия. Мы учтём ваши потребности и подскажем, как настроить всё максимально удобно. Если вы ещё не знакомы с менеджером или только начинаете работу с Лия, свяжитесь с нами любым удобным способом — мы вас сориентируем.
Обратите внимание: в отличие от других решений, Chatwoot не работает с Лия «из коробки» и требует предварительной настройки с нашей стороны — в зависимости от ваших целей.
Шаг 1. Настройка в Лия
Прежде чем настроить интеграцию, убедитесь, что у вас есть аккаунт в Chatwoot и вы успешно в нём авторизовались.
Далее настройте интеграцию в Лия:
Войдите в аккаунт Лия под учётной записью администратора.
Перейдите в раздел Интеграции.
Нажмите кнопку Добавить.
В выпадающем списке выберите Chatwoot.
После выбора канала в Chatwoot откроется форма для настройки.
Заполните её следующим образом:
API ключ — его нужно скопировать из вашего аккаунта в Chatwoot:
Нажмите на меню профиля в нижнем левом углу.
Выберите Настройки профиля.
Прокрутите страницу до конца и найдите раздел Токен доступа.
Скопируйте токен и вставьте его в поле API ключ в форме настроек канала в Лия.
Домен Chatwoot — скопируйте URL из вашего личного кабинета в Chatwoot, например:
https://app.chatwoot.com
, или укажите адрес сервера, на котором развернут ваш кастомный Chatwoot.Намерение для длинных сообщений — укажите намерение, на которое будет переадресовываться сообщение, если оно превышает установленный лимит длины.
Например, если клиент отправляет длинное и подробное сообщение с множеством вопросов, его можно сразу перенаправить к оператору, если это соответствует вашей бизнес-логике. Это сэкономит время клиента.
Поле должно быть в формате: qa-<укажите id>
или intent-<укажите id>
. Идентификатор можно найти на странице нужного интента / QA в личном кабинете Лия — он будет отображаться в адресной строке браузера.
4. Длина сообщения для перевода на намерение — укажите максимальную длину сообщения (в символах), при превышении которой оно будет автоматически направлено на намерение для длинных сообщений.
Не забудьте Включить и Сохранить канал
После сохранения канала свяжитесь с вашим менеджером в Лия — он сгенерирует и предоставит вам уникальный токен, необходимый для корректной пересылки сообщений из Chatwoot в Лия.
Если у вашего сервера Chatwoot нестандартный домен, сообщите менеджеру полный адрес сервера, на который Лия должна направлять ответы на пользовательские сообщения. Также укажите ID аккаунта, если ваша инфраструктура предполагает использование нескольких аккаунтов.
Если вы ещё не знакомы с менеджером, просто воспользуйтесь любым удобным способом связи с нашей командой.
Шаг 2. Настройка в Chatwoot
Теперь нужно настроить маршрутизацию сообщений в личном кабинете Chatwoot. Для этого создайте несколько сущностей:
Источник — обычно это виджет на вашей стороне, куда пользователи отправляют сообщения.
Бот — в контексте интеграции это Лия, которая будет получать сообщения от пользователей через вебхук и отвечать на них, отправляя ответы обратно в Chatwoot.
Вебхук — зарегистрируйте вебхук как отдельную сущность для отправки событий в Лия.
Правило автоматизации — настройте правило автоматической переадресации входящих /исходящих сообщений.
Источник
Перейдите в раздел Источники в настройках личного кабинета Chatwoot.
Нажмите кнопку Добавить источник и выберите подходящий вариант в зависимости от вашей бизнес-логики — от виджета на сайте до популярных мессенджеров.
Бот
Перейдите в раздел Боты в настройках Chatwoot.
Нажмите кнопку Add bot. В открывшейся форме укажите произвольное имя бота и введите URL вебхука, который состоит из двух частей:
Адрес канала интеграции:
https://app.lia.chat/channels/chatwoot?key=
API ключ, который вам предоставит наш менеджер в процессе настройки интеграции для безопасного соединения Chatwoot с Лия.
Завершите создание бота, нажав кнопку Create Bot.
Вебхук
Перейдите в раздел Интеграции и выберите настройку Webhooks.
Нажмите на кнопку Добавить новый вебхук и заполните открывшуюся форму:
Введите URL вебхука, аналогично тому, что вы указывали в разделе Бот.
Выберите необходимые события для вашей бизнес-логики, которые будут передаваться через вебхук в Лия. На скриншоте приведены наши рекомендации по отправляемым событиям.
Завершите создание, нажав кнопку Создать вебхук.
Важно: При настройке атрибутов для POST-запроса из вашего чат-решения (источника) в Chatwoot, ориентируйтесь на структуру запроса, указанную в документации Chatwoot. В процессе интеграции наш менеджер и команда разработки уточнят обязательные и опциональные атрибуты вашего запроса, исходя из конкретных требований.
Правило автоматизации
В разделе Автоматизация в меню настроек Chatwoot можно настроить дополнительные правила для переадресации и переопределения входящих событий.
Нажмите Добавить правило автоматизации, и в открывшейся форме выберите правила для обработки событий в соответствии с вашей бизнес-логикой.
В рамках правил можно указать конкретного оператора (включая бота), который будет обрабатывать определённые события, а также настроить отправку события по вебхуку. Для этого используйте URL вебхука, аналогичный тому, что указывался в разделе Бот.
Завершите создание правила, нажав кнопку Создать.
После завершения настройки вы можете запустить тестовый виджет и проверить коммуникацию с Лия, чтобы убедиться, что интеграция работает корректно.
Если возникнут вопросы, не стесняйтесь обращаться к документации Chatwoot и к нашей поддержке.
Last updated