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

# Descripción General de Integraciones

> Conecte agentes de IA a canales de comunicación, herramientas de productividad y plataformas publicitarias

<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="Descripción general de integraciones" 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="Descripción general de integraciones" width="2873" height="1549" data-path="images/integrations-overview-dark.png" />
</Frame>

## ¿Qué Son las Integraciones?

Las integraciones conectan sus agentes de IA a servicios externos — para que puedan contestar llamadas telefónicas, responder en mensajeros, enviar correos electrónicos, crear documentos y obtener datos de analíticas. Cada integración le da a su agente un conjunto de **herramientas** que puede invocar durante las conversaciones.

## Integraciones Disponibles

<CardGroup cols={2}>
  <Card title="Telefonía" icon="phone" href="/integrations/voip">
    Twilio, Ringostat, Binotel — llamadas telefónicas y SMS potenciados por IA
  </Card>

  <Card title="Mensajeros" 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="Campañas Publicitarias" icon="chart-line" href="/integrations/advertising">
    Google Ads, Facebook Ads — analíticas y gestión de campañas
  </Card>

  <Card title="Webhook Personalizado" icon="webhook" href="/integrations/webhook">
    Envíe datos de leads a cualquier CRM o sistema externo
  </Card>
</CardGroup>

## Cómo Funciona

Cada integración sigue el mismo patrón:

<Steps>
  <Step title="Conectar">
    Agregue una integración desde la página de Integraciones. Dependiendo del proveedor, ingrese credenciales API (VoIP, Telegram) o pase por OAuth (Google, Meta).
  </Step>

  <Step title="Verificar">
    Revol prueba sus credenciales contra la API del proveedor y obtiene los recursos disponibles (números de teléfono, información del bot, cuentas conectadas).
  </Step>

  <Step title="Provisionar Herramientas">
    Después de la verificación, Revol crea automáticamente **herramientas del agente** basadas en el tipo de integración. Por ejemplo, conectar Gmail le da a sus agentes `send_email`, `read_inbox`, `search_emails` y otras herramientas.
  </Step>

  <Step title="Asignar al Agente">
    En la pestaña **Herramientas** del agente, habilite las herramientas que necesita. Luego agréguelas a los nodos del workflow — el agente puede invocar estas herramientas durante conversaciones mediante llamada de funciones del LLM.
  </Step>
</Steps>

## Métodos de Autenticación

| Método                | Usado por                                              | Cómo funciona                                                                                                                                                           |
| --------------------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Clave API / Token** | Twilio, Ringostat, Binotel, Telegram                   | Ingrese credenciales en el asistente. Se almacenan cifradas en la base de datos.                                                                                        |
| **Google OAuth 2.0**  | Gmail, Docs, Sheets, Drive, Calendar, Meet, Google Ads | Haga clic en "Conectar con Google", autorice en la pantalla de consentimiento. Revol almacena un token de actualización y renueva automáticamente los tokens de acceso. |
| **Meta OAuth**        | WhatsApp, Instagram, Facebook Messenger, Facebook Ads  | Haga clic en "Conectar con Meta", autorice vía Meta. Revol intercambia el código por un token de larga duración (\~60 días).                                            |
| **URL de Webhook**    | Webhook Personalizado                                  | No se necesita autenticación — usted proporciona la URL destino y encabezados opcionales.                                                                               |

## Canales

Un **canal** es la conexión entre una integración y un agente de IA específico. Una integración (por ejemplo, su cuenta de Twilio) puede servir a múltiples agentes a través de canales separados.

Tipos de canales disponibles:

| Canal          | Requiere Integración  | Descripción                                |
| -------------- | --------------------- | ------------------------------------------ |
| **Widget Web** | No                    | Widget de chat integrado para su sitio web |
| **Teléfono**   | Integración VoIP      | Llamadas de voz entrantes/salientes y SMS  |
| **Telegram**   | Integración Telegram  | Mensajes de bot en Telegram                |
| **WhatsApp**   | Integración WhatsApp  | Mensajes de WhatsApp Business              |
| **Instagram**  | Integración Instagram | Mensajes Directos de Instagram             |

Para configurar un canal, vaya a la pestaña **Canales** del agente, seleccione el tipo de canal y elija qué integración usar.

## Seguridad de Webhooks

Todos los endpoints de webhook entrantes (llamadas VoIP, mensajes de mensajeros) están protegidos con:

* **Validación de firma** — verificación criptográfica de la autenticidad de la solicitud por proveedor
* **Idempotencia** — detección de webhooks duplicados para prevenir procesamiento doble
* **Limitación de velocidad** — 120 solicitudes por minuto por canal
* **Lista de IPs permitidas** — donde lo soporte el proveedor (por ejemplo, Binotel)

## Todas las Integraciones

| Integración           | Categoría     | Autenticación | Herramientas                                                       |
| --------------------- | ------------- | ------------- | ------------------------------------------------------------------ |
| Twilio                | Telefonía     | Clave API     | 3 herramientas — llamadas, SMS, historial de llamadas              |
| Ringostat             | Telefonía     | Clave API     | 2 herramientas — llamadas, historial de llamadas                   |
| Binotel               | Telefonía     | Clave API     | 2 herramientas — llamadas, historial de llamadas                   |
| Telegram              | Mensajero     | Token de Bot  | 6 herramientas — mensajes, archivos, historial, editar, eliminar   |
| WhatsApp Business     | Mensajero     | Meta OAuth    | 6 herramientas — mensajes, plantillas, multimedia, historial       |
| Instagram DM          | Mensajero     | Meta OAuth    | 6 herramientas — mensajes, multimedia, historial, comentarios      |
| Facebook Messenger    | Mensajero     | Meta OAuth    | 6 herramientas — mensajes, plantillas, multimedia, botones         |
| Gmail                 | Productividad | Google OAuth  | 6 herramientas — enviar, leer, buscar, responder, borradores       |
| Google Docs           | Productividad | Google OAuth  | 5 herramientas — crear, leer, agregar, buscar, exportar            |
| Google Sheets         | Productividad | Google OAuth  | 7 herramientas — leer, escribir, agregar, buscar, crear            |
| Google Drive          | Productividad | Google OAuth  | 8 herramientas — listar, buscar, subir, compartir, carpetas        |
| Google Calendar       | Productividad | Google OAuth  | 6 herramientas — eventos, disponibilidad, horarios libres          |
| Google Meet           | Productividad | Google OAuth  | 1 herramienta — crear enlace de reunión                            |
| Google Ads            | Publicidad    | Google OAuth  | 3 herramientas — campañas, palabras clave, pausar                  |
| Facebook Ads          | Publicidad    | Meta OAuth    | 4 herramientas — campañas, conjuntos de anuncios, insights, pausar |
| Webhook Personalizado | CRM           | URL           | 2 herramientas — enviar payload, probar conexión                   |

**Total: 67 herramientas de agente** en 16 integraciones.

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Configuración VoIP" icon="phone" href="/integrations/voip">
    Conecte Twilio, Ringostat o Binotel para llamadas telefónicas con IA
  </Card>

  <Card title="Configuración de Mensajeros" icon="comments" href="/integrations/messengers">
    Conecte Telegram, WhatsApp, Instagram o Facebook
  </Card>

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

  <Card title="Publicidad" icon="chart-line" href="/integrations/advertising">
    Conecte Google Ads o Facebook Ads
  </Card>
</CardGroup>