¿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
Telefonía
Twilio, Ringostat, Binotel — llamadas telefónicas y SMS potenciados por IA
Mensajeros
Telegram, WhatsApp, Instagram DM, Facebook Messenger
Google Workspace
Gmail, Docs, Sheets, Drive, Calendar, Meet
Campañas Publicitarias
Google Ads, Facebook Ads — analíticas y gestión de campañas
Webhook Personalizado
Envíe datos de leads a cualquier CRM o sistema externo
Cómo Funciona
Cada integración sigue el mismo patrón: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).
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).
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.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 |
| Integración WhatsApp | Mensajes de WhatsApp Business | |
| Integración Instagram | Mensajes Directos de Instagram |
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 |