WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

WhatsApp Business Tools MCP

Para desarrolladores que crean soluciones en WhatsApp Business Platform (Cloud API): el servidor WhatsApp Business Tools MCP permite que tu agente de IA y tu asistente de IDE administren y depuren tu integración de WhatsApp Business desde un solo lugar. Permite que un agente descubra las empresas y las cuentas de WhatsApp que administras, incorpore y registre números de teléfono, cree y administre plantillas de mensajes, configure webhooks y envíe mensajes, actuando en tu nombre en las aplicaciones y empresas que administras.

Nota: Nota: La interfaz y el conjunto de herramientas del servidor WhatsApp Business Tools MCP están en versión beta y pueden cambiar.

Descripción general

La siguiente tabla resume los detalles del servidor:

Atributo	Valor
Nombre del servidor	WhatsApp Business Tools
Transporte	HTTP transmisible
Endpoint	https://mcp.facebook.com/whatsapp_business_tools
Autenticación	Inicio de sesión con una cuenta de desarrollador de Meta (OAuth)
ID de cliente	No es necesario. El servidor reconoce automáticamente los clientes compatibles.
URI de redireccionamiento	No es necesario. No tienes que crear ni configurar una aplicación de Meta para este servidor.
Clientes compatibles	Claude Code, Claude Desktop, ChatGPT, Codex CLI, aplicación Codex
Estado	Beta: la interfaz y el conjunto de herramientas pueden cambiar

Antes de empezar

Para conectar un cliente, necesitas una versión actual de uno de los clientes compatibles que se indican arriba.

El servidor se está implementando gradualmente, por lo que es posible que aún no esté disponible para tu cuenta, incluso después de que se conecte tu cliente.

El servidor actúa sobre tus propios recursos, así que, antes de que un agente pueda usar la mayoría de las herramientas, también necesitas:

• Acceso de administrador a una empresa que quieras administrar (el rol MANAGE).
• Una aplicación con WhatsApp habilitado de la que seas administrador, conectada a esa empresa: una aplicación con el caso de uso WhatsApp Business Messaging (o el producto WhatsApp en una aplicación anterior). Debes tener acceso de administrador a la aplicación, no solo a la empresa.
• Haber aceptado las Condiciones del servicio de WhatsApp Business Cloud API para esa empresa. La mensajería y el registro de números de teléfono se bloquean hasta que un administrador las acepte.

Si falta algún requisito previo, la herramienta devuelve un error con instrucciones sobre qué corregir y un enlace a la página donde puedes hacerlo.

Conecta tu cliente

Para conectar un cliente compatible y completar la autorización OAuth, sigue las instrucciones de Conectar un cliente MCP a Meta. Usa el nombre del servidor y el endpoint de la Descripción general. Este servidor no requiere un ID de cliente, así que usa el registro automático.

Permisos

El servidor solicita los siguientes permisos durante la autorización:

Permiso	Acceso
business_management	Descubrir y usar las empresas que administras y que seleccionaste durante la autorización.
whatsapp_business_management	Administrar cuentas de WhatsApp Business, números de teléfono, plantillas de mensajes y webhooks.
whatsapp_business_messaging	Enviar mensajes desde tus números de teléfono registrados.

Puedes revisar estos permisos y revocar el acceso en Facebook, en Configuración > Tu actividad > Integraciones empresariales.

Verifica tu conexión

Pídele al agente que enumere las herramientas que tiene de este servidor, usando el nombre que le diste al conectarlo. Luego, ejecuta una herramienta de solo lectura, como whatsapp_biz_businesses, para enumerar las empresas que administras. La conexión funciona cuando esa llamada devuelve tus empresas en lugar de un error de autenticación o permisos.

Límites de frecuencia

Las solicitudes tienen límites de frecuencia por usuario y por herramienta para proteger la plataforma. Si superas el límite, la herramienta devuelve un error de límite de frecuencia; vuelve a intentarlo después de esperar un poco.

Herramientas

WhatsApp Business Tools MCP expone herramientas con el prefijo de espacio de nombres whatsapp_biz_. La mayoría de las herramientas están vinculadas a una empresa que administras, así que una sesión típica empieza por enumerar tus empresas y elegir una. El conjunto de herramientas evoluciona durante la versión beta.

Descubrimiento

• whatsapp_biz_businesses — Enumera las empresas que administras y que autorizaste durante el consentimiento. Usa esta herramienta primero para elegir una empresa. Ejemplo: "Enumera las empresas de WhatsApp que puedo administrar."
• whatsapp_biz_accounts — Enumera las cuentas de WhatsApp (y las cuentas de mensajería) de una empresa. Ejemplo: "Muestra las cuentas de WhatsApp de la empresa 1234567890."
• whatsapp_biz_phone_numbers — Enumera los números de teléfono de una empresa o cuenta de WhatsApp, con su estado y el estado de incorporación. Ejemplo: "Enumera los números de teléfono de esta empresa y sus estados."

Incorporación de números de teléfono

• whatsapp_biz_add_phone_number — Añade un número de teléfono a una cuenta de WhatsApp. Ejemplo: "Añade el número de teléfono +1 555 010 1234 a mi cuenta de WhatsApp."
• whatsapp_biz_send_verification_code — Envía un código de verificación a un número de teléfono. Ejemplo: "Envía un código de verificación por SMS a este número."
• whatsapp_biz_verify_phone_number — Verifica un número de teléfono con el código recibido. Ejemplo: "Verifica este número con el código 123456."
• whatsapp_biz_register_phone_number — Registra un número verificado para que pueda enviar y recibir mensajes. Ejemplo: "Registra este número para mensajería."

Plantillas de mensajes

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Enumera e inspecciona las plantillas de mensajes de una cuenta. Ejemplo: "Enumera las plantillas aprobadas de esta cuenta."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Crea, actualiza y elimina plantillas de mensajes. Ejemplo: "Crea una plantilla de marketing llamada order_update en en_US."

Mensajería

• whatsapp_biz_send_message — Envía un texto libre (que solo se entrega dentro de la ventana de atención al cliente de 24 horas) o un mensaje de plantilla aprobado desde un número registrado. Confirma contigo el destinatario antes de enviar. Ejemplo: "Envía la plantilla order_update a +1 555 010 9999 desde este número."

Webhooks

• whatsapp_biz_configure_webhooks — Establece la URL de devolución de llamada y el token de verificación para el tema de WhatsApp, y suscribe los campos permitidos. Ejemplo: "Configura los webhooks de esta empresa con la devolución de llamada https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Suscribe una cuenta de WhatsApp a los webhooks de tu aplicación para que se entreguen sus eventos. Ejemplo: "Suscribe esta cuenta de WhatsApp a los webhooks."

Configuración de la cuenta

• whatsapp_biz_configure_payments — Configura un método de pago para que la cuenta pueda enviar mensajes facturables. Ejemplo: "Ayúdame a configurar los pagos de esta cuenta."
• whatsapp_biz_verify_business — Comprueba e inicia la verificación de la empresa. Ejemplo: "¿Cuál es el estado de verificación de la empresa y cómo puedo iniciarla?"
• whatsapp_biz_system_user_token — Obtén un enlace para generar un token de acceso de usuario del sistema para tu empresa, de modo que puedas crear una solución de mensajería personalizada que llame directamente a WhatsApp Cloud API. La generación del token se realiza de forma segura en Configuración del negocio: la herramienta devuelve un enlace directo a la página Usuarios del sistema, donde puedes seleccionar un usuario del sistema y generar el token. Para obtener más información, consulta Crear un usuario del sistema y generar un token de acceso permanente. Ejemplo: "Dame un enlace para crear un token de acceso de usuario del sistema para esta empresa."

Comentarios

Si tienes comentarios o quieres ver más herramientas, compártelos.

Relacionado

• Descripción general de MCP
• Conectar un cliente MCP a Meta
• Documentación de WhatsApp Business Platform

---

Índice completo de documentación de este producto: https://developers.facebook.com/documentation/mcp/llms.txt