MCP de WhatsApp Business: cómo gestionar WhatsApp de tu negocio hablando con Claude

De dónde sale este tutorial

Está basado en la documentación oficial de Meta para desarrolladores: WhatsApp Business Tools MCP. La he leído entera, la he pasado a español y le he añadido lo que la documentación no dice: qué significa todo esto para un negocio que usa WhatsApp para vender o atender clientes.

Un aviso antes de empezar: está en beta y Meta lo está activando poco a poco. Si cuando lo pruebes tu cuenta no tiene acceso, no es que lo estés haciendo mal; es que aún no te ha llegado. Y las herramientas pueden cambiar de nombre o de comportamiento mientras dure la beta.

Qué es un MCP (explicado sin jerga)

MCP (Model Context Protocol) es un estándar abierto, creado por Anthropic y adoptado ya por OpenAI, Google o Meta, para conectar asistentes de IA con herramientas externas. Piensa en él como un enchufe universal: el fabricante de una herramienta publica un «servidor MCP» y cualquier asistente compatible puede usarla.

Hasta ahora, si querías que una IA tocara tu WhatsApp Business, alguien tenía que programar la integración a mano contra la API de Meta. Con este MCP, Meta ya ha hecho ese trabajo: la IA ve una lista de acciones (listar números, crear plantillas, enviar un mensaje, configurar webhooks…) y decide cuál usar según lo que le pidas.

La consecuencia práctica: tareas de configuración que antes eran media mañana entre pestañas del Business Manager pasan a ser una frase. No sustituye a saber qué estás haciendo, pero sí quita mucha fricción.

Qué puede hacer: las herramientas del servidor

Todas empiezan por whatsapp_biz_. Las agrupo por lo que resuelven en un negocio:

Ver qué tienes

• whatsapp_biz_businesses: lista los negocios que administras.
• whatsapp_biz_accounts: lista las cuentas de WhatsApp de un negocio.
• whatsapp_biz_phone_numbers: lista los números con su estado y en qué punto del alta están.

Dar de alta un número

• whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number y whatsapp_biz_register_phone_number: el proceso completo de añadir, verificar y registrar un número, que en el panel de Meta es justo la parte donde más gente se atasca.

Plantillas de mensaje

• whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template y whatsapp_biz_delete_template: crear, revisar, editar y borrar las plantillas (recordatorios, confirmaciones de pedido, avisos…).

Enviar mensajes

• whatsapp_biz_send_message: envía un texto o una plantilla. Según Meta, te confirma el destinatario antes de enviar.

Webhooks

• whatsapp_biz_configure_webhooks y whatsapp_biz_subscribe_webhook: le dicen a Meta a qué dirección de tu servidor debe avisar cuando llega un mensaje o cambia el estado de uno enviado.

Configuración de la cuenta

• whatsapp_biz_configure_payments, whatsapp_biz_verify_business y whatsapp_biz_system_user_token. Esta última no te da el token directamente: te devuelve un enlace a la página de usuarios del sistema de Meta, donde lo generas tú. Ese token es el que necesitarás si luego quieres programar tu propia integración.

Paso 1 — Comprueba que cumples los requisitos

Antes de tocar nada en Claude, en tu cuenta de Meta necesitas:

• Ser administrador del negocio (rol con control total en el portfolio empresarial de Meta).
• Ser administrador de una app de Meta con WhatsApp conectada a ese negocio.
• Haber aceptado los términos de la WhatsApp Business Cloud API. Sin esto, el envío de mensajes y el registro de números quedan bloqueados hasta que un administrador los acepte.

Si usas la app normal de WhatsApp Business del móvil y nunca has entrado en el panel de desarrolladores de Meta, este es el punto donde te toca crear la app. Es un trámite, pero hazlo con calma: según cómo lo registres, un número dado de alta en la Cloud API puede dejar de funcionar en la app del móvil como hasta ahora, así que no migres tu número principal sin tenerlo claro. Para probar, usa un número secundario.

Paso 2 — Añade el servidor a tu asistente

Es un servidor remoto (HTTP), así que no instalas nada en tu ordenador. Solo hay que decirle a tu asistente dónde está:

https://mcp.facebook.com/whatsapp_business_tools

Claude Code (terminal)

claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools

Claude Desktop

Ajustes → Conectores → Añadir conector personalizado. Nombre: WhatsApp Business Tools. URL: la de arriba.

ChatGPT

Ajustes → Plugins → Explorar plugins, añade el plugin de WhatsApp Business Tools y autentícate con OAuth.

Codex (app de OpenAI)

Ajustes → MCP Servers → Añadir servidor, elige Streamable HTTP, pega la URL y selecciona autenticación OAuth.

Paso 3 — Inicia sesión y revisa qué permisos das

La primera vez que el asistente use el servidor se abrirá el navegador para iniciar sesión con tu cuenta de desarrollador de Meta. Te pedirá tres permisos, y conviene saber qué significa cada uno antes de pulsar «Aceptar»:

• business_management: acceder a los negocios que administras.
• whatsapp_business_management: gestionar cuentas, números, plantillas y webhooks.
• whatsapp_business_messaging: enviar mensajes desde tus números registrados.

El tercero es el que tiene consecuencias de verdad: un mensaje enviado a un cliente no se puede deshacer. Si en algún momento quieres cortar el acceso, se revoca en facebook.com → Configuración → Integraciones comerciales.

Paso 4 — Empieza por consultas que no cambian nada

Mi consejo con cualquier MCP que pueda escribir: los primeros días, solo lectura. Pídele cosas como estas y comprueba que lo que te dice cuadra con lo que ves en el panel de Meta:

Lista los negocios que administro en WhatsApp y los números de cada uno, con su estado.

¿Qué plantillas tengo aprobadas, cuáles están pendientes y cuáles han sido rechazadas?

Cuando te fíes, pasa a tareas de configuración:

Crea una plantilla de categoría utilidad, en español, llamada recordatorio_cita, que diga:
"Hola {{1}}, te recordamos tu cita del {{2}} a las {{3}}. Si no puedes venir, responde a este mensaje."

Configura los webhooks de este negocio con la URL https://api.minegocio.es/whatsapp/webhook

Envía la plantilla confirmacion_pedido al +34 600 000 000 desde el número de la tienda.

En el último caso el asistente te confirmará el destinatario antes de mandarlo. Léelo de verdad, no le des a «sí» por inercia.

La regla de las 24 horas (lo que más confunde)

WhatsApp no te deja escribir lo que quieras a quien quieras. Los mensajes de texto libre solo se entregan dentro de la ventana de 24 horas de atención al cliente: el cliente te escribe y, durante las siguientes 24 horas, puedes contestarle libremente.

Fuera de esa ventana, solo puedes enviar plantillas aprobadas por Meta. Por eso las herramientas de plantillas son tan importantes en este MCP: si le pides a la IA que escriba a un cliente que no te ha hablado hoy y el mensaje no es una plantilla, no llegará.

Traducido a negocio: piensa antes qué avisos vas a necesitar (recordatorios, confirmaciones, «tu pedido ha salido») y deja las plantillas creadas y aprobadas. Es justo el tipo de tarea en la que este MCP te ahorra tiempo.

Para qué sirve en un negocio (y para qué no)

Aquí es donde veo más confusión, así que lo digo claro: este MCP no es un chatbot que contesta a tus clientes por WhatsApp. Es una herramienta para que tú (o quien te lleve la parte técnica) gestionéis la cuenta hablando con una IA. La IA solo actúa cuando alguien abre Claude y se lo pide.

Donde sí ahorra horas

• Puesta en marcha: dar de alta y verificar números, conectar webhooks, revisar que todo está bien configurado.
• Plantillas: redactarlas, crearlas en los idiomas que necesites y ver de un vistazo cuáles se han rechazado y por qué.
• Envíos puntuales: mandar una plantilla concreta a un cliente concreto sin abrir otra herramienta.
• Auditoría: «¿qué números tengo, en qué estado y qué plantillas usa cada uno?» en una sola pregunta.

Donde no es la herramienta adecuada

• Atención automática 24/7: para que una IA conteste sola a cada cliente que escribe necesitas un backend que reciba los webhooks y responda. Eso sigue siendo desarrollo.
• Envíos masivos: hay límites de uso por usuario y por herramienta (si te pasas, devuelve un error de límite y hay que esperar un poco), y además no es buena idea hacer marketing masivo «a mano» desde un chat.
• Procesos críticos: cobros, reservas o datos personales no deberían depender de que alguien escriba bien una frase en un chat.

El siguiente paso: tu propio asistente en WhatsApp

Si lo que quieres es que tus clientes escriban por WhatsApp y una IA les conteste al momento, el MCP te ayuda a dejarlo todo configurado (número, plantillas, webhook y el token de usuario del sistema), y después hace falta un servicio que escuche y responda. Esta parte es para quien vaya a programarlo. Un esqueleto en NestJS contra la WhatsApp Cloud API:

// whatsapp.controller.ts
import { Body, Controller, ForbiddenException, Get, HttpCode, Post, Query } from '@nestjs/common';
import { WhatsappService } from './whatsapp.service';

@Controller('whatsapp/webhook')
export class WhatsappController {
  constructor(private readonly whatsapp: WhatsappService) {}

  // Meta llama aquí una vez para comprobar que el webhook es tuyo
  @Get()
  verify(
    @Query('hub.mode') mode: string,
    @Query('hub.verify_token') token: string,
    @Query('hub.challenge') challenge: string,
  ): string {
    if (mode === 'subscribe' && token === process.env.WHATSAPP_VERIFY_TOKEN) {
      return challenge;
    }
    throw new ForbiddenException();
  }

  // Cada mensaje entrante llega por aquí
  @Post()
  @HttpCode(200)
  async receive(@Body() payload: any): Promise<void> {
    const value = payload?.entry?.[0]?.changes?.[0]?.value;
    const message = value?.messages?.[0];
    if (message?.type !== 'text') return;

    // Responder rápido a Meta y procesar después evita reintentos duplicados
    void this.whatsapp.handleIncoming(value.metadata.phone_number_id, message.from, message.text.body);
  }
}

// whatsapp.service.ts
import { Injectable, Logger } from '@nestjs/common';
import { ClaudeService } from '../claude/claude.service';

@Injectable()
export class WhatsappService {
  private readonly logger = new Logger(WhatsappService.name);
  private readonly graphUrl = `https://graph.facebook.com/${process.env.GRAPH_API_VERSION}`;

  constructor(private readonly claude: ClaudeService) {}

  async handleIncoming(phoneNumberId: string, from: string, text: string): Promise<void> {
    try {
      // Aquí iría tu system prompt y el historial del cliente
      const reply = await this.claude.chat([{ role: 'user', content: text }], process.env.WHATSAPP_SYSTEM_PROMPT);
      await this.sendText(phoneNumberId, from, reply);
    } catch (err) {
      this.logger.error(`No se pudo responder a ${from}`, err as Error);
    }
  }

  // Texto libre: solo llega dentro de la ventana de 24 horas
  private async sendText(phoneNumberId: string, to: string, body: string): Promise<void> {
    const res = await fetch(`${this.graphUrl}/${phoneNumberId}/messages`, {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.WHATSAPP_SYSTEM_USER_TOKEN}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ messaging_product: 'whatsapp', to, type: 'text', text: { body } }),
    });
    if (!res.ok) throw new Error(`WhatsApp API ${res.status}: ${await res.text()}`);
  }
}

El ClaudeService es el mismo que explico en el tutorial del system prompt, y el system prompt es lo que decide si ese asistente vende o espanta clientes. En producción faltan piezas que no caben en un ejemplo: validar la firma X-Hub-Signature-256 de cada webhook, guardar el historial de cada conversación, no responder dos veces al mismo mensaje y derivar a una persona cuando toca.

Riesgos y buenas prácticas

• Es beta. No construyas un proceso de negocio que dependa de que una herramienta concreta del MCP se llame igual dentro de tres meses.
• Escribe en nombre de tu marca. Cualquier mensaje que envíe la IA lo recibe el cliente como tuyo. Revisa cada envío.
• Mínimo acceso. Conéctalo con la cuenta de quien realmente gestiona WhatsApp, no con la de todo el equipo, y revoca el acceso cuando no lo uses.
• Prueba con un número secundario. Registrar números y cambiar webhooks afecta a cómo llegan los mensajes de tus clientes. Mejor equivocarse en uno que no usa nadie.
• Si falla la conexión, Meta recomienda revisar la URL del servidor y comprobar que completaste el inicio de sesión. Si recibes errores de límite, espera un poco y vuelve a intentarlo.

Preguntas frecuentes

¿Quieres WhatsApp trabajando para tu negocio?

El MCP es una gran noticia para quien ya gestiona WhatsApp Business: quita horas de panel. Pero la parte que mueve dinero —que tus clientes reciban respuesta al momento, con tus datos reales, y que nadie se quede sin atender— sigue siendo un proyecto que hay que pensar bien.

Si quieres saber si te compensa, hago un diagnóstico técnico gratuito: vemos qué te preguntan por WhatsApp, cuánto tiempo te lleva y te digo con números si automatizarlo te ahorra horas de verdad o no.