Como deployar un agente en WhatsApp, Telegram y Slack sin mezclar canales

La forma más común de romper un agente multicanal es mezclar todo desde el inicio: un solo webhook, una sola memoria, un solo prompt y reglas iguales para WhatsApp, Telegram y Slack. Funciona en la demo. Falla cuando llegan usuarios reales.

Cada canal tiene expectativas distintas. WhatsApp es personal y sensible. Telegram es flexible y rapido para comunidades. Slack vive dentro del trabajo y necesita integrarse con permisos, threads y contexto de equipo.

Arquitectura base

Usa adaptadores por canal. El nucleo del agente no deberia saber si el mensaje vino de WhatsApp, Telegram o Slack. Deberia recibir un evento normalizado:

type AgentEvent = {
 channel: "whatsapp" | "telegram" | "slack";
 conversationId: string;
 userId: string;
 text: string;
 attachments: Array<{ type: string; url: string }>;
 receivedAt: string;
};

Cada adaptador se encarga de traducir el formato propio del canal hacia ese evento. Luego el agente procesa el evento, llama herramientas y devuelve una respuesta normalizada. El adaptador vuelve a convertir esa respuesta al formato del canal.

Memoria separada por canal

No uses una memoria global por usuario si no estas seguro de identidad. Un número de WhatsApp, un usuario de Telegram y un usuario de Slack pueden ser la misma persona o tres personas distintas.

Guarda memoria con esta clave mínima:

• channel
• workspaceId o tenantId cuando exista
• conversationId
• userId

Despues puedes unir identidades con consentimiento o login, pero no lo hagas por suposicion.

Reglas por plataforma

WhatsApp suele requerir plantillas, politicas de negocio y cuidado con ventanas de conversacion. Telegram permite más libertad técnica, pero el token del bot debe protegerse igual que una clave API. Slack requiere pensar en permisos, scopes, instalacion por workspace y experiencia dentro de threads o superficies nativas.

El mismo agente puede tener la misma intención, pero no la misma UX.

Deploy recomendado

Para una primera version sería:

1. Un endpoint por canal: /webhooks/whatsapp, /webhooks/telegram, /webhooks/slack.
2. Validacion de firma, token o secreto por canal.
3. Cola de trabajos para no bloquear el webhook.
4. Orquestador único del agente.
5. Adaptadores de salida por canal.
6. Logs con traceId para reconstruir cada conversacion.
7. Handoff humano cuando hay reclamos, pagos, datos sensibles o baja confianza.

Error a evitar

No copies el prompt de WhatsApp a Slack. En Slack, el agente debe ser más explicito con acciones, contexto y permisos. En WhatsApp, debe ser más breve y conversacional. En Telegram, puede apoyarse mejor en comandos y grupos.

Un agente multicanal no es un bot duplicado tres veces. Es un nucleo común con adaptadores serios por canal.