Si alguna vez has intentado conectar WhatsApp a un chatbot, a tu CRM o a cualquier automatización, seguramente te has topado con lo mismo: la API oficial de WhatsApp Business. Portafolios de Meta, verificaciones, números que no se pueden registrar, plantillas rechazadas… Es, con diferencia, la parte que más dolores de cabeza da en nuestros proyectos, y la que más nos preguntan.
En esta guía te explico, paso a paso y sin tecnicismos innecesarios, qué es la API, qué necesitas para conseguirla, cuánto cuesta y cuáles son los errores que más vemos. Está actualizada a octubre de 2026 con la documentación oficial de Meta.
1. Qué es la API oficial de WhatsApp Business
La API de WhatsApp Business (Meta la llama WhatsApp Business Platform, y su versión actual es la Cloud API) es la forma oficial de conectar WhatsApp con otros sistemas: un chatbot, un CRM, tu tienda online o una herramienta de automatización como n8n.
No es una aplicación que te descargas. Es una conexión técnica: los mensajes entran y salen de WhatsApp a través de tus sistemas, no de un móvil.
| App WhatsApp Business | API oficial | |
|---|---|---|
| Para qué sirve | Atender desde el móvil o el ordenador | Conectar WhatsApp con chatbots, CRM y automatizaciones |
| Quién responde | Personas | Personas y sistemas (por ejemplo, un asistente con IA) |
| Varios agentes a la vez | Limitado | Sí, sin límite práctico |
| Mensajes automáticos | Bienvenida y ausencia | Cualquier flujo que diseñes |
| Coste | Gratis | Se paga por algunos mensajes (lo vemos más abajo) |
2. ¿De verdad la necesitas?
No siempre. Si respondes tú desde el móvil y te llegan unos pocos mensajes al día, la app gratuita de WhatsApp Business probablemente te basta.
La API empieza a tener sentido cuando:
- Quieres que un chatbot o asistente con IA responda por ti.
- Quieres registrar cada conversación en tu CRM o hacer seguimiento automático de tus leads.
- Varias personas del equipo atienden el mismo número.
- Necesitas enviar avisos automáticos: confirmaciones de pedido, recordatorios de citas, etc.
Si aún dudas entre la app y la API, lo comparamos en detalle en WhatsApp Business: ¿app o API?
3. Lo que necesitas antes de empezar
Tenerlo todo preparado antes de empezar te ahorra muchos atascos:
- Un portafolio empresarial de Meta (el antiguo Business Manager), en business.facebook.com, con los datos de tu empresa bien puestos.
- Un número de teléfono propio, con prefijo de país, que pueda recibir un SMS o una llamada. Puede ser fijo o móvil, pero no un número corto.
- Datos legales coherentes: el nombre, la dirección y la web de tu empresa deben coincidir en Meta, en tu web y en tus documentos. Es lo que más retrasa la verificación.
- Un nombre visible para tu perfil de WhatsApp, relacionado con tu marca.
- Un método de pago en Meta para los mensajes de pago.
4. Directamente con Meta o a través de un proveedor
Hay dos maneras de conectarte a la API:
- Directamente con Meta (Cloud API). Lo configuras tú desde el panel de desarrolladores de Meta. No tiene cuota de intermediario, pero exige conocimientos técnicos: crear una app, gestionar tokens de acceso, configurar webhooks…
- A través de un proveedor oficial (un Business Solution Provider, como YCloud, que es el que usamos en nuestros proyectos). El alta es más guiada, tienes soporte y suelen ofrecer un panel para gestionar plantillas y conversaciones. A cambio, algunos cobran una cuota o un recargo sobre los mensajes.
Los dos caminos usan la misma API oficial: no hay una versión «mejor» de WhatsApp. La diferencia está en quién hace la parte técnica.
5. Cómo conseguirla, paso a paso
Este es el proceso oficial de Meta para la Cloud API. Si vas a través de un proveedor, la mayoría de pasos se hacen desde su panel, pero son los mismos por debajo.
- Regístrate como desarrollador de Meta con tu cuenta de Facebook en developers.facebook.com.
- Crea una app y elige el caso de uso «Conectar con los clientes a través de WhatsApp». Asóciala a tu portafolio empresarial (o crea uno).
- Conecta o crea tu cuenta de WhatsApp Business (WABA). Es la cuenta que agrupa tus números y plantillas.
- Añade tu número de teléfono. Meta te enviará un código por SMS o llamada para verificar que es tuyo, y tendrás que crear un PIN de verificación en dos pasos.
- Elige tu nombre visible. Meta lo revisa y puede aprobarlo o rechazarlo.
- Añade un método de pago en la configuración de la cuenta de WhatsApp.
- Crea un usuario del sistema y un token permanente. El token que aparece al principio es temporal y caduca enseguida; para que tu chatbot o tu CRM funcione siempre, necesitas uno permanente con los permisos de WhatsApp.
- Configura el webhook: la dirección donde Meta enviará los mensajes que recibes y los avisos de entrega y lectura. Aquí es donde se conecta tu chatbot, tu CRM o n8n.
Con esto ya puedes enviar y recibir mensajes. Pero para usar la API con clientes reales y sin restricciones, falta un paso importante.
6. La verificación de la empresa
Puedes empezar sin verificar tu empresa, pero con limitaciones. Según la documentación de Meta:
- Un portafolio nuevo puede escribir a 250 personas distintas al día fuera de conversaciones abiertas. Al verificar la empresa, el límite sube a 2.000.
- Un portafolio nuevo puede registrar 2 números. Verificado, hasta 20.
La verificación se hace desde la configuración de tu portafolio empresarial. Meta te pedirá documentos oficiales que demuestren el nombre legal, la dirección y el teléfono de tu empresa. El consejo más importante: que el nombre y la dirección sean exactamente iguales en todos los sitios (en Meta, en tu web y en los documentos). Una diferencia mínima, como una abreviatura, puede hacer que la rechacen. Es uno de los atascos que más vemos (te lo cuento en los errores más comunes).
7. Límites de mensajes
WhatsApp no te deja escribir a miles de personas desde el primer día. El límite cuenta cuántas personas distintas reciben un mensaje tuyo fuera de una conversación abierta en 24 horas. Los niveles son 250, 2.000, 10.000, 100.000 e ilimitado.
Dos cosas que conviene saber:
- Desde 2025, el límite es por portafolio empresarial, no por número. Todos tus números comparten la misma cuota.
- A partir de 2.000, Meta sube de nivel automáticamente si tus mensajes son de buena calidad (la gente no los bloquea ni los denuncia) y has usado al menos la mitad de tu límite en la última semana.
Responder a quien te escribe primero no cuenta para este límite. Por eso un chatbot que atiende consultas apenas lo nota; donde más se nota es en los envíos masivos.
8. Plantillas y la ventana de 24 horas
Esta es la regla que más confunde y la más importante de entender:
- Cuando un cliente te escribe, se abre una ventana de atención de 24 horas. Durante ese tiempo puedes responderle con mensajes normales (texto, imágenes, audios…).
- Fuera de esa ventana, o si eres tú quien empieza la conversación, solo puedes enviar plantillas: mensajes que Meta ha aprobado previamente.
Las plantillas tienen tres categorías, y de ellas depende el precio:
- Marketing: promociones, ofertas, novedades.
- Utilidad: información sobre algo que el cliente ha pedido, como una confirmación de pedido o un recordatorio de cita.
- Autenticación: códigos de verificación.
Meta revisa cada plantilla y puede cambiarle la categoría si considera que, por ejemplo, un «recordatorio» es en realidad un mensaje promocional.
9. Cuánto cuesta la API de WhatsApp Business
Usar la API no tiene cuota de alta con Meta. Se paga por mensaje, y desde el 1 de julio de 2025 Meta cobra por cada plantilla entregada:
- Gratis: todos los mensajes que no son plantillas dentro de la ventana de 24 horas, es decir, las respuestas a quien te escribe. También las plantillas de utilidad dentro de esa ventana.
- De pago: las plantillas de marketing (siempre), y las de utilidad y autenticación cuando se envían fuera de la ventana.
- Gratis durante 72 horas: si el cliente te escribe desde un anuncio de Facebook o Instagram que lleva a WhatsApp y le respondes en menos de 24 horas.
El precio depende del país del destinatario y de la categoría. Para España son unos pocos céntimos por mensaje, y el marketing es la categoría más cara. Meta solo cambia las tarifas el 1 de enero, abril, julio y octubre, así que antes de calcular un presupuesto consulta siempre las tarifas oficiales de Meta. A eso hay que sumar el IVA y, si usas un proveedor, su posible cuota.
En la práctica, para un negocio que usa WhatsApp sobre todo para atender a quien le escribe, el coste de Meta suele ser bajo, porque la mayoría de mensajes van dentro de la ventana de 24 horas.
10. ¿Puedo usar el número que ya tengo?
Es la pregunta del millón, porque casi todo el mundo quiere mantener su número de siempre.
Opción 1: pasar el número del todo a la API. Un número que ya está registrado en WhatsApp no puede darse de alta en la API hasta que se elimina la cuenta de la app. Pierdes el uso del número en el móvil y el historial no se traslada.
Opción 2: coexistencia. Meta permite conectar a la API un número que ya usas en la app WhatsApp Business y seguir usando las dos cosas a la vez. Los mensajes se reflejan en ambos lados y se pueden sincronizar los contactos y hasta 6 meses de conversaciones individuales. Tiene limitaciones que conviene conocer:
- Solo funciona con la app WhatsApp Business (no con WhatsApp normal) y se activa a través de un proveedor o socio de Meta.
- Los grupos, las listas de difusión y algunas funciones (llamadas, catálogo o estados por la API, entre otras) no funcionan igual.
- Hay que abrir la app en el móvil al menos cada dos semanas; si no, la conexión se desactiva.
- Los mensajes que envías desde la app siguen siendo gratis; los de la API se cobran con las tarifas normales.
Funciona bien, pero en nuestra experiencia es la opción que más incidencias da: fallos al vincular el teléfono y desconexiones por inactividad.
Opción 3: un número nuevo para la API. Es lo más limpio si vas a automatizar mucho. Mantienes tu número personal aparte y el de la empresa funciona al 100 % con la API.
11. ¿Puedo conectar un chatbot con IA?
Sí. Desde el 15 de enero de 2026, Meta prohíbe en la API los asistentes de IA de uso general (los que ofrecen la IA como producto en sí, al estilo de un ChatGPT dentro de WhatsApp). Pero ha dejado claro que los negocios pueden seguir usando IA para atender a sus propios clientes: resolver dudas, consultar pedidos, reservar citas o recomendar productos.
Un chatbot con IA para tu negocio está permitido. Lo que no está permitido es montar un servicio de «IA general» sobre WhatsApp.
12. Los errores que más nos encontramos (y cómo resolverlos)
Esta es la parte que no suele contar nadie. Estos son los cuatro atascos que más nos encontramos al conectar la API en proyectos de clientes.
«El número ya está registrado en otra cuenta»
Es, de lejos, el más habitual. Meta detecta que el número ya pertenece a otra cuenta de WhatsApp Business (WABA), muchas veces de una prueba antigua, de otro proveedor o de alguien que lo configuró hace tiempo y ya nadie recuerda, y no deja registrarlo como nuevo.
Cómo lo resolvemos: hay que localizar esa cuenta anterior y eliminar el número desde su administrador de WhatsApp, o migrar el número de una cuenta a otra. Por eso conviene averiguar antes de empezar si el número se ha usado alguna vez con la API o con otra herramienta y quién tiene acceso a esa cuenta.
«Cuenta vinculada a otro socio» (error #2655093) y vinculaciones residuales
Meta indica que la cuenta de WhatsApp Business ya está compartida con otro proveedor, aunque en el panel no aparezca ninguno conectado. Nos ha pasado varias veces con negocios que antes habían usado herramientas como ManyChat: aunque la desconectaron, Meta seguía detectando la asociación antigua y no dejaba conectar el nuevo proveedor.
Cómo lo resolvemos: revisando en la configuración del portafolio empresarial de Meta qué socios, aplicaciones e integraciones siguen teniendo acceso a la cuenta de WhatsApp, y retirando ese acceso. Si aun así persiste, toca abrir un caso con el soporte de Meta.
Problemas con la verificación de la empresa
Meta no consigue verificar la empresa porque el nombre legal, el nombre comercial o los datos del negocio no coinciden entre los documentos, la web y el portafolio. Es especialmente frecuente cuando el nombre comercial (la marca) es distinto del nombre legal de la sociedad o del autónomo.
Cómo lo resolvemos: dejando los datos exactamente iguales en todos los sitios antes de enviar la verificación, y asegurándonos de que la web muestra el nombre legal y la dirección (por ejemplo, en el aviso legal).
Conflicto de divisas (por ejemplo, dólares australianos y euros)
Nos hemos encontrado cuentas de WhatsApp Business creadas con una divisa que no era el euro, como el dólar australiano, mientras el método de pago estaba en euros. El resultado: errores al pagar y al conectar.
Cómo lo resolvemos: la divisa de la cuenta se elige al crearla y no siempre se puede cambiar después con facilidad, así que lo mejor es crearla en euros desde el principio. Si ya está creada en otra divisa, hay que revisar en Meta si se puede migrar o si conviene crear una cuenta nueva.
¿Prefieres que lo montemos nosotros?
En Auriia Studio nos encargamos de todo el alta de la API oficial de WhatsApp Business y construimos encima el chatbot con IA, el seguimiento de leads o las automatizaciones que necesites, conectado con tus herramientas.
Fuentes: documentación oficial de Meta sobre primeros pasos con la Cloud API, números de teléfono, límites de mensajes, precios y coexistencia. Consultada en octubre de 2026.