Crear bot de WhatsApp con la API oficial: guía completa

Para crear un bot de WhatsApp con la API oficial usas la WhatsApp Cloud API de Meta: registras un número de negocio en una app de Meta for Developers, configuras un webhook que recibe los mensajes, y tu programa responde llamando a la API. Esta guía explica todo lo que tienes que saber antes de construirlo: número, verificación, plantillas, la ventana de 24 horas y cómo se cobra. Para el código, tenemos versiones en Python y en n8n.

Qué es un bot de WhatsApp Business con API

La app WhatsApp Business es para que una persona atienda desde el celular. La API de WhatsApp Business es para que un sistema lo haga: un bot, un CRM, tu tienda en línea. Con la API puedes:

• Responder automáticamente con reglas o IA.
• Atender con varios agentes el mismo número desde una plataforma.
• Mandar confirmaciones de pedido, recordatorios de cita o códigos de verificación.
• Conectar WhatsApp con tu inventario, agenda o base de datos.

Requisitos

1. Cuenta de Meta Business (business.facebook.com).
2. App en Meta for Developers con el producto WhatsApp.
3. Un número de teléfono que pueda recibir SMS o llamada para verificarse y que no esté en uso en la app de WhatsApp (o que migres).
4. Un servidor con HTTPS para tu webhook, o una plataforma que lo ponga por ti.
5. Método de pago en tu cuenta de WhatsApp Business para mensajes cobrables.

Meta mantiene la guía oficial en Cloud API: Get started.

Paso a paso para crear el bot

1. Crea la app en developers.facebook.com y agrega WhatsApp. Meta te da un número de prueba.
2. Prueba el envío desde API Setup a tu celular (registrado como destinatario de prueba).
3. Configura el webhook: URL pública con HTTPS y un verify token. Meta hace una petición GET con hub.challenge que tu servidor debe devolver.
4. Suscríbete al campo messages para recibir mensajes entrantes.
5. Programa la lógica: reglas (“si dice horario, responde X”), menús con botones interactivos o IA.
6. Agrega tu número real en Phone numbers, con nombre visible del negocio (Meta revisa que cumpla sus reglas de nombre).
7. Genera un token permanente con un usuario del sistema de tu Meta Business.
8. Crea tus plantillas para mensajes fuera de la ventana de 24 horas.

Ejemplo mínimo de envío con curl (sirve para probar tu token):

curl -X POST "https://graph.facebook.com/v21.0/PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messaging_product":"whatsapp","to":"52XXXXXXXXXX","type":"text","text":{"body":"Hola desde la API"}}'

Cambia v21.0 por la versión vigente que indique tu panel. Para México, revisa en la respuesta del webhook el formato exacto del número que te llega del cliente y úsalo tal cual para contestar.

La ventana de 24 horas y las plantillas

Es la regla más importante de la API:

• Cuando un cliente te escribe, se abre una ventana de 24 horas en la que puedes responder con mensajes libres.
• Fuera de esa ventana solo puedes enviar plantillas aprobadas por Meta.
• Las plantillas tienen categoría: marketing (promociones), utilidad (confirmaciones, avisos de pedido) y autenticación (códigos). Meta revisa que la categoría corresponda.

Diseña tu bot con esto en mente: si el cliente no contesta en un día, tu “seguimiento” tendrá que ser una plantilla.

¿Cuánto cuesta la API de WhatsApp?

Desde julio de 2025 Meta cobra por mensaje entregado, con tarifa según la categoría de la plantilla y el país del destinatario, y con descuentos por volumen en algunas categorías. Las tarifas y qué mensajes se cobran se actualizan seguido, así que no te damos cifras: consulta la página oficial de precios de WhatsApp Business Platform y su tabla por país. Si usas un proveedor (BSP), súmale su cuota.

Políticas que debes respetar

• Consentimiento: solo escribe a personas que aceptaron recibir mensajes tuyos.
• Pase a humano: ten una forma clara de hablar con una persona.
• IA: desde el 15 de enero de 2026, los términos de la API prohíben distribuir chatbots de IA de propósito general; los bots de IA para tu negocio (ventas, soporte, citas) siguen permitidos.
• Calidad: si muchos usuarios te bloquean o reportan, Meta baja la calificación de tu número y limita tus envíos.

API directa o con proveedor (BSP)

Concepto	Cloud API directa	Proveedor (BSP)
Costo extra	Solo tu servidor	Cuota del proveedor
Bandeja para agentes	La programas tú	Incluida
Flexibilidad	Total	Lo que permita la plataforma
Ideal para	Integración con tu sistema	Equipo de ventas o soporte

Errores comunes

• Registrar tu número principal sin saber que deja la app. Prueba primero con el número de prueba.
• Webhook lento: responde 200 de inmediato; si tardas, Meta reintenta y duplicas respuestas.
• Plantillas rechazadas por estar en la categoría equivocada o con variables mal formadas.
• Token temporal en producción: caduca y el bot deja de funcionar.
• Mensajes masivos sin consentimiento: baja la calidad del número y pueden restringirlo.

Para cerrar

La API oficial es el camino correcto para un bot de WhatsApp para negocio que vaya a durar. Si estás eligiendo cómo empezar, en cómo crear un bot para WhatsApp comparamos todas las opciones, y en bot de WhatsApp para empresa vemos qué debe hacer un bot de negocio. En Black Engine configuramos la API, las plantillas y el bot completo; escríbenos por WhatsApp.