ENLAZÁ · WHATSAPP BUSINESS CON IA
Desarrolladores · MCP
WhatsApp Business por MCP. Directo a tu agente.
Usá el servidor MCP remoto de Enlazá para darle a tu agente herramientas de WhatsApp Business. Un endpoint HTTPS, autenticación por usuario y capacidades de lectura, envío y eventos según los permisos concedidos.
MCP significa Model Context Protocol: una interfaz para que el cliente descubra y ejecute herramientas. Enlazá aloja la conexión; no necesitás instalar un puente local, Docker ni un paquete npm para añadir este endpoint. Tu aplicación sigue a cargo del comportamiento del agente.
La conexión, en concreto
Server URL: https://enlaza.chat/mcp
Transport: Remote HTTPS · HTTP POST
Authentication: OAuth + PKCE S256
Alternative: personal Bearer token
Read: whatsapp:read
Send: whatsapp:send
Events: whatsapp:events + whatsapp:readEl cliente descubre las herramientas disponibles después de autorizar. Los permisos pueden cambiar qué herramientas aparecen.
Tres formas de empezar
Del chat a algo útil.
Ejemplos ilustrativos para probar con conversaciones que autorizaste. No representan resultados de clientes.
Un asistente que recupera contexto
Construí una lectura acotada de conversaciones para resumir decisiones sin mezclar números ni asumir un historial completo.
Qué obtenés: Contexto paginado por número. Seguí el cursor si la tarea necesita más resultados y verificá la disponibilidad del historial.
Descubrí las herramientas y consultá whatsapp_accounts. Con el id completo del número autorizado, leé una página de whatsapp_messages y proponé tres acciones.
Un flujo que entiende medios
Los mensajes incluyen contexto de replies y reacciones. Pedí el medio cuando necesites contenido visual; las transcripciones disponibles llegan como texto.
Qué obtenés: Un agente que distingue texto, transcripción y contenido visual real. La visualización depende del host.
Leé el mensaje solicitado. Si es una foto, usá whatsapp_media. Si es un audio compatible, revisá su transcripción disponible antes de pedir otra operación.
Un envío verificable
Separá preparación, autorización, aceptación y entrega. Guardá el identificador de operación para resolver resultados inciertos.
Qué obtenés: Un flujo con reintentos idempotentes y estados explícitos, sujeto a permisos y reglas de mensajería.
Para este destinatario y contenido autorizados, usá la herramienta de envío disponible. Conservá request_id y consultá whatsapp_message_status antes de afirmar entrega.
De la idea al primer uso
- Configurá el endpoint remoto en tu cliente MCP. Usá OAuth si está disponible: PKCE S256, descubrimiento de metadatos y registro dinámico.
- Elegí scopes mínimos: whatsapp:read, whatsapp:send cuando corresponda, y whatsapp:events junto con read para eventos. Los tokens personales son una alternativa para clientes con almacenamiento seguro.
- Inicializá y descubrí el catálogo real. Verificá whatsapp_accounts y whatsapp_connection_check; después ejecutá la tarea autorizada. No supongas herramientas por el nombre del producto.
Elegí el flujo que necesitás
Elegí MCP cuando tu aplicación ya entiende herramientas y autorización por usuario. Si buscás un motor de campañas, un contact center o un orquestador, evaluá esas piezas aparte. Para decidir cuál es el mejor MCP para tu proyecto, comprobá lectura real, medios, aislamiento de cuentas, reintentos y soporte de eventos en tu cliente.
Preguntas frecuentes
¿Cómo se implementan los avisos?
El cliente necesita soportar MCP Events, además de herramientas normales. Comprobá suscripción y permisos con whatsapp_notifications_status. Una conexión de herramientas no equivale a una suscripción activa; conservá checkpoints y deduplicá eventos al recuperar actividad.
¿Cuáles son los límites de escritura?
Texto e imágenes requieren ventana de 24 horas desde una entrada real del destinatario. Plantillas: deben estar aprobadas, ser aptas y contar con opt-in y autorización. Marcar leído requiere permiso de escritura. Leer reacciones no implica poder enviarlas.
¿Dónde está el contrato completo?
En /agents.md: descubrimiento, OAuth, tokens, herramientas, medios, paginación y recuperación. No pongas tokens en URLs ni en el chat; usá el campo seguro del cliente. El asistente respeta las aprobaciones de su host.