> ## 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.

# Integrations Overview

> Connect AI agents to communication channels, productivity tools, and ad platforms

<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>

## What Are Integrations?

Integrations connect your AI agents to external services — so they can answer phone calls, reply in messengers, send emails, create documents, and pull analytics data. Each integration gives your agent a set of **tools** it can call during conversations.

## Available Integrations

<CardGroup cols={2}>
  <Card title="Telephony" icon="phone" href="/integrations/voip">
    Twilio, Ringostat, Binotel — AI-powered phone calls and SMS
  </Card>

  <Card title="Messengers" 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="Ad Campaigns" icon="chart-line" href="/integrations/advertising">
    Google Ads, Facebook Ads — campaign analytics and management
  </Card>

  <Card title="Custom Webhook" icon="webhook" href="/integrations/webhook">
    Send lead data to any CRM or external system
  </Card>
</CardGroup>

## How It Works

Every integration follows the same pattern:

<Steps>
  <Step title="Connect">
    Add an integration from the Integrations page. Depending on the provider, you either enter API credentials (VoIP, Telegram) or go through OAuth (Google, Meta).
  </Step>

  <Step title="Verify">
    Revol tests your credentials against the provider's API and fetches available resources (phone numbers, bot info, connected accounts).
  </Step>

  <Step title="Provision Tools">
    After verification, Revol automatically creates **agent tools** based on the integration type. For example, connecting Gmail gives your agents `send_email`, `read_inbox`, `search_emails`, and other tools.
  </Step>

  <Step title="Assign to Agent">
    In the agent's **Tools** tab, enable the tools you need. Then add them to workflow nodes — the agent can call these tools during conversations via LLM function calling.
  </Step>
</Steps>

## Authentication Methods

| Method               | Used by                                                | How it works                                                                                                                 |
| -------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| **API Key / Token**  | Twilio, Ringostat, Binotel, Telegram                   | Enter credentials in the wizard. Stored encrypted in the database.                                                           |
| **Google OAuth 2.0** | Gmail, Docs, Sheets, Drive, Calendar, Meet, Google Ads | Click "Connect with Google", authorize in the consent screen. Revol stores a refresh token and auto-refreshes access tokens. |
| **Meta OAuth**       | WhatsApp, Instagram, Facebook Messenger, Facebook Ads  | Click "Connect with Meta", authorize via Meta. Revol exchanges the code for a long-lived token (\~60 days).                  |
| **Webhook URL**      | Custom Webhook                                         | No auth needed — you provide the target URL and optional headers.                                                            |

## Channels

A **channel** is the connection between an integration and a specific AI agent. One integration (e.g., your Twilio account) can serve multiple agents through separate channels.

Available channel types:

| Channel        | Requires Integration  | Description                           |
| -------------- | --------------------- | ------------------------------------- |
| **Web Widget** | No                    | Built-in chat widget for your website |
| **Phone**      | VoIP integration      | Inbound/outbound voice calls and SMS  |
| **Telegram**   | Telegram integration  | Bot messages in Telegram              |
| **WhatsApp**   | WhatsApp integration  | WhatsApp Business messages            |
| **Instagram**  | Instagram integration | Instagram Direct Messages             |

To set up a channel, go to the agent's **Channels** tab, select the channel type, and choose which integration to use.

## Webhook Security

All inbound webhook endpoints (VoIP calls, messenger messages) are protected with:

* **Signature validation** — cryptographic verification of request authenticity per provider
* **Idempotency** — duplicate webhook detection to prevent double-processing
* **Rate limiting** — 120 requests per minute per channel
* **IP allowlisting** — where supported by provider (e.g., Binotel)

## All Integrations

| Integration        | Category     | Auth         | Tools                                            |
| ------------------ | ------------ | ------------ | ------------------------------------------------ |
| Twilio             | Telephony    | API Key      | 3 tools — calls, SMS, call history               |
| Ringostat          | Telephony    | API Key      | 2 tools — calls, call history                    |
| Binotel            | Telephony    | API Key      | 2 tools — calls, call history                    |
| Telegram           | Messenger    | Bot Token    | 6 tools — messages, files, history, edit, delete |
| WhatsApp Business  | Messenger    | Meta OAuth   | 6 tools — messages, templates, media, history    |
| Instagram DM       | Messenger    | Meta OAuth   | 6 tools — messages, media, history, comments     |
| Facebook Messenger | Messenger    | Meta OAuth   | 6 tools — messages, templates, media, buttons    |
| Gmail              | Productivity | Google OAuth | 6 tools — send, read, search, reply, drafts      |
| Google Docs        | Productivity | Google OAuth | 5 tools — create, read, append, search, export   |
| Google Sheets      | Productivity | Google OAuth | 7 tools — read, write, append, search, create    |
| Google Drive       | Productivity | Google OAuth | 8 tools — list, search, upload, share, folders   |
| Google Calendar    | Productivity | Google OAuth | 6 tools — events, availability, free slots       |
| Google Meet        | Productivity | Google OAuth | 1 tool — create meeting link                     |
| Google Ads         | Advertising  | Google OAuth | 3 tools — campaigns, keywords, pause             |
| Facebook Ads       | Advertising  | Meta OAuth   | 4 tools — campaigns, ad sets, insights, pause    |
| Custom Webhook     | CRM          | URL          | 2 tools — send payload, test connection          |

**Total: 67 agent tools** across 16 integrations.

## Next Steps

<CardGroup cols={2}>
  <Card title="VoIP Setup" icon="phone" href="/integrations/voip">
    Connect Twilio, Ringostat, or Binotel for AI phone calls
  </Card>

  <Card title="Messenger Setup" icon="comments" href="/integrations/messengers">
    Connect Telegram, WhatsApp, Instagram, or Facebook
  </Card>

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

  <Card title="Advertising" icon="chart-line" href="/integrations/advertising">
    Connect Google Ads or Facebook Ads
  </Card>
</CardGroup>