Mensajería (WhatsApp, Messenger, Telegram, Mattermost)

betool integra las plataformas de mensajería más solicitadas. Cada una sigue el mismo modelo: un módulo *_inbound para la recepción y un módulo *_outbound para el envío.

WhatsApp Business

Requisitos previos

• Cuenta de Meta Business.
• Número de WhatsApp Business aprobado.
• Aplicación de Cloud API configurada con un webhook.

Configuración

1. Ajustes → Servicios → WhatsApp, pestaña Cuentas — conecta tu aplicación de Meta con su App Secret y Phone Number ID.
2. En el lado de Meta, añade la URL del webhook proporcionada por betool (https://platform.betool.ai/entries/whatsapp/<id>) y copia el Verify Token generado.
3. Asigna el número a un pipeline.

Particularidades

• Las plantillas aprobadas son obligatorias para iniciar una conversación (fuera de la ventana de 24 horas). Gestionas las plantillas en el lado de Meta; betool las referencia por su nombre.
• Multimedia compatible: imágenes, audio, vídeo, documentos. Los documentos PDF y Excel pueden procesarse después con el nodo file_transform.

WhatsApp vía Green API (Beta)

Para un número de WhatsApp sin cuenta Meta Business, betool también se conecta a Green API (tu propia instancia, BYO): el receptor greenapi_inbound dispara un pipeline con cada mensaje recibido (multimedia copiada en betool) y el nodo greenapi_outbound envía un texto o un archivo con leyenda. betool instala él mismo el webhook en Green API.

• No es la API oficial de WhatsApp: Green API emula WhatsApp Web. WhatsApp puede bloquear el número, sin recurso. Para un uso con clientes a gran volumen, prefiere la Cloud API anterior.
• Sin plantillas ni ventana de 24 horas; los grupos son accesibles.
• Un envío correcto demuestra que el mensaje está en cola, no que se haya entregado.
• El envío pasa únicamente por el nodo (exactly-once): ningún tool permite a un agente enviar por sí solo.

Messenger

El receptor messenger_inbound dispara un pipeline con cada mensaje recibido en tu Página de Facebook; el nodo messenger_outbound responde. Las respuestas libres solo son posibles en las 24 horas siguientes al último mensaje del usuario (regla de Meta). Detalles y conexión: Meta.

Telegram

Requisitos previos

Un bot creado vía @BotFather (token de API).

Configuración

1. Ajustes → Servicios → Telegram, pestaña Cuentas — pega el token; betool configura el webhook automáticamente.
2. Asigna el bot a un pipeline.

Particularidades

• El bot se puede añadir a grupos o usarse en conversaciones privadas.
• Sin cuotas restrictivas como WhatsApp — ideal para asistentes internos o notificaciones operativas.

Mattermost

Requisitos previos

• Una instancia de Mattermost (cloud o autoalojada).
• Un webhook saliente en el lado de Mattermost.

Configuración

1. Ajustes → Servicios → Mattermost, pestaña Cuentas — crea la conexión y copia la URL proporcionada por betool.
2. En el lado de Mattermost, crea un webhook saliente que apunte a esa URL.
3. Opcional: crea un webhook entrante en Mattermost para permitir que betool publique respuestas.

Particularidades

• Hilos preservados — las respuestas del agente permanecen en el hilo de la pregunta original.
• Canales privados / DMs — elige el alcance durante la configuración.

Elegir