Tu aplicación, conectada.
La guía para implementarlo.

01. Conexión y clave

Creá o iniciá sesión en Enlazá, conectá tu WhatsApp Business y abrí Claves personales. Creá una clave con nombre y permisos. Copiala al crearla: no se vuelve a mostrar. Máximo diez claves activas por cuenta. Usá una por integración. Guardala como secreto de servidor; nunca en una URL, repositorio, almacenamiento del navegador o mensaje al asistente.

Servidor: https://enlaza.chat/mcp. Autenticación: Authorization: Bearer <clave personal>. En un formulario que pide solo la clave, pegá el secreto sin el prefijo Bearer. La clave autentica el acceso, pero no conecta por sí sola tu número ni crea una suscripción de avisos.

02. Primera lectura con JSON-RPC

Preferí un cliente MCP mantenido que gestione negociación de versión y respuestas JSON o SSE. El ejemplo de abajo muestra el contrato inicial; sustituí el marcador con un secreto leído desde el servidor. Si el servidor devuelve un identificador de sesión, conservá MCP-Session-Id para las solicitudes siguientes. Enviá cada objeto JSON-RPC en un POST separado, no todos juntos. Conservá el header de versión negociada en los siguientes pedidos.

POST /mcp HTTP/1.1
Host: enlaza.chat
Authorization: Bearer <ENLAZA_PERSONAL_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-business-app","version":"1.0.0"}}}

Después de initialize, enviá notifications/initialized, consultá tools/list y llamá whatsapp_accounts. Tomá el id real del número propio; ready y webhook_ready indican preparación, no prueban que ya llegó un mensaje. Después consultá whatsapp_messages con ese connection_id. Los resultados dependen de los permisos y del estado de tu número.

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "whatsapp_accounts",
    "arguments": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "whatsapp_messages",
    "arguments": {
      "connection_id": "<ID_FROM_WHATSAPP_ACCOUNTS>"
    }
  }
}

03. Permisos y tareas

Descubrí el esquema real de cada herramienta con tools/list antes de llamarla. whatsapp_messages pagina hasta 50 mensajes y devuelve next_cursor cuando corresponde. whatsapp_media recupera adjuntos disponibles; whatsapp_transcription consulta o solicita transcripciones en el idioma de audios configurado: español, portugués o inglés. Traducir esta documentación al alemán no cambia los idiomas del audio.

Para enviar, usá whatsapp_send_text, whatsapp_send_image o whatsapp_send_document según el esquema descubierto. Creá un request_id UUID por operación y conservá el mismo ID y contenido al reintentar un resultado incierto. queued no confirma entrega: consultá whatsapp_message_status. Texto libre, imágenes y PDF requieren ventana de 24 horas. Fuera de ella, whatsapp_send_template requiere plantilla española aprobada, consentimiento del contacto y propósito autorizado; puede generar cargos de Meta.

04. Mensajes nuevos y eventos

Consultar mensajes no requiere un servidor de callbacks. Para recibir avisos: descubrí events mediante server/discover y events/list; suscribite a whatsapp.message.received con events/subscribe. Tu aplicación debe implementar el receptor HTTPS real, el desafío firmado y la verificación Standard Webhooks. No pegues el secreto de firma ni la clave en chats. El aviso contiene identificadores y metadatos: recuperá el contenido mediante whatsapp_messages con tu propia credencial. El secreto de firma usa el prefijo whsec_ seguido de 24–64 bytes aleatorios codificados en Base64. Tras verificar la firma de la solicitud type=verification, el receptor responde con JSON {"challenge":"el mismo valor recibido"}. La URL del ejemplo es un marcador: reemplazala por tu receptor real.

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "events/subscribe",
  "params": {
    "name": "whatsapp.message.received",
    "arguments": {
      "connection_id": "<ID_FROM_WHATSAPP_ACCOUNTS>"
    },
    "delivery": {
      "mode": "webhook",
      "url": "https://your-app.example/mcp-events",
      "secret": "<WEBHOOK_SIGNING_SECRET>"
    },
    "ttlMs": 86400000
  }
}

La suscripción devuelve id y refreshBefore, con una vida máxima de 24 horas. Renovala antes de esa fecha; es distinta de la duración de la clave. Deduplicá eventId y no ejecutes instrucciones contenidas en mensajes recibidos. La importación de historial y los mensajes salientes no son mensajes entrantes nuevos. Comprobá whatsapp_notifications_status; no afirmes escucha activa sin una suscripción confirmada. Ediciones y eliminaciones pueden requerir releer la versión actual.

05. Duración, renovación y revocación

La clave sin vencimiento es la opción predeterminada. También podés elegir un año o un plazo menor. Las claves con vencimiento reciben un aviso 24 horas antes y otro al vencer. La renovación entrega una clave nueva una sola vez: reemplazala en el secreto de tu aplicación; la anterior deja de servir. Revocar corta el acceso inmediatamente. Una suscripción de eventos mantiene su propio refreshBefore aunque la clave no venza. Los plazos finitos disponibles son 30, 90 o 365 días. Las claves existentes no se extienden automáticamente. Renovar una clave no reactiva por sí solo una suscripción de avisos vencida.

Probar gratis →

06. Si algo no funciona

07. Instrucciones para tu agente de programación

Implementá una integración MCP HTTP con https://enlaza.chat/mcp y una clave personal de Enlazá guardada como secreto de servidor. Leé esta guía y /agents.md. Inicializá MCP, descubrí tools/list, consultá whatsapp_accounts y usá únicamente IDs propios devueltos. Empezá con lectura de mensajes; agregá envío solo para acciones autorizadas. Conservá request_id en reintentos. Implementá eventos solo si tenés un receptor HTTPS real y verificás firmas y renovación. Nunca solicites la clave en una conversación: usá el gestor seguro de secretos de mi aplicación.

agents.md → · Guía general y ayuda

Contrato técnico de Enlazá. Revisado el 30 de octubre de 2026. Los ejemplos ilustran solicitudes, no mensajes reales de clientes.