Mensajeros Compatibles
| Mensajero | Método de Autenticación | Entrante | Saliente | Herramientas |
|---|---|---|---|---|
| Telegram | Token de Bot | Sí | Sí | 6 |
| WhatsApp Business | Meta OAuth | Sí | Sí | 6 |
| Instagram DM | Meta OAuth | Sí | Sí | 6 |
| Facebook Messenger | Meta OAuth | Sí | Sí | 6 |
Telegram
Telegram es la integración más simple — sin OAuth, sin dependencias de SDK. Solo un token de bot de BotFather.Configuración
Crear un Bot
Abra @BotFather en Telegram, envíe
/newbot y siga las instrucciones. Recibirá un token de bot como 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.Agregar Integración
Vaya a Integraciones → Agregar Integración → seleccione Telegram de la categoría Mensajeros.
Herramientas del Agente
| Herramienta | Descripción |
|---|---|
send_message | Enviar un mensaje de texto (formato HTML o Markdown) con respuesta opcional |
send_file | Enviar una foto, documento, audio o video por URL pública |
get_chat_history | Obtener mensajes recientes de un chat |
get_chat_info | Obtener metadatos del chat/usuario (nombre, bio, cantidad de miembros) |
edit_message | Editar un mensaje previamente enviado por el bot |
delete_message | Eliminar un mensaje del chat |
WhatsApp Business
La API de WhatsApp Business se accede a través de la Graph API de Meta. Requiere una cuenta Meta Business con acceso a la API de WhatsApp Business.Configuración
Configuración Meta Business
Cree una Cuenta Meta Business y configure el acceso a la API de WhatsApp Business.
OAuth
Haga clic en “Conectar con Meta” — será redirigido a la pantalla de consentimiento de Meta. Autorice el acceso a su cuenta de WhatsApp Business.
WhatsApp tiene una ventana de mensajería de 24 horas. Puede enviar mensajes de forma libre solo dentro de las 24 horas del último mensaje del cliente. Fuera de esta ventana, use
send_template_message con plantillas pre-aprobadas.Herramientas del Agente
| Herramienta | Descripción |
|---|---|
send_message | Enviar un mensaje de texto dentro de la ventana de 24 horas |
send_template_message | Enviar una plantilla pre-aprobada (funciona fuera de la ventana de 24h) |
send_media | Enviar una imagen, documento, video o audio por URL |
get_message_history | Obtener mensajes de la conversación |
get_contact_info | Obtener información del perfil del contacto |
mark_as_read | Enviar confirmaciones de lectura para un mensaje |
Instagram DM
Los Mensajes Directos de Instagram se acceden a través de la Graph API de Meta con el mismo flujo OAuth que WhatsApp.Configuración
Conectar Página de Facebook
Su cuenta de Instagram Business debe estar vinculada a una Página de Facebook.
Herramientas del Agente
| Herramienta | Descripción |
|---|---|
send_message | Enviar un mensaje directo a un usuario de Instagram |
send_media | Enviar un archivo adjunto multimedia en DM |
get_message_history | Obtener mensajes del hilo de DM |
get_profile | Obtener información pública del perfil de Instagram |
get_comments | Obtener comentarios de una publicación específica |
reply_to_comment | Publicar una respuesta en hilo a un comentario |
Facebook Messenger
Facebook Messenger se conecta a través de su Página de Facebook. Mismo flujo Meta OAuth que WhatsApp e Instagram.Configuración
Herramientas del Agente
| Herramienta | Descripción |
|---|---|
send_message | Enviar un mensaje de texto a un usuario de Facebook |
send_template_message | Enviar una plantilla estructurada (botones, genérica, recibo) |
send_media | Enviar una imagen, video, audio o archivo |
get_message_history | Obtener hilo de conversación |
get_profile | Obtener perfil del usuario desde ID de página |
send_buttons | Enviar opciones de respuesta rápida al usuario |
Flujo de Mensajes
Independientemente del mensajero, el flujo de procesamiento es idéntico:Mensaje Entrante
La plataforma de mensajería envía un webhook a Revol con el contenido del mensaje y la información del remitente.
Enrutar al Agente
Revol identifica el canal, encuentra el agente de IA asignado y crea o continúa una sesión de conversación. El mismo remitente siempre obtiene el mismo hilo de conversación.
Procesamiento IA
El mensaje se procesa a través del workflow del agente — nodos LLM, consulta a base de conocimientos RAG, llamadas a herramientas y condiciones.
Uso de Herramientas en Nodos del Workflow
Las herramientas de mensajeros funcionan como cualquier otra herramienta del agente:- Conecte la integración y verifique las credenciales
- En la pestaña Herramientas del agente, verá las herramientas provisionadas
- Agregue herramientas a los nodos personalizados en el editor de workflow
- El LLM decide cuándo usarlas basándose en el contexto de la conversación
send_media para enviar un documento PDF, luego confirma la entrega en el chat.
Seguridad de Webhooks
| Mensajero | Validación |
|---|---|
| Telegram | Token secreto en la URL del webhook (hash SHA-256 del token del bot) |
Firma HMAC-SHA256 (encabezado X-Hub-Signature-256 con app_secret) | |
Firma HMAC-SHA256 (encabezado X-Hub-Signature-256 con app_secret) | |
Firma HMAC-SHA256 (encabezado X-Hub-Signature-256 con app_secret) |