Cómo conectar WhatsApp Business a Claude — Envía WhatsApp desde Claude vía MCP

Q: ¿Qué pasa si envío texto libre fuera de la ventana de 24 h?

Meta devuelve el código `131047` ("Re-engagement message"). Usa `whatsapp_send_template_message`.

No install? Use cloud.anythingmcp.com directly.

Sign in, install the WhatsApp Business Cloud API in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → WhatsApp Business, pega el token permanente del System User + el ID de la cuenta de WhatsApp Business, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local. Puedes saltarte los pasos de instalación local y pasar directamente a la sección de configuración del cliente.

Conectar WhatsApp Business a Claude

La WhatsApp Business Cloud API es la pasarela alojada por Meta para enviar mensajes de WhatsApp por programación — texto, plantillas, multimedia, notas de voz, botones interactivos, ubicaciones. Con AnythingMCP lo pilotas todo desde Claude Desktop, Claude Code o claude.ai en lenguaje natural. Sin SDK que pegar, sin JSON a mano para cada tipo de mensaje.

Lo que puedes hacer

"Envía 'Tu pedido ha sido enviado — síguelo en https://acme.com/t/12345' al +34 612 345 678."
"Envía la plantilla confirmacion_pedido (es) al +34 612 345 678, rellena 'Ana' y 'ORD-9912'."
"Envía el PDF de factura en https://acme.com/inv/9912.pdf a mi cliente con leyenda 'Factura 9912'."
"Lista las plantillas aprobadas en mi WABA y luego envía la de bienvenida en italiano a este nuevo lead."

Requisitos previos

Una WhatsApp Business Account (WABA) con al menos un número emisor verificado.
Un token permanente de System User con los permisos whatsapp_business_messaging + whatsapp_business_management (el token dev temporal de 24 h sirve para pruebas pero caduca).
AnythingMCP en local o en cloud.anythingmcp.com (3 minutos de configuración).
Claude Desktop, Claude Code o una cuenta de claude.ai.

Paso 1 — Obtener tus credenciales de WhatsApp Business

Abre https://developers.facebook.com/ → tu App → WhatsApp → API Setup. Anota el WhatsApp Business Account ID (WABA ID).
Ve a Meta Business Suite → Business Settings → System Users, crea un System User, asigna tu WABA y Genera un token nuevo con whatsapp_business_messaging + whatsapp_business_management. Cópialo — no lo verás de nuevo.
Asegúrate de que tu número emisor esté verificado en API Setup (el número de prueba funciona inmediatamente; para producción añade y verifica el tuyo).

Paso 2 — Instalar el adapter de WhatsApp Business

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Abre http://localhost:3000/connectors/store, pulsa WhatsApp Business y rellena:

Campo	Valor
`WHATSAPP_ACCESS_TOKEN`	el token permanente del System User
`WHATSAPP_BUSINESS_ACCOUNT_ID`	tu WABA ID (p. ej. `123456789012345`)

Pulsa Install — el adapter está ahora en tu catálogo con 14 herramientas.

Paso 3 — Encuentra tu phoneNumberId una vez

Pide a Claude que llame a whatsapp_list_phone_numbers (con tu WABA ID como businessAccountId). Recibirás el id de cada número emisor — fija ese valor, cada herramienta de envío lo necesita como phoneNumberId.

Paso 4 — Añadir el conector en Claude (sin código, 4 clics)

Ruta recomendada — funciona en claude.ai web sin tocar ningún archivo de configuración.

Abre claude.ai/customize/connectors.
Pulsa "Add custom connector".
Rellena:
- Name: WhatsApp Business
- URL: https://cloud.anythingmcp.com/mcp
- Authentication: Bearer token → pega tu MCP API key (de AnythingMCP → Profile → MCP API Keys → New Key)
Pulsa Connect para autorizar.

Listo. Las 14 herramientas de WhatsApp aparecen en tu chat — empieza a escribir prompts.

Avanzado: Claude Desktop / Claude Code (JSON / CLI)

Claude Desktop — edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %AppData%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "whatsapp-business": {
      "url": "https://cloud.anythingmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Reinicia Claude Desktop. Las herramientas de WhatsApp aparecen en el menú 🔧.

Claude Code — un comando CLI:

claude mcp add whatsapp-business \
  --transport http \
  --url https://cloud.anythingmcp.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_API_KEY"

Verifica con claude mcp list.

Herramientas disponibles (14 en total)

Grupo	Herramientas
Descubrimiento	`whatsapp_list_phone_numbers`, `whatsapp_list_message_templates`, `whatsapp_get_message_template`
Texto y plantilla	`whatsapp_send_text_message`, `whatsapp_send_template_message`
Multimedia (URL o media ID)	`whatsapp_send_image`, `whatsapp_send_audio`, `whatsapp_send_video`, `whatsapp_send_document`
Interactivos y ubicación	`whatsapp_send_location`, `whatsapp_send_interactive_buttons`
Confirmaciones de lectura y perfil	`whatsapp_mark_message_as_read`, `whatsapp_get_business_profile`, `whatsapp_update_business_profile`

La ventana de 24 horas — lo que tu agente necesita saber

WhatsApp solo permite enviar mensajes de formato libre (texto, multimedia, interactivos, ubicación) dentro de las 24 horas posteriores al último mensaje entrante del usuario hacia tu número. Fuera de esa ventana solo están permitidas las plantillas pre-aprobadas — llama a whatsapp_send_template_message con el nombre de plantilla y el idioma.

El campo instructions del adapter le indica esta regla a Claude, así que cuando pidas "manda un seguimiento a ese cliente" días después de su última respuesta, Claude usará whatsapp_send_template_message en lugar de texto libre.

Notas de voz

Usa whatsapp_send_audio con link apuntando a un archivo OGG-Opus alojado en una URL HTTPS pública. WhatsApp renderiza OGG-Opus como auténtica nota de voz (forma de onda + botón de reproducir). MP3 y AMR también funcionan pero aparecen como adjuntos de audio.

FAQ

¿Funciona sin un número de empresa verificado? El número de prueba de Meta funciona para pruebas (solo envía a números añadidos como tester). Para envíos de producción a cualquier destinatario, tu número emisor debe estar verificado y registrado en tu WABA.

¿Qué pasa si envío texto libre fuera de la ventana de 24 h? Meta devuelve el código 131047 ("Re-engagement message"). Usa whatsapp_send_template_message.

¿Puede el adapter recibir mensajes entrantes? No directamente — Meta usa webhooks para inbound, y el motor REST de AnythingMCP es solo outbound. Ejecuta un pequeño receptor de webhook junto a AnythingMCP y usa este conector para outbound + whatsapp_mark_message_as_read para las confirmaciones.

¿Funciona con Claude Code igual que con Claude Desktop? Sí — misma URL MCP.