> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Огляд інтеграцій

> Підключіть AI-агентів до каналів зв'язку, інструментів продуктивності та рекламних платформ

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/u4jrzWUP0vGPhn5W/images/integrations-overview-light.png?fit=max&auto=format&n=u4jrzWUP0vGPhn5W&q=85&s=35912161a44233ad59ca5133b741ffab" alt="Integrations overview" width="2873" height="1552" data-path="images/integrations-overview-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/u4jrzWUP0vGPhn5W/images/integrations-overview-dark.png?fit=max&auto=format&n=u4jrzWUP0vGPhn5W&q=85&s=db09aa52b3c494d18b03b1d4d9fc7c63" alt="Integrations overview" width="2873" height="1549" data-path="images/integrations-overview-dark.png" />
</Frame>

## Що таке інтеграції?

Інтеграції з'єднують ваших AI-агентів із зовнішніми сервісами — щоб вони могли відповідати на дзвінки, писати в месенджерах, надсилати електронні листи, створювати документи та аналізувати рекламні кампанії. Кожна інтеграція дає агенту набір **інструментів**, які він може викликати під час розмов.

## Доступні інтеграції

<CardGroup cols={2}>
  <Card title="Телефонія" icon="phone" href="/integrations/voip">
    Twilio, Ringostat, Binotel — AI-дзвінки та SMS
  </Card>

  <Card title="Месенджери" icon="comments" href="/integrations/messengers">
    Telegram, WhatsApp, Instagram DM, Facebook Messenger
  </Card>

  <Card title="Google Workspace" icon="google" href="/integrations/google-workspace">
    Gmail, Docs, Sheets, Drive, Calendar, Meet
  </Card>

  <Card title="Рекламні кампанії" icon="chart-line" href="/integrations/advertising">
    Google Ads, Facebook Ads — аналітика та управління кампаніями
  </Card>

  <Card title="Custom Webhook" icon="webhook" href="/integrations/webhook">
    Надсилайте дані лідів у будь-яку CRM чи зовнішню систему
  </Card>
</CardGroup>

## Як це працює

Кожна інтеграція проходить однаковий шлях:

<Steps>
  <Step title="Підключення">
    Додайте інтеграцію на сторінці Інтеграцій. Залежно від провайдера, ви або вводите API-ключі (VoIP, Telegram), або проходите OAuth авторизацію (Google, Meta).
  </Step>

  <Step title="Верифікація">
    Revol тестує ваші дані доступу через API провайдера та отримує доступні ресурси (номери телефонів, інформацію про бота, підключені акаунти).
  </Step>

  <Step title="Створення інструментів">
    Після верифікації Revol автоматично створює **інструменти агента** відповідно до типу інтеграції. Наприклад, підключення Gmail дає агентам інструменти `send_email`, `read_inbox`, `search_emails` та інші.
  </Step>

  <Step title="Призначення агенту">
    У вкладці **Tools** агента увімкніть потрібні інструменти. Потім додайте їх до workflow-нод — агент зможе викликати ці інструменти під час розмов через LLM function calling.
  </Step>
</Steps>

## Методи автентифікації

| Метод                | Використовується                                       | Як працює                                                                                                                        |
| -------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| **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 інтеграція  | Повідомлення WhatsApp Business         |
| **Instagram**  | Instagram інтеграція | Instagram Direct Messages              |

Щоб налаштувати канал, перейдіть у вкладку **Channels** агента, оберіть тип каналу та інтеграцію.

## Безпека вебхуків

Усі вхідні 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 — відправка даних, тестування з'єднання                |

**Всього: 67 інструментів агента** у 16 інтеграціях.

## Далі

<CardGroup cols={2}>
  <Card title="Налаштування VoIP" icon="phone" href="/integrations/voip">
    Підключіть Twilio, Ringostat або Binotel для AI-дзвінків
  </Card>

  <Card title="Налаштування месенджерів" icon="comments" href="/integrations/messengers">
    Підключіть Telegram, WhatsApp, Instagram або Facebook
  </Card>

  <Card title="Google Workspace" icon="google" href="/integrations/google-workspace">
    Підключіть Gmail, Docs, Sheets, Drive, Calendar, Meet
  </Card>

  <Card title="Реклама" icon="chart-line" href="/integrations/advertising">
    Підключіть Google Ads або Facebook Ads
  </Card>
</CardGroup>