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