Integraciones de Mensajeros

Conecte Telegram, WhatsApp, Instagram y Facebook Messenger

​

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

1. Crear un Bot

   Abra @BotFather en Telegram, envíe /newbot y siga las instrucciones. Recibirá un token de bot como 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.

2. Agregar Integración

   Vaya a Integraciones → Agregar Integración → seleccione Telegram de la categoría Mensajeros.

3. Ingresar Token

   Elija una empresa, nombre la integración y pegue su token de bot.

4. Verificar y Guardar

   Revol llama a la API de Bot de Telegram para verificar el token y configura automáticamente el webhook. Su bot comienza a recibir mensajes inmediatamente.

​

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

1. Configuración Meta Business

   Cree una Cuenta Meta Business y configure el acceso a la API de WhatsApp Business.

2. Agregar Integración

   Vaya a Integraciones → Agregar Integración → seleccione WhatsApp Business.

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

4. Configurar

   Ingrese su Phone Number ID y App Secret. Revol intercambia el código OAuth por un token de larga duración (~60 días).

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

1. Conectar Página de Facebook

   Su cuenta de Instagram Business debe estar vinculada a una Página de Facebook.

2. Agregar Integración

   Vaya a Integraciones → Agregar Integración → seleccione Instagram.

3. OAuth

   Haga clic en “Conectar con Meta” y autorice el acceso a su cuenta de Instagram.

4. Configurar

   Ingrese su App Secret y Verify Token.

​

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

1. Página de Facebook

   Necesita una Página de Facebook vinculada a su Cuenta Meta Business.

2. Agregar Integración

   Vaya a Integraciones → Agregar Integración → seleccione Facebook Messenger.

3. OAuth

   Haga clic en “Conectar con Meta” y autorice el acceso a su Página.

4. Configurar

   Ingrese su App Secret y Verify Token.

​

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:

1. Mensaje Entrante

   La plataforma de mensajería envía un webhook a Revol con el contenido del mensaje y la información del remitente.

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

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

4. Respuesta Saliente

   La respuesta del agente se envía de vuelta a través de la API del mismo mensajero. El usuario ve la respuesta en su chat.

Los mensajes de mensajeros se procesan asincrónicamente mediante un trabajo en segundo plano. Esto asegura que el webhook devuelva una respuesta 200 rápida, previniendo timeouts y reintentos de la plataforma de mensajería.

​

Uso de Herramientas en Nodos del Workflow

Las herramientas de mensajeros funcionan como cualquier otra herramienta del agente:

1. Conecte la integración y verifique las credenciales
2. En la pestaña Herramientas del agente, verá las herramientas provisionadas
3. Agregue herramientas a los nodos personalizados en el editor de workflow
4. El LLM decide cuándo usarlas basándose en el contexto de la conversación

Ejemplo: Un cliente pregunta “Envíeme el folleto por WhatsApp”. El agente usa 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)
WhatsApp	Firma HMAC-SHA256 (encabezado X-Hub-Signature-256 con app_secret)
Instagram	Firma HMAC-SHA256 (encabezado X-Hub-Signature-256 con app_secret)
Facebook	Firma HMAC-SHA256 (encabezado X-Hub-Signature-256 con app_secret)

Todos los webhooks de mensajeros tienen un límite de 120 solicitudes por minuto por canal.