Servidor MCP de WhatsApp: enviar y leer mensajes de WhatsApp desde un agente de IA
Un servidor MCP de WhatsApp convierte la Cloud API en herramientas que un agente puede llamar: abrir una conversación, enviar un mensaje, leer la bandeja, enviar una plantilla aprobada. No puede publicar, porque WhatsApp no tiene publicaciones. Lo difícil no es la fontanería, es la ventana de 24 horas. Todo lo de abajo se verificó el 21 de octubre de 2026.
Qué puede y qué no puede hacer un servidor MCP de WhatsApp
WhatsApp es un canal de conversación, no una superficie de publicación. Así que la lista de herramientas que recibe un agente es corta y nítida: listar conversaciones, abrir una conversación por número de teléfono en formato internacional, enviar texto, enviar una plantilla aprobada, leer mensajes entrantes. No hay publicaciones, no hay comentarios y por tanto no hay analíticas. Cualquier servidor MCP de WhatsApp que te prometa reach e impressions está describiendo algo que no existe en la API.
Lo que necesita debajo es una cuenta de WhatsApp Business. En PlugKit esa conexión pasa por el Embedded Signup de Meta: llama a GET /v1/connect/whatsapp?profileId=..., abre la authUrl que devuelve, y la persona inicia sesión con Facebook, elige o crea un WABA y verifica el número. Los permisos que se piden son whatsapp_business_messaging y whatsapp_business_management.
Una trampa de la documentación de PlugKit que le cuesta un día a la gente: conecta un número real. Un número de prueba de Meta lleva un token de 24 horas y deja de funcionar a la mañana siguiente, lo que se parece exactamente a una integración rota.
La ventana de 24 horas, vista por un agente
Esta es la regla que decide si el mensaje de tu agente sale o no. El texto libre solo se acepta dentro de las 24 horas siguientes al último mensaje del contacto hacia ti. Fuera de esa ventana, el texto libre se rechaza y solo pasa una plantilla aprobada.
Para un agente, eso tiene una consecuencia práctica que la mayoría de los tutoriales se salta. El agente no puede saber, a partir del texto de una petición, si la ventana está abierta; tiene que leer primero la conversación. Así que el bucle útil es: listar la conversación, mirar la marca de tiempo del último mensaje entrante y luego elegir entre texto libre y plantilla. Un agente que se salta la lectura producirá fallos con mucha seguridad, y decirle a alguien que el mensaje salió cuando fue rechazado es peor que un error.
Las campañas siguen la misma ventana. No hay ningún ajuste que la abra.
Plantillas: la única salida de la ventana
Una plantilla es texto preaprobado con marcadores numerados. Lista las aprobadas en una cuenta con GET /v1/accounts/{ACCOUNT_ID}/message-templates, y luego envíala pasando template con name, language y variables, que rellenan {{1}}, {{2}} en orden. El nombre y el idioma tienen que coincidir exactamente, y components acepta componentes de Meta en bruto cuando necesitas una cabecera o botones.
Dos cosas que decirle explícitamente a tu agente. No puede inventarse una plantilla, porque la aprobación pasa fuera de tu código. Y no debería elegir una plantilla cuya categoría no encaje con la intención: el cobro por mensaje de Meta factura por categoría, así que enviar una plantilla de marketing para hacer el trabajo de una utility es un coste que te infliges tú.
Lo que cuestan los mensajes
Meta pasó a cobrar por mensaje el 1 de julio de 2025, sustituyendo el antiguo modelo por conversación. Pagas en la entrega, según la categoría del mensaje y el prefijo del país del destinatario. Los mensajes de los usuarios hacia ti son gratis.
| Categoría | Necesita plantilla aprobada | Enviable fuera de la ventana de 24 horas | Se cobra |
|---|---|---|---|
| Marketing | sí | sí | sí |
| Utility | sí | sí | sí, y desde el 1 de octubre de 2026 también dentro de una ventana de servicio abierta |
| Authentication | sí | sí | sí |
| Service | no | no | los primeros 1 000 por número de empresa y mes no se cobran desde el 1 de octubre de 2026, después sí |
| Meta Business Agent | no | no | sí, por token en vez de por mensaje |
Tres fechas que conviene tener claras: cobro por mensaje desde el 1 de julio de 2025; la categoría Meta Business Agent añadida el 1 de julio de 2026; y el 1 de octubre de 2026, que trajo los 1 000 mensajes de servicio no cobrados por número y mes, sin acumulación, más el cobro de los mensajes utility enviados dentro de una ventana de servicio abierta. Meta solo cambia precios el primer día de un trimestre, lo que hace de esta una de las facturas más fáciles de prever.
Un punto a favor que merece aprovecharse: cuando alguien te escribe desde un anuncio Click to WhatsApp en Android o iOS y respondes dentro de la ventana de servicio, se abre una ventana de punto de entrada gratuito de hasta 7 días, durante la cual los mensajes de marketing, utility, authentication y service no se cobran. Los mensajes de Meta Business Agent sí se siguen cobrando. La tabla completa está en Precios de la API de WhatsApp Business.
Por qué automatizar WhatsApp Web es el atajo equivocado
Busca un servidor MCP de WhatsApp y la mayoría de lo que encuentras pilota WhatsApp Web o una librería cliente de ingeniería inversa, normalmente emparejando un número personal con un código QR. La demo queda preciosa. También significa que un cliente no oficial está enviando tráfico en nombre de tu número, que es la ruta directa a perderlo, y cuando se va pierdes el número que tus clientes ya tienen. Para eso no hay cola de apelaciones.
La Cloud API oficial cuesta dinero por mensaje y te obliga a aprobar plantillas. Esas dos fricciones son lo que estás comprando: el número sigue siendo tuyo. El mismo razonamiento vale en todas las plataformas, y la versión amplia está en automatización de WhatsApp.
Conéctalo a Claude, ChatGPT o Cursor
El servidor MCP alojado de PlugKit cubre WhatsApp junto a las plataformas de publicación, así que un solo endpoint le da las dos cosas a un agente. Está en https://api.plugkit.co/mcp sobre Streamable HTTP, con 103 tools y tres workflows ya preparados a 21 de octubre de 2026. En Claude Code:
claude mcp add -t http plugkit https://api.plugkit.co/mcp
En las apps de Claude, Customize, luego Connectors, luego Add, luego un conector personalizado, y pega la misma URL. ChatGPT la acepta en modo desarrollador. Cursor y VS Code aceptan un enlace de un clic o unas líneas de JSON. La autenticación es OAuth 2.1 con PKCE y sin client secret, con mcp:read para leer conversaciones y mcp:write para enviar. Empieza con mcp:read una semana: leer una bandeja es reversible, enviar un mensaje de WhatsApp a un cliente no.
Si dejan de llegar mensajes entrantes, el arreglo es POST /v1/connect/whatsapp/{ACCOUNT_ID}/subscribe-webhooks, que vuelve a suscribir sin reconectar. Cuando fallan los envíos, lee GET /v1/accounts/{ACCOUNT_ID} para isActive, needsReconnection y disconnectedReason; Meta puede negarse a atender un número aunque el token sea perfectamente válido, y eso sale como error de Meta, no como error de autenticación.
PlugKit cuesta $49 al mes por 5 cuentas conectadas, cancelas cuando quieras, con 7 días gratis sin tarjeta y una cuenta conectada durante la prueba. Las tarifas de los mensajes de WhatsApp son de Meta y las cobra Meta, no se repercuten por PlugKit. Para el mismo patrón en plataformas que sí tienen publicaciones, mira el servidor MCP de Instagram y el servidor MCP de LinkedIn.
Preguntas frecuentes
¿Puede Claude enviar mensajes de WhatsApp?
Sí, a través de un servidor MCP conectado a la WhatsApp Cloud API. Claude no tiene acceso propio a WhatsApp. Una vez añadido el servidor, enviar un mensaje es una llamada a herramienta, sujeta a las mismas reglas de ventana de 24 horas y de plantillas que cualquier otro cliente de la Cloud API.
¿Existe un servidor MCP de WhatsApp oficial de Meta?
No. Meta publica la Cloud API; la capa MCP la construyen terceros encima. Por eso vale la pena comprobar si un servidor concreto usa la Cloud API o pilota WhatsApp Web, porque solo lo primero está permitido.
¿Por qué rechazaron el mensaje de WhatsApp de mi agente?
Casi siempre la ventana de 24 horas. Si el contacto no te ha escrito en las últimas 24 horas, el texto libre se rechaza y necesitas una plantilla aprobada. La segunda causa más común es un nombre o idioma de plantilla que no coincide exactamente.
¿Puede un servidor MCP de WhatsApp leer mi historial de mensajes?
Puede leer las conversaciones que llegaron por el número de empresa conectado, entregadas por webhook. No puede importar el historial de una cuenta personal de WhatsApp, y todo lo que diga hacerlo está pilotando un cliente no oficial.
¿WhatsApp da alguna analítica a un agente?
No. En WhatsApp no hay publicaciones, así que no hay métricas de publicación. Los estados de entrega y lectura existen a nivel de mensaje, pero reach, impressions y engagement no aplican a este canal.
Un solo plug para cada plataforma que toca tu agente
49 $ al mes por 5 cuentas conectadas, cancela cuando quieras. Todas las funciones en todos los planes.
Consigue tu clave de API →