Интеграция с внешним мессенджером
Last updated
Was this helpful?
Last updated
Was this helpful?
Вы можете настроить интеграцию с внешним мессенджером с использованием вебхуков. Вебхук (webhook) — это отправка запросов по событиям.
Создайте канал с типом «Page messenger».
В панели управления перейдите в раздел «Каналы» и нажмите на кнопку «Добавить канал», расположенную в правом верхнем углу экрана.
Далее в окне «Добавление канала» из выпадающего списка выберите тип канала «Page messenger».
Укажите любые нужные параметры ниже и нажмите «Добавить канал».
Подробнее о создании каналов в статье «Каналы связи | Channels».
Создайте ИИ для входящих сообщений.
Для создания ИИ перейдите в раздел «ИИ» и нажмите на кнопку «Создать ИИ».
Подробнее в статье «Создание и настройка ИИ | AI».
Создайте интеграцию с типом «Все сообщения» для получения вебхуков о новых сообщениях.
Для создания интеграции с типом «Все сообщения» перейдите в раздел «Интеграции» и нажмите на кнопку «Создать интеграцию».
В окне «Добавление интеграции» из выпадающего списка выберите тип интеграции «Another».
В поле «Название» укажите название. В поле «webhook url» укажите URL для получения вебхуков. Затем в выпадающем списке «Выберите тип webhook» выберите «Все сообщения». Нажмите «Создать интеграцию».
Подробнее в статье «Интеграции | Integration».
Создайте задание с типом «Web».
Для создания задания с типом «Web» перейдите в раздел «Задания» и нажмите на кнопку «Создать задание».
В окне «Создать задание» в выпадающем списке «Тип» выберите «Web».
Далее выберите формат работы сервиса, созданные до этого канал, менеджера, ИИ, интеграцию и нажмите на кнопку «Создать задание».
После создания скопируйте id задания, он понадобится для запросов в API.
Подробнее в статье «Задания | Tasks».
Интегрируйте метод отправки сообщения от пользователя к ИИ https://docs.selarti.com/#d0d66a94-eebd-4095-b5fe-f58b31b1ab28. Передавайте в chat_id уникальный идентификатор пользователя, например, Telegram user_id. По этому id будет объединяться контекст диалога, а вы сможете идентифицировать вебхуки.
Получите вебхук после генерации сообщения ИИ и отправьте сообщение в диалог с пользователем.
channel_id
id канала. Используется для идентификации конкретного канала, через который осуществляется коммуникация. Может быть полезно для маршрутизации и обработки сообщений на вашей стороне.
close
Диалог закрыт/не закрыт. Используется для обозначения закрытия диалога или завершения коммуникации. Он сигнализирует о завершении сессии общения с пользователем или закрытии определенной задачи.
company_id
id компании. Используется для идентификации организации, к которой относится поступающее сообщение или команда. Позволяет точно обработать данные в контексте конкретной компании или отделения внутри системы.
contacts
Контакт. Используется для передачи информации о контакте, таких как телефон, юзернейм и др. Позволяет автоматически обновлять и синхронизировать контактные данные между системами.
external_chat_id
id диалога. Используется для идентификации конкретного чата или диалога в сторонней системе или мессенджере. Позволяет связывать сообщения и взаимодействия с нужным внешним диалогом.
get_contact
Контакт получен/не получен. Информирует, что в диалоге пользователь прислал телефон, почту и др.
interest
Проявление интереса есть/нет. Используется для обозначения заинтересованности клиента или активации интереса к определенному продукту или услуге.
is_bot
Диалог ведется с роботом да/нет. Если да, то наша система определила, что данный диалог ведется с ботом.
manager_id
id менеджера. Используется для идентификации конкретного менеджера, связанного с задачей или взаимодействием.
message_id
id сообщения. Используется для уникальной идентификации конкретного сообщения. Позволяет отслеживать, обрабатывать и ссылаться на определенные сообщения в системе.
message_text
Текст сообщения. Используется для передачи текста сообщения. Он позволяет получить и обработать содержимое сообщения, отправленного пользователем или системой, в нужном формате.
message_type
Тип сообщения бот/оператор/пользователь.
operator
Диалог передан на оператора да/нет.
panel_url
Ссылка на диалог в личном кабинете с возможностью ответить пользователю.
share_url
Ссылка на диалог только для просмотра, без возможности ответить.
success
Диалог является успешным да/нет.
task_id
id задания. Используется для уникальной идентификации задачи в системе.
thread_id
id треда. Используется для идентификации диалога с пользователем.
title
Заголовок. ФИО пользователя.
wh_type
Тип вебхука. Обозначает тип вебхука, событий или действий. Он помогает различать, какое именно событие произошло или какая информация передается через вебхук, для соответствующей обработки.
Появился новый параметр panel_url. Он содержит ссылку на диалог в вашем личном кабинете. В отличие от share_url, где можно только просмотреть диалог, с panel_url вы можете ответить пользователю напрямую. Обратите внимание, что для доступа потребуется авторизация и права доступа в компанию.
Попробуйте ответить пользователю через личный кабинет.
