Интеграция с внешним мессенджером
Last updated
Was this helpful?
Last updated
Was this helpful?
Вы можете настроить интеграцию с внешним мессенджером с использованием вебхуков. Вебхук (webhook) — это отправка запросов по событиям.
Создайте канал с типом «Page messenger».
В панели управления перейдите в раздел «» и нажмите на кнопку «Добавить канал», расположенную в правом верхнем углу экрана.
Далее в окне «Добавление канала» из выпадающего списка выберите тип канала «Page messenger».
Укажите любые нужные параметры ниже и нажмите «Добавить канал».
Создайте ИИ для входящих сообщений.
Создайте интеграцию с типом «Все сообщения» для получения вебхуков о новых сообщениях.
В окне «Добавление интеграции» из выпадающего списка выберите тип интеграции «Another».
В поле «Название» укажите название. В поле «webhook url» укажите URL для получения вебхуков. Затем в выпадающем списке «Выберите тип webhook» выберите «Все сообщения». Нажмите «Создать интеграцию».
Создайте задание с типом «Web».
В окне «Создать задание» в выпадающем списке «Тип» выберите «Web».
Далее выберите формат работы сервиса, созданные до этого канал, менеджера, ИИ, интеграцию и нажмите на кнопку «Создать задание».
После создания скопируйте id задания, он понадобится для запросов по API.
Получите вебхук после генерации сообщения ИИ и отправьте сообщение в диалог с пользователем.
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
Тип вебхука. Обозначает тип вебхука, событий или действий. Он помогает различать, какое именно событие произошло или какая информация передается через вебхук, для соответствующей обработки.
Попробуйте ответить пользователю через личный кабинет.
Подробнее о создании каналов в статье .
Для создания ИИ перейдите в раздел «» и нажмите на кнопку «Создать ИИ».
Подробнее в статье
Для создания интеграции с типом «Все сообщения» перейдите в раздел «» и нажмите на кнопку «Создать интеграцию».
Подробнее в статье
Для создания задания с типом «Web» перейдите в раздел «» и нажмите на кнопку «Создать задание».
Подробнее в статье
Интегрируйте метод отправки сообщения от пользователя к ИИ . Передавайте в chat_id уникальный идентификатор пользователя, например, Telegram user_id. По этому id будет объединяться контекст диалога, а вы сможете идентифицировать вебхуки.
