Documentation Index
Fetch the complete documentation index at: https://revolai.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Що таке інтеграції?
Інтеграції з’єднують ваших AI-агентів із зовнішніми сервісами — щоб вони могли відповідати на дзвінки, писати в месенджерах, надсилати електронні листи, створювати документи та аналізувати рекламні кампанії. Кожна інтеграція дає агенту набір інструментів, які він може викликати під час розмов.Доступні інтеграції
Телефонія
Twilio, Ringostat, Binotel — AI-дзвінки та SMS
Месенджери
Telegram, WhatsApp, Instagram DM, Facebook Messenger
Google Workspace
Gmail, Docs, Sheets, Drive, Calendar, Meet
Рекламні кампанії
Google Ads, Facebook Ads — аналітика та управління кампаніями
Custom Webhook
Надсилайте дані лідів у будь-яку CRM чи зовнішню систему
Як це працює
Кожна інтеграція проходить однаковий шлях:Підключення
Додайте інтеграцію на сторінці Інтеграцій. Залежно від провайдера, ви або вводите API-ключі (VoIP, Telegram), або проходите OAuth авторизацію (Google, Meta).
Верифікація
Revol тестує ваші дані доступу через API провайдера та отримує доступні ресурси (номери телефонів, інформацію про бота, підключені акаунти).
Створення інструментів
Після верифікації Revol автоматично створює інструменти агента відповідно до типу інтеграції. Наприклад, підключення Gmail дає агентам інструменти
send_email, read_inbox, search_emails та інші.Методи автентифікації
| Метод | Використовується | Як працює |
|---|---|---|
| API Key / Token | Twilio, Ringostat, Binotel, Telegram | Введіть дані доступу у формі. Зберігаються зашифрованими в базі даних. |
| Google OAuth 2.0 | Gmail, Docs, Sheets, Drive, Calendar, Meet, Google Ads | Натисніть “Connect with Google”, авторизуйтесь на екрані згоди. Revol зберігає refresh token і автоматично оновлює access token. |
| Meta OAuth | WhatsApp, Instagram, Facebook Messenger, Facebook Ads | Натисніть “Connect with Meta”, авторизуйтесь через Meta. Revol обмінює код на довготривалий токен (~60 днів). |
| Webhook URL | Custom Webhook | Авторизація не потрібна — ви вказуєте URL і опціональні заголовки. |
Канали
Канал — це з’єднання між інтеграцією та конкретним AI-агентом. Одна інтеграція (наприклад, ваш акаунт Twilio) може обслуговувати кількох агентів через окремі канали. Доступні типи каналів:| Канал | Потрібна інтеграція | Опис |
|---|---|---|
| Веб-віджет | Ні | Вбудований чат-віджет для вашого сайту |
| Телефон | VoIP інтеграція | Вхідні/вихідні голосові дзвінки та SMS |
| Telegram | Telegram інтеграція | Повідомлення через Telegram-бота |
| WhatsApp інтеграція | Повідомлення WhatsApp Business | |
| Instagram інтеграція | Instagram Direct Messages |
Безпека вебхуків
Усі вхідні webhook-ендпоінти (VoIP дзвінки, повідомлення месенджерів) захищені:- Перевірка підпису — криптографічна верифікація автентичності запиту для кожного провайдера
- Ідемпотентність — виявлення дублікатів вебхуків для запобігання подвійної обробки
- Rate limiting — 120 запитів на хвилину на канал
- IP allowlist — де підтримується провайдером (наприклад, Binotel)
Всі інтеграції
| Інтеграція | Категорія | Авторизація | Інструменти |
|---|---|---|---|
| Twilio | Телефонія | API Key | 3 — дзвінки, SMS, історія дзвінків |
| Ringostat | Телефонія | API Key | 2 — дзвінки, історія дзвінків |
| Binotel | Телефонія | API Key | 2 — дзвінки, історія дзвінків |
| Telegram | Месенджер | Bot Token | 6 — повідомлення, файли, історія, редагування, видалення |
| WhatsApp Business | Месенджер | Meta OAuth | 6 — повідомлення, шаблони, медіа, історія |
| Instagram DM | Месенджер | Meta OAuth | 6 — повідомлення, медіа, історія, коментарі |
| Facebook Messenger | Месенджер | Meta OAuth | 6 — повідомлення, шаблони, медіа, кнопки |
| Gmail | Продуктивність | Google OAuth | 6 — надсилання, читання, пошук, відповіді, чернетки |
| Google Docs | Продуктивність | Google OAuth | 5 — створення, читання, доповнення, пошук, експорт |
| Google Sheets | Продуктивність | Google OAuth | 7 — читання, запис, доповнення, пошук, створення |
| Google Drive | Продуктивність | Google OAuth | 8 — список, пошук, завантаження, поширення, папки |
| Google Calendar | Продуктивність | Google OAuth | 6 — події, доступність, вільні слоти |
| Google Meet | Продуктивність | Google OAuth | 1 — створення посилання на зустріч |
| Google Ads | Реклама | Google OAuth | 3 — кампанії, ключові слова, пауза |
| Facebook Ads | Реклама | Meta OAuth | 4 — кампанії, набори оголошень, аналітика, пауза |
| Custom Webhook | CRM | URL | 2 — відправка даних, тестування з’єднання |
Далі
Налаштування VoIP
Підключіть Twilio, Ringostat або Binotel для AI-дзвінків
Налаштування месенджерів
Підключіть Telegram, WhatsApp, Instagram або Facebook
Google Workspace
Підключіть Gmail, Docs, Sheets, Drive, Calendar, Meet
Реклама
Підключіть Google Ads або Facebook Ads