Підтримувані месенджери
| Месенджер | Авторизація | Вхідні | Вихідні | Інструменти |
|---|---|---|---|---|
| Telegram | Bot Token | Так | Так | 6 |
| WhatsApp Business | Meta OAuth | Так | Так | 6 |
| Instagram DM | Meta OAuth | Так | Так | 6 |
| Facebook Messenger | Meta OAuth | Так | Так | 6 |
Telegram
Telegram — найпростіша інтеграція: без OAuth, без додаткових SDK. Потрібен лише токен бота від BotFather.Налаштування
Створіть бота
Відкрийте @BotFather в Telegram, надішліть
/newbot і дотримуйтесь інструкцій. Ви отримаєте токен бота у форматі 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.Додайте інтеграцію
Перейдіть в Інтеграції → Додати інтеграцію → оберіть Telegram з категорії Месенджери.
Інструменти агента
| Інструмент | Опис |
|---|---|
send_message | Надіслати текстове повідомлення (HTML або Markdown) з опціональною відповіддю |
send_file | Надіслати фото, документ, аудіо або відео за публічним URL |
get_chat_history | Отримати останні повідомлення з чату |
get_chat_info | Отримати інформацію про чат/користувача (ім’я, біо, кількість учасників) |
edit_message | Редагувати раніше надіслане повідомлення бота |
delete_message | Видалити повідомлення з чату |
WhatsApp Business
WhatsApp Business API доступний через Meta Graph API. Потрібен Meta Business акаунт з доступом до WhatsApp Business API.Налаштування
Налаштування Meta Business
Створіть Meta Business Account та налаштуйте доступ до WhatsApp Business API.
OAuth
Натисніть “Connect with Meta” — ви будете перенаправлені на екран згоди Meta. Авторизуйте доступ до WhatsApp Business акаунту.
WhatsApp має 24-годинне вікно повідомлень. Вільні повідомлення можна надсилати лише протягом 24 годин після останнього повідомлення клієнта. Поза цим вікном використовуйте
send_template_message з попередньо затвердженими шаблонами.Інструменти агента
| Інструмент | Опис |
|---|---|
send_message | Надіслати текстове повідомлення у 24-годинному вікні |
send_template_message | Надіслати затверджений шаблон (працює поза 24-годинним вікном) |
send_media | Надіслати зображення, документ, відео або аудіо за URL |
get_message_history | Отримати історію повідомлень розмови |
get_contact_info | Отримати інформацію профілю контакту |
mark_as_read | Відправити підтвердження прочитання повідомлення |
Instagram DM
Instagram Direct Messages доступні через Meta Graph API з тим самим OAuth-потоком, що й WhatsApp.Налаштування
Інструменти агента
| Інструмент | Опис |
|---|---|
send_message | Надіслати пряме повідомлення користувачу Instagram |
send_media | Надіслати медіа-вкладення в DM |
get_message_history | Отримати повідомлення DM-треду |
get_profile | Отримати публічну інформацію профілю Instagram |
get_comments | Отримати коментарі до конкретного посту |
reply_to_comment | Відповісти на коментар у треді |
Facebook Messenger
Facebook Messenger підключається через вашу Facebook-сторінку. Той самий Meta OAuth-потік, що й для WhatsApp та Instagram.Налаштування
Інструменти агента
| Інструмент | Опис |
|---|---|
send_message | Надіслати текстове повідомлення користувачу Facebook |
send_template_message | Надіслати структурований шаблон (кнопки, generic, receipt) |
send_media | Надіслати зображення, відео, аудіо або файл |
get_message_history | Отримати тред розмови |
get_profile | Отримати профіль користувача за page-scoped ID |
send_buttons | Надіслати варіанти швидких відповідей |
Потік повідомлень
Незалежно від месенджера, потік обробки ідентичний:Вхідне повідомлення
Платформа месенджера надсилає вебхук в Revol з вмістом повідомлення та інформацією про відправника.
Маршрутизація до агента
Revol ідентифікує канал, знаходить призначеного AI-агента та створює або продовжує сесію розмови. Один і той самий відправник завжди потрапляє в той самий тред розмови.
Обробка AI
Повідомлення обробляється через workflow агента — LLM-ноди, пошук у базі знань (RAG), виклики інструментів та умови.
Використання інструментів у workflow-нодах
Інструменти месенджерів працюють як будь-які інші інструменти агента:- Підключіть інтеграцію та верифікуйте дані доступу
- У вкладці Tools агента ви побачите створені інструменти
- Додайте інструменти до custom node у workflow-редакторі
- LLM вирішує, коли їх використовувати, на основі контексту розмови
send_media для надсилання PDF-документа, а потім підтверджує доставку в чаті.
Безпека вебхуків
| Месенджер | Перевірка |
|---|---|
| Telegram | Секретний токен у URL вебхука (SHA-256 хеш токена бота) |
HMAC-SHA256 підпис (заголовок X-Hub-Signature-256 з app_secret) | |
HMAC-SHA256 підпис (заголовок X-Hub-Signature-256 з app_secret) | |
HMAC-SHA256 підпис (заголовок X-Hub-Signature-256 з app_secret) |