Cómo conectar Whatsapp Business a Gemini — via MCP

💡 ¿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 Gemini

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 Gemini CLI 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).
• Gemini CLI instalado.

Paso 1 — Obtener tus credenciales de WhatsApp Business

1. Abre https://developers.facebook.com/ → tu App → WhatsApp → API Setup. Anota el WhatsApp Business Account ID (WABA ID).
2. 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.
3. 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

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

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

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

Paso 3 — Encuentra tu phoneNumberId una vez

Pide a Gemini 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 Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de WhatsApp Business.

Herramientas disponibles (14 en total)

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 Gemini, así que cuando pidas "manda un seguimiento a ese cliente" días después de su última respuesta, Gemini 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.

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse