Un servidor MCP de WhatsApp es el puente entre un asistente de IA y tu WhatsApp CRM: el asistente pide una herramienta, el servidor hace una llamada a la API ya verificada y la respuesta vuelve al chat con el asistente. En WACRM ese puente es wacrm-mcp, parte de WACRM API & MCP, y trabaja con tu número de WhatsApp Business bajo claves que tú limitas, topas y revocas. Este playbook forma parte de las guías de WACRM para todo negocio que vende online.
¿Qué es un servidor MCP de WhatsApp?
Es un servidor MCP cuyas herramientas son acciones de un WhatsApp CRM. El Model Context Protocol, que Anthropic presentó el 25 de noviembre de 2024, es descrito por sus responsables como un estándar de código abierto para conectar aplicaciones de IA con sistemas externos. Claude, ChatGPT, Visual Studio Code y Cursor están entre los clientes que lo admiten, así que un mismo servidor funciona con muchos asistentes.
Las tres partes de una conexión MCP
La arquitectura de MCP tiene tres participantes:
- Host: la aplicación de IA donde escribes, como Claude Desktop o Cursor.
- Cliente: la pieza dentro del host que mantiene una conexión con un servidor.
- Servidor: el programa que ofrece herramientas, recursos y prompts. wacrm-mcp ofrece solo herramientas.
Los mensajes entre ellos usan JSON-RPC 2.0. Un servidor local habla con su cliente por la entrada y la salida estándar (stdio); uno remoto usa Streamable HTTP. wacrm-mcp es un servidor stdio local: funciona con Node.js 20 o superior en el equipo donde corre tu cliente de IA y llega a WACRM por HTTPS con tu API key.
Un número de empresa, no una sesión de WhatsApp Web
Muchos proyectos de “WhatsApp MCP” que encuentras en internet manejan una cuenta personal de WhatsApp a través de una sesión de WhatsApp Web. Eso es otra cosa. wacrm-mcp nunca toca una sesión del teléfono: cada herramienta llama a la Core API de WACRM, que trabaja con el número de WhatsApp Business Platform conectado a tu proyecto. Tus mensajes, contactos e inbox se quedan en el CRM que tu equipo ya usa, y cada llamada pasa por la misma verificación de scopes que cualquier otra solicitud a la API.
Note
En una línea: el modelo de IA vive en tu cliente, las reglas del negocio viven en la Core API de WACRM y wacrm-mcp solo traduce una llamada de herramienta en una llamada a la API. No tiene lógica de negocio propia.
¿Qué puede hacer un agente de IA en WACRM por MCP?
Lo mismo que hace una persona del equipo en el inbox, dentro de los scopes de su clave. Las 11 herramientas se agrupan en cinco bloques: mensajes, contactos, novedades de pedidos, la billetera y el inbox.
| Herramienta | Qué puede hacer el agente | Scope necesario |
|---|---|---|
send_template | Enviar una plantilla de WhatsApp aprobada a un cliente; un reintento con la misma Idempotency-Key nunca envía dos veces | messages:send |
read_conversation | Leer el historial de mensajes con un contacto, página por página | contacts:read |
create_contact | Crear un contacto a partir de un número de teléfono, con nombre y email opcionales | contacts:write |
notify_order | Suscribir tu propio endpoint HTTPS a los cambios de estado de los mensajes, para confirmaciones de pedido y de entrega | wa_webhooks:write |
wallet_balance | Leer el saldo de la billetera de tokens del proyecto y el consumo de este ciclo | wallet:read |
list_conversations | Listar conversaciones del inbox por estado, responsable, etiqueta, búsqueda o ventana abierta | contacts:read |
assign_conversation | Asignar hasta 20 conversaciones a una persona del equipo o a un agente de IA, o quitar el responsable | inbox:write |
add_note | Añadir una nota privada para tu equipo; nunca se envía al cliente | inbox:write |
label_conversation | Añadir o quitar etiquetas en hasta 20 conversaciones | inbox:write |
resolve_conversation | Resolver hasta 20 conversaciones; un nuevo mensaje del cliente reabre la conversación | inbox:write |
inbox_report | Leer el reporte diario del inbox por agente, equipo, canal o etiqueta, o la vista en vivo | inbox:read |
La lista de herramientas y scopes coincide con la página de wacrm-mcp, que sigue siendo la referencia si la lista cambia. El preset MCP del Workspace marca exactamente los siete scopes de la columna derecha, y puedes desmarcar cualquiera.
¿Cómo llega una llamada de herramienta a WhatsApp?
En cinco pasos cortos, con dos verificaciones antes de que pase nada. Le pides algo a tu asistente con palabras
normales, el modelo elige una herramienta y el cliente envía una solicitud tools/call a wacrm-mcp.
1 · Preguntas
”¿Qué chats siguen esperando respuesta?“
2 · El modelo elige una herramienta
list_conversationscon un filtro de estado.3 · Acción autorizada
wacrm-mcp pide a la Core API que cuente una acción contra el tope de la clave.
4 · Scope verificado
La Core API verifica el scope y el proyecto de la clave, y ejecuta la llamada.
5 · Resultado
La lista vuelve a tu asistente, o sale una plantilla desde tu número.
Dos reglas de WhatsApp definen lo que puede enviar el asistente. Meta abre una ventana de atención al cliente de 24
horas cada vez que un cliente te escribe; fuera de ella, una empresa solo puede enviar mensajes de plantilla, según
la documentación de precios de Meta. Por eso la herramienta
de envío de MCP es send_template: una plantilla aprobada vale en cualquier momento. Desde el 1 de julio de 2025
Meta cobra WhatsApp Business Platform por mensaje entregado, así que cada plantilla que envía el asistente es un
mensaje que tu empresa le paga a Meta.
Cuando una llamada falla, el asistente ve por qué. Un scope que falta vuelve como insufficient_scope, un límite del
plan agotado como plan_limit_reached, y el rate limiting también como error. Una herramienta nunca devuelve un
resultado vacío en silencio, así que el modelo no puede confundir “no permitido” con “no encontrado”.
¿Cómo mantienes al agente dentro de límites seguros?
Decidiendo, clave por clave, qué puede tocar y con qué frecuencia. Estos controles están en la Core API de WACRM y en el Workspace, no en el asistente, así que ningún prompt puede saltárselos:
- Scopes por clave. Una clave lleva solo los scopes que marcaste. Una herramienta cuyo scope falta responde
insufficient_scopeen lugar de actuar. - Un proyecto por clave. Una clave de proyecto solo llega a su propio proyecto; pedir datos de otro proyecto devuelve no encontrado.
- Un tope mensual de acciones. Pon cualquier número entero de 1 a 1.000.000, o déjalo vacío. Cada llamada de herramienta cuenta como una acción. Al llegar al tope, la lista de claves muestra “Límite alcanzado” y las siguientes llamadas se rechazan, sin cobro, hasta que subas el tope o se reinicie el mes (UTC).
- Un límite masivo de 20.
assign_conversation,label_conversationyresolve_conversationrechazan más de 20 conversaciones en una llamada conbulk_requires_approval. Las limpiezas grandes quedan en manos de una persona. - Envíos que nunca se duplican.
send_templatesiempre lleva una Idempotency-Key, así que un cliente que reintenta tras un timeout recibe la primera respuesta en lugar de escribirle dos veces al cliente. - Revocar con un clic. Revocar una clave detiene ese cliente al instante. La página Herramientas de IA (MCP) solo la ve el dueño del proyecto, y su tarjeta de uso lista las acciones recientes y si cada una se permitió o se rechazó.
Note
Mantén la clave fuera del chat. La clave se muestra una sola vez, va en la configuración del cliente como
WACRM_API_KEY y solo se envía en el header Authorization: Bearer. wacrm-mcp nunca la registra ni la repite en
un resultado de herramienta, así que nunca la pegues en un prompt.
La Business Policy de WhatsApp también pide que una empresa que automatiza respuestas ofrezca vías claras para hablar con una persona. Un asistente por MCP es una ayuda interna para tu equipo, así que la regla de cara al cliente se cumple como siempre: una persona del equipo está a un toque en el inbox.
¿Qué casos de uso funcionan para una tienda online?
Empieza con tareas donde un error no cuesta nada y luego suma envíos. Estos cuatro cubren casi todo lo que una tienda le pide a su asistente, y cada uno indica las herramientas y scopes que necesita, para que crees una clave solo para esa tarea.
Revisión del inbox por la mañana
Pídele al asistente todos los chats abiertos que siguen esperando, agrupados por tema y con un resumen de una línea
cada uno. Llama a list_conversations con status abierto y el filtro de ventana abierta, lee con
read_conversation los hilos que necesitan contexto y sugiere etiquetas como “talla”, “envío” o “reembolso”.
Tú
¿Qué chats de WhatsApp siguen esperando respuesta esta mañana?
Asistente · usó list_conversations, read_conversation
- 1. Un cliente pregunta si las zapatillas azules vienen pequeñas. Etiqueta sugerida: talla.
- 2. Una clienta quiere la fecha de entrega de un pedido hecho el lunes. Etiqueta sugerida: envío.
- 3. Un cliente reporta un paquete dañado y envió una foto. Necesita a una persona.
¿Etiqueto los chats 1 y 2 y dejo una nota privada en el chat 3 para el equipo?
Cuando aceptas, label_conversation aplica las etiquetas y add_note deja una nota privada en el chat del paquete
dañado. Herramientas y scopes: contacts:read, inbox:write. Un restaurante que recibe pedidos a domicilio o una
clínica con una fila matutina de consultas por citas usa la misma jugada.
Confirmaciones de pedido y estado de entrega
Si tu tienda funciona con WooCommerce o Shopify, la
automatización de pedidos de WACRM ya envía confirmaciones de pedido con plantillas
aprobadas. El asistente ayuda con las excepciones: una confirmación para un pedido que alguien del equipo tomó por
teléfono, o un aviso de retraso en la entrega. Envía con send_template, y notify_order suscribe tu propio
endpoint HTTPS a los eventos message.status, así tu sistema sabe cuándo se entregó o se leyó cada mensaje. Cada
entrega lleva un header X-WACRM-Signature; la guía de webhooks explica cómo
verificarlo.
Leads de email y formularios
Llega por email una consulta mayorista, o un formulario de contacto cae en tu helpdesk. Pídele al asistente que
cree a la persona con create_contact y deje una nota con lo que pidió. Luego tu equipo hace el seguimiento por
WhatsApp desde el inbox. Scope: contacts:write. Si se alcanza el límite de contactos del plan, vuelve
plan_limit_reached.
Un reporte semanal del inbox
Cada lunes, pide el reporte del inbox de la semana pasada agrupado por agente o por etiqueta, y la vista en vivo de
los chats que esperan ahora mismo. inbox_report devuelve el reporte del inbox en JSON para que el asistente lo
resuma; la exportación CSV sigue en el Workspace. Añade wallet_balance al mismo prompt para ver el saldo de tokens y
el consumo de este ciclo antes de una semana movida. Scopes: inbox:read, wallet:read. Los dos son de solo
lectura, lo que convierte a este caso en la primera tarea más segura para una clave nueva.
¿En qué se diferencia MCP del agente de IA integrado?
Hacen trabajos distintos y funcionan bien juntos. El agente de IA de WACRM habla con tus clientes: redacta respuestas con tu catálogo en el inbox, espera aprobación o envía dentro de las reglas que define el dueño, y se detiene con el interruptor de pausa de IA. Un asistente por MCP trabaja para tu equipo, en tu equipo, dentro de tu propio cliente de IA.
| Agente de IA integrado de WACRM | Tu propio asistente por MCP | |
|---|---|---|
| Con quién habla | Con clientes, en el chat de WhatsApp | Contigo y tu equipo, en el cliente de IA |
| Dónde funciona | Dentro de WACRM | En tu cliente MCP, con wacrm-mcp en el mismo equipo |
| Qué envía a WhatsApp | Respuestas, con aprobación previa o envío automático en la ventana de 24 horas | Plantillas aprobadas mediante send_template |
| Tarea típica | Responder preguntas de precio y stock, pasar chats a una persona | Ordenar el inbox, notas, etiquetas, reportes, envíos excepcionales |
Los dos se encuentran en el inbox: assign_conversation puede asignar una conversación a un agente de IA o a una
persona del equipo. El playbook del agente de IA para ecommerce cubre en
detalle el lado que atiende a los clientes.
¿Cómo conectas tu primer cliente de IA?
En tres pasos desde el Workspace, sin código:
- Elige tu cliente de IA. Abre Settings → AI tools (MCP), haz clic en Conectar un cliente y elige Claude Desktop, Cursor u otro cliente MCP.
- Crea una clave con el preset MCP. Los siete scopes vienen marcados. Desmarca lo que esta tarea no necesita y define un tope mensual de acciones.
- Pega la configuración. Copia la clave una vez y luego la configuración lista:
claude_desktop_config.jsonpara Claude Desktop,.cursor/mcp.jsonpara Cursor o una línea de comando para otros clientes. Reinicia el cliente y aparecen las 11 herramientas.
Nuestro equipo te entrega los archivos del servidor wacrm-mcp con tu Workspace y te ayuda a conectarlo. Las acciones MCP funcionan en los planes Corporate y Partner; consulta los precios. Para el recorrido completo, con una primera llamada a la API con curl, sigue la guía rápida de API y MCP. Los desarrolladores que quieran los endpoints directos pueden usar la referencia para desarrolladores.
¿Qué revisar antes de que un agente actúe por su cuenta?
Repasa esta lista antes de darle a una clave el scope messages:send o inbox:write:
- La clave se creó para una sola tarea, con solo los scopes de esa tarea marcados.
- Hay un tope mensual de acciones, a la medida de una semana normal de esa tarea.
- Las plantillas que puede enviar el asistente están aprobadas y tienen nombres claros para que el modelo elija la correcta.
- Tu prompt le pide al asistente que te confirme antes de cualquier envío, etiqueta o resolución.
- Alguien revisa cada semana la tarjeta de uso de la página Herramientas de IA (MCP).
- Sabes dónde está el botón para revocar.
Las tiendas que venden por WhatsApp todos los días pueden ver la configuración completa en la página de la solución para tiendas online. Para conectar tus sistemas y tus herramientas de IA, empieza por WACRM API & MCP; para un agente construido alrededor de tu propio flujo de trabajo, nuestro equipo de desarrollo a medida arma la conexión contigo.
