Cómo conectarte a la API y al servidor MCP de WACRM

La Core API de WACRM (api.wacrm.ai/v1) es la misma API que documenta en detalle el portal para desarrolladores, y wacrm-mcp es un pequeño servidor que envuelve cinco de sus llamadas como herramientas para un agente de IA compatible con MCP. La Core API funciona hoy; wacrm-mcp todavía no se distribuye como paquete instalable, y aun cuando lo haga, hay un límite real que conviene conocer antes de empezar: la pantalla de creación de keys de Workspace solo ofrece su lista de scopes original, así que varios de los scopes más nuevos, propios de WACRM — incluyendo cada scope que necesitan las propias herramientas de wacrm-mcp — todavía no se pueden seleccionar ahí. Este tutorial se limita a las llamadas que realmente funcionan con una key creada hoy, y dice con claridad dónde se detiene el resto por ahora.

Qué necesitas antes de empezar

• Una cuenta de WACRM Workspace con al menos un proyecto (acceso anticipado — consulta precios si todavía no tienes uno).
• curl, o cualquier cliente HTTP que pueda fijar un header — nada más que instalar para la parte de la API.

Crea una API key y haz tu primera llamada

1. Crea una API key. En Workspace, abre Developer / API & MCP y crea una nueva key. Elige Secret key (sk_live_…) — server-side para un servidor o script, o Publishable key (pk_live_…) — browser-safe si la key va a viajar en código de navegador, y ponle una etiqueta que reconozcas después. Deja “Restrict what this key can do (advanced)” desactivado por ahora — sus scopes por defecto ya cubren las dos llamadas de abajo. La nueva key se muestra exactamente una vez, en un diálogo “Your new API key” justo después de crearla, que advierte que WACRM la guarda con hash y no puede reenviártela ni recuperarla — cópiala de inmediato. Esa misma pantalla Developer también muestra una tarjeta de MCP marcada “Preview” — no es un conector funcional todavía, solo un adelanto de lo que viene una vez que wacrm-mcp se publique; más abajo, “Conecta el servidor MCP” explica qué esperar.

   El portal para desarrolladores documenta la misma Core API que llama esta key — autenticación, scopes, idempotencia y la referencia completa de endpoints:

   

2. Llama al health check — sin necesitar una key. GET /v1/health es público: es la forma más rápida de confirmar que puedes llegar a la API antes de preocuparte por la autenticación.

   Code Copy

   curl -s https://api.wacrm.ai/v1/health

   Code Copy

   {"status":"ok","version":"1.0.0","database":"ok"}

   

3. Haz tu primera llamada autenticada. Toda solicitud autenticada envía la key como header Authorization: Bearer. GET /v1/message-templates lista las plantillas de mensajes de WhatsApp de tu proyecto y solo necesita templates:read, que está activo por defecto tanto para una Secret key como para una Publishable key — así que la key del paso 1 ya funciona aquí sin pedir ningún scope extra.

   Code Copy

   curl -s https://api.wacrm.ai/v1/message-templates \
     -H "Authorization: Bearer sk_live_your_scoped_key"

   Code Copy

   {
     "data": [
       {
         "id": "7e9b9b7a-2f3a-4e36-9a0d-6a2b7a9b7a01",
         "name": "order_confirmation",
         "language": "en",
         "category": "utility",
         "body": "Hi {{1}}, your order #{{2}} is confirmed.",
         "status": "approved",
         "created_at": "2026-10-20T09:00:00+00:00",
         "variant_group_id": null
       }
     ]
   }

¿Qué llamadas a la API de WACRM puedo hacer hoy?

Una ruta v1 de WACRM verifica el scope requerido en cada solicitud, y la pantalla de creación de keys de Workspace todavía no ofrece varios scopes — así que la respuesta honesta depende del endpoint, no de tu plan:

Límites de tasa y reintentos

Hoy hay dos límites documentados: los endpoints de IA (/v1/ai/*) tienen límite de tasa, y POST /v1/messages está limitado a 30 solicitudes por minuto por key — ambos responden 429 al superarse. Una escritura que nunca debería ejecutarse dos veces, como POST /v1/messages, también acepta un header Idempotency-Key: reintentar la misma solicitud con la misma key repite la primera respuesta en lugar de volver a enviar, que es la forma segura de reintentar después de un timeout o una conexión caída.

Conecta el servidor MCP a un agente de IA

wacrm-mcp todavía no es algo que un cliente de WACRM pueda instalar hoy. El paquete vive solo dentro del repositorio privado de WACRM — no hay paquete de npm ni repositorio público de GitHub al que apuntar — y hay un lanzamiento público planeado, sin fecha definida todavía. Lo que sigue es la forma que usará tu cliente MCP una vez que wacrm-mcp se publique, no un conector que puedas ejecutar ahora mismo.

Apunta tu cliente MCP hacia el servidor por stdio, con tu propia key con scopes en el entorno — la misma forma de key del paso 1 de arriba:

{
  "mcpServers": {
    "wacrm": {
      "command": "node",
      "args": ["/path/to/apps/mcp/src/index.mjs"],
      "env": {
        "WACRM_API_KEY": "sk_live_your_scoped_key",
        "WACRM_API_BASE": "https://api.wacrm.ai"
      }
    }
  }
}

WACRM_API_KEY es la única variable que necesita wacrm-mcp — la misma key con scopes del paso 1, enviada solo como header Authorization: Bearer y nunca registrada en logs ni devuelta en el resultado de una herramienta. WACRM_API_BASE tiene como valor por defecto https://api.wacrm.ai y solo hace falta cambiarla para apuntar a un sandbox o una simulación local. Una key de cuenta (sk_acc_live_...) también necesita WACRM_PROJECT_ID, enviada como X-WACRM-Project-Id; una key de proyecto (sk_live_...) ya implica su proyecto y no la necesita.

Una vez en marcha, una llamada tools/list devolverá las cinco herramientas — send_template, read_conversation, create_contact, notify_order y wallet_balance — descritas en detalle en la página de wacrm-mcp.

¿Listo para probar esto en tu propio proyecto? Solicita acceso anticipado para obtener un Workspace, o revisa precios primero si todavía estás comparando planes. Para más guías como esta, explora la lista completa de guías.