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

# 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

<Steps>
  <Step title="Crear un Bot">
    Abra [@BotFather](https://t.me/BotFather) en Telegram, envíe `/newbot` y siga las instrucciones. Recibirá un **token de bot** como `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`.
  </Step>

  <Step title="Agregar Integración">
    Vaya a **Integraciones** → **Agregar Integración** → seleccione **Telegram** de la categoría Mensajeros.
  </Step>

  <Step title="Ingresar Token">
    Elija una empresa, nombre la integración y pegue su token de bot.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<Steps>
  <Step title="Configuración Meta Business">
    Cree una [Cuenta Meta Business](https://business.facebook.com/) y configure el acceso a la API de WhatsApp Business.
  </Step>

  <Step title="Agregar Integración">
    Vaya a **Integraciones** → **Agregar Integración** → seleccione **WhatsApp Business**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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).
  </Step>
</Steps>

<Note>
  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.
</Note>

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

<Steps>
  <Step title="Conectar Página de Facebook">
    Su cuenta de Instagram Business debe estar vinculada a una Página de Facebook.
  </Step>

  <Step title="Agregar Integración">
    Vaya a **Integraciones** → **Agregar Integración** → seleccione **Instagram**.
  </Step>

  <Step title="OAuth">
    Haga clic en "Conectar con Meta" y autorice el acceso a su cuenta de Instagram.
  </Step>

  <Step title="Configurar">
    Ingrese su App Secret y Verify Token.
  </Step>
</Steps>

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

<Steps>
  <Step title="Página de Facebook">
    Necesita una Página de Facebook vinculada a su Cuenta Meta Business.
  </Step>

  <Step title="Agregar Integración">
    Vaya a **Integraciones** → **Agregar Integración** → seleccione **Facebook Messenger**.
  </Step>

  <Step title="OAuth">
    Haga clic en "Conectar con Meta" y autorice el acceso a su Página.
  </Step>

  <Step title="Configurar">
    Ingrese su App Secret y Verify Token.
  </Step>
</Steps>

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

<Steps>
  <Step title="Mensaje Entrante">
    La plataforma de mensajería envía un webhook a Revol con el contenido del mensaje y la información del remitente.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Tip>
  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.
</Tip>

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