Интеграция с внешним мессенджером
Вы можете настроить интеграцию с внешним мессенджером с использованием вебхуков. Вебхук (webhook) — это отправка запросов по событиям.
Настройка интеграции
Создайте канал с типом «Page messenger».
В панели управления перейдите в раздел «Каналы» и нажмите на кнопку «Добавить канал», расположенную в правом верхнем углу экрана.

Далее в окне «Добавление канала» из выпадающего списка выберите тип канала «Page messenger».

Укажите любые нужные параметры ниже и нажмите «Добавить канал».

Подробнее о создании каналов в статье «Каналы связи | Channels».
Создайте ИИ для входящих сообщений.
Для создания ИИ перейдите в раздел «ИИ» и нажмите на кнопку «Создать ИИ».

Подробнее в статье «Создание и настройка ИИ | AI».
Создайте интеграцию с типом «Все сообщения» для получения вебхуков о новых сообщениях.
Для создания интеграции с типом «Все сообщения» перейдите в раздел «Интеграции» и нажмите на кнопку «Создать интеграцию».

В окне «Добавление интеграции» из выпадающего списка выберите тип интеграции «Another».

В поле «Название» укажите название. В поле «webhook url» укажите URL для получения вебхуков. Затем в выпадающем списке «Выберите тип webhook» выберите «Все сообщения». Нажмите «Создать интеграцию».

Подробнее в статье «Интеграции | Integration».
Создайте задание с типом «Web».
Для создания задания с типом «Web» перейдите в раздел «Задания» и нажмите на кнопку «Создать задание».

В окне «Создать задание» в выпадающем списке «Тип» выберите «Web».

Далее выберите формат работы сервиса, созданные до этого канал, ИИ, интеграцию и нажмите на кнопку «Создать задание».

После создания скопируйте id задания, он понадобится для запросов по API.
Подробнее в статье «Задания | Tasks».
Интегрируйте метод отправки сообщения от пользователя к ИИ:
🇬🇧 Send external message
🇷🇺 Отправить внешнее сообщение
🇺🇿 Tashqi xabar yuborish
1721129985149x478019552540622850unique chat_id in your system
123456789Test message via apiexample
POST /api/1.1/wf/send_message_external HTTP/1.1
Host: selarti.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 101
{
"task_id": "1721129985149x478019552540622850",
"chat_id": "123456789",
"message": "Test message via api"
}example
{
"response": {
"thread": {
"Created By": "1708251849975x447112648674775600",
"Created Date": 1731336491590,
"Modified Date": 1731336491593,
"_id": "1731336491572x316716105037601100",
"ai_thread_id": "thread_zZ32RNJ0WIH6rzBLS719LylE",
"chat_id": "123456789",
"close": false,
"company": "1708251850060x460235863640434700",
"contact": "123456789",
"count_message": 0,
"get_contact": false,
"interest": false,
"is_bot": false,
"operator": false,
"success": false,
"task": "1827394658203x947362851049736284",
"title": "API chat 123456789",
"user_replied": false,
"wh_get_contact": false,
"wh_interest": false,
"wh_success": false
}
},
"status": "success"
}Передавайте в chat_id уникальный идентификатор пользователя, например, Telegram user_id. По этому id будет объединяться контекст диалога, а вы сможете идентифицировать вебхуки.
Получите вебхук после генерации сообщения ИИ и отправьте сообщение в диалог с пользователем.
Список параметров и описание
channel_id
ID канала. Используется для идентификации конкретного канала, через который осуществляется коммуникация. Может быть полезно для маршрутизации и обработки сообщений на вашей стороне.
close
Диалог закрыт/не закрыт. Используется для обозначения закрытия диалога или завершения коммуникации. Он сигнализирует о завершении сессии общения с пользователем или закрытии определенной задачи.
company_id
ID компании. Используется для идентификации организации, к которой относится поступающее сообщение или команда. Позволяет точно обработать данные в контексте конкретной компании или отделения внутри системы.
contacts
Контакт. Используется для передачи информации о контакте, таких как телефон, юзернейм и др. Позволяет автоматически обновлять и синхронизировать контактные данные между системами.
dialog
Диалог ИИ с пользователем. Содержит переписку между ИИ и пользователем.
external_chat_id
ID диалога. Используется для идентификации конкретного чата или диалога в сторонней системе или мессенджере. Позволяет связывать сообщения и взаимодействия с нужным внешним диалогом.
get_contact
Контакт получен/не получен. Информирует, что в диалоге пользователь прислал телефон, почту и другое.
interest
Проявление интереса есть/нет. Используется для обозначения заинтересованности клиента или активации интереса к определенному продукту или услуге.
is_bot
Диалог ведется с роботом да/нет. Если да, то наша система определила, что данный диалог ведется с ботом.
message_id
ID сообщения. Используется для уникальной идентификации конкретного сообщения. Позволяет отслеживать, обрабатывать и ссылаться на определенные сообщения в системе.
message_text
Текст сообщения. Используется для передачи текста сообщения. Он позволяет получить и обработать содержимое сообщения, отправленного пользователем или системой, в нужном формате.
message_type
Тип сообщения бот/оператор/пользователь.
operator
Диалог передан на оператора да/нет.
panel_url
Ссылка на диалог в личном кабинете с возможностью ответить пользователю.
share_url
Ссылка на диалог для просмотра, без возможности ответить.
success
Диалог является успешным да/нет.
task_id
ID задания. Используется для уникальной идентификации задачи в системе.
task_name
Название задания. Используется для передачи названия задания, связанного с диалогом.
thread_id
ID треда. Используется для идентификации диалога с пользователем.
title
Заголовок. Имя, фамилия пользователя или название профиля.
wh_type
Тип вебхука. Обозначает тип вебхука, событий или действий. Он помогает различать, какое именно событие произошло или какая информация передается через вебхук, для соответствующей обработки.
Пример вебхука:
Попробуйте ответить пользователю через личный кабинет.
Last updated