Integración de WhatsApp Business API en España: Guía Completa 2026

Lee también: Si lo que buscas es la visión de negocio, no la técnica, lee automatización de WhatsApp para negocios. Esta guía es para quien necesita integrar la API.

Qué es WhatsApp Business API y en qué se diferencia de la app gratuita

WhatsApp Business API (oficialmente WhatsApp Business Platform) es la versión de WhatsApp pensada para integrarse con sistemas externos: CRM, ecommerce, helpdesk, plataformas de mensajería o un agente de IA personalizado. No tiene interfaz propia. Todo se opera vía API REST contra los endpoints de Meta o vía la consola de un proveedor (BSP).

La confusión más habitual en pymes españolas es mezclar tres productos distintos:

• WhatsApp: la app personal. Una cuenta por número, un dispositivo principal. No permite uso comercial intensivo.
• WhatsApp Business app: aplicación gratuita, pensada para autónomos. Catálogo, etiquetas, respuestas rápidas. No tiene API y no permite conectar varios agentes ni integraciones reales.
• WhatsApp Business API (Cloud API): infraestructura sobre la que se construyen integraciones reales. Multiagente, conectable a CRM, soporte de plantillas verificadas, métricas y webhooks.

El cambio más importante de los últimos meses: desde el 23 de octubre de 2025, Meta retiró por completo la WhatsApp Business On-Premises API. La única alternativa oficial en 2026 es la Cloud API, alojada en infraestructura de Meta. Esto simplifica la integración (no hay que mantener servidores propios) y hace obligatorio replantear cualquier proyecto antiguo que siguiese usando contenedores On-Premises.

Para una empresa que opera en España, integrarse con la Cloud API significa: número de teléfono dedicado registrado en Meta Business, un BSP que gestione el alta y la facturación, plantillas de mensaje aprobadas para cada caso de uso fuera de la ventana de servicio, y un sistema receptor (CRM o middleware) que procese los webhooks entrantes y dispare las respuestas.

Requisitos para integrar WhatsApp Business API en España en 2026

Antes de elegir BSP o pedir presupuesto, conviene ordenar los requisitos reales. Llegar a la conversación comercial sin tenerlos preparados es lo que retrasa la mayoría de proyectos en pymes españolas.

1. Cuenta de Meta Business Manager verificada

Es el contenedor donde vive la cuenta de WhatsApp Business. La verificación de empresa exige documentación oficial: certificado del Registro Mercantil, NIF, factura de servicios a nombre de la empresa con la dirección registrada y, en algunos sectores, alta en el IAE. Meta tarda entre 2 y 7 días hábiles en aprobar. Sin verificación de empresa hay límites duros: no se pueden enviar más de 250 mensajes iniciados por la empresa al día y no se accede al display name oficial.

2. Número de teléfono dedicado

El número que se conecta a la API queda asociado en exclusiva a esa cuenta y deja de poder usarse en la app de WhatsApp normal o en WhatsApp Business app. Para no romper la operación, lo recomendable es portar el número con anticipación o dar de alta uno nuevo. Funciona cualquier formato: fijo geográfico español, móvil 6/7 o internacional. El requisito es que pueda recibir un código de verificación por SMS o llamada al hacer el alta.

3. Display name aprobado

Es el nombre comercial que ven los clientes en la conversación. Meta lo revisa manualmente y rechaza nombres genéricos ("Atención", "Reservas"), nombres no relacionados con la marca o con marcas registradas que no son del solicitante. La aprobación puede tardar entre 1 y 3 días hábiles.

4. Plantillas de mensaje (message templates)

Para enviar mensajes fuera de la ventana de 24 horas que abre el cliente, hay que usar plantillas pre-aprobadas por Meta. Cada plantilla se clasifica en una de cuatro categorías: marketing, utility, authentication o service. La categoría afecta directamente al precio (las de marketing son las más caras) y al ratio de aprobación (las de marketing son las más rechazadas si no cumplen las reglas de opt-in).

5. Cumplimiento legal: RGPD y consentimiento de opt-in

Esto se olvida más veces de las que se debería. En España aplica el RGPD y la LSSI-CE. Antes de enviar el primer mensaje a un cliente, hay que poder demostrar el consentimiento explícito para recibir comunicaciones por WhatsApp: checkbox no premarcado en formulario web, opt-in por SMS verificable, mensaje entrante del propio cliente, etc. Meta puede pedir prueba del opt-in si llegan reportes de spam, y la cuenta puede ser bloqueada en horas si la calidad cae.

Para más detalle sobre la base legal y los flujos de consentimiento, consulta nuestra guía de WhatsApp como CRM para pymes.

Cómo elegir BSP: Cloud API directa vs proveedor con consola

Meta no vende la API a empresas finales. La distribución se delega en BSPs (Business Solution Providers) certificados. En 2026 hay dos rutas razonables y una que conviene evitar.

Ruta A: Cloud API directa, sin BSP intermedio (técnica)

Es posible registrar una cuenta de WhatsApp Business directamente desde Meta Business Manager y consumir la Cloud API contra los endpoints oficiales. La infraestructura es gratuita: solo se paga a Meta el coste por mensaje. Requiere equipo técnico capaz de integrar la API, gestionar la rotación de tokens, los webhooks, las plantillas y las quality ratings. Es la opción más barata pero también la que más responsabilidad asume el cliente. Bueno para empresas con stack técnico propio y volumen alto.

Ruta B: BSP oficial con consola (recomendada para pymes)

Un BSP certificado se encarga del alta, la verificación, la gestión de plantillas, el alojamiento del CRM o helpdesk, el routing a agentes humanos y la facturación. Cobra un margen sobre el coste de Meta y, en muchos casos, una cuota mensual de plataforma. Esta es la ruta que tiene sentido para más del 90% de las pymes españolas. Para verificar si un proveedor es oficial, hay un único sitio fiable: el directorio de partners de Meta dentro del Business Help Center. Si el proveedor no aparece ahí, no es oficial.

Ruta C: pasarelas no oficiales (a evitar)

Existen herramientas que conectan a WhatsApp por scraping del cliente web o emulando la app personal. Son ilegales según los términos de servicio de Meta. La cuenta puede ser bloqueada sin aviso, con pérdida total del número y del historial de conversaciones. Para una empresa que basa su atención al cliente en WhatsApp, este riesgo no es asumible.

Criterios para evaluar un BSP

• Verificación oficial en el directorio de Meta: sin esto, descartar.
• Margen sobre el coste de Meta: los BSPs pueden añadir entre un 0% y un 40% sobre la tarifa base. Pedir tarifa por categoría (marketing, utility, authentication, service) y país.
• Cuota fija mensual: entre 0 y 200 euros al mes según volumen y funcionalidades.
• Setup fee: algunos BSPs cobran hasta 1.000 euros por la configuración inicial. Otros lo incluyen en el primer mes.
• Funcionalidades nativas: bandeja multiagente, plantillas con interfaz visual, métricas de quality rating, soporte en español.
• API sobre la API: si vas a integrar con un CRM o un agente de IA, asegúrate de que el BSP expone webhooks limpios y endpoints REST documentados, no solo la consola.

Costes reales de WhatsApp Business API en España en 2026

El modelo de precios cambió de raíz el 1 de julio de 2025. Antes se facturaba por conversación de 24 horas (todos los mensajes dentro de la ventana se cobraban como una sola unidad). Desde julio de 2025, Meta factura por cada mensaje plantilla entregado, con tarifa según categoría y país de destino. Ya no existen "conversaciones" como unidad de cobro.

Cuatro categorías de mensaje, cuatro precios distintos

• Marketing: promociones, lanzamientos, recuperación de carrito proactiva. Es la categoría más cara y la más restrictiva en términos de opt-in.
• Utility: confirmaciones de pedido, recordatorios de cita, notificaciones transaccionales. Coste sensiblemente menor que marketing (entre un 80% y un 90% más barata según país).
• Authentication: envío de OTP y códigos de verificación. Tarifa específica, generalmente la más barata por mensaje.
• Service: respuestas a un mensaje del cliente dentro de la ventana de 24 horas. Gratis para los primeros 1.000 mensajes de servicio al mes por número. A partir del mil mensaje, se cobra tarifa de servicio.

Para un destinatario en España, las tarifas orientativas de Meta en 2026 son del orden de céntimos de euro por mensaje en utility y service, y varios céntimos por mensaje en marketing. El precio exacto cambia cada trimestre y conviene mirarlo en el panel del BSP antes de hacer proyecciones. La regla práctica útil: un envío masivo a 10.000 contactos en categoría marketing en España puede costar entre 300 y 600 euros solo en tarifa de Meta, sin contar el margen del BSP.

Free tier: la ventana de 72 horas por click-to-WhatsApp

Detalle relevante para campañas en Meta Ads: cuando el cliente abre la conversación a través de un anuncio click-to-WhatsApp o de un botón de WhatsApp en una página de Facebook, la ventana de servicio gratuita se extiende a 72 horas en lugar de las 24 estándar. Esto vuelve a Meta Ads un canal de adquisición especialmente eficiente para WhatsApp si se diseña bien el funnel de respuesta.

Coste total de propiedad (TCO) en España

Concepto	Rango mensual
Tarifa de Meta por mensajes (volumen pyme medio)	30 - 250 €
Plataforma BSP (cuota fija)	0 - 200 €
CRM o software de bandeja unificada	50 - 500 €
Agente de IA (si aplica)	100 - 400 €
IVA (21% sobre todo lo anterior)	variable
TCO típico de pyme	250 - 1.500 €/mes
Setup inicial (one-time, si el BSP lo cobra)	0 - 1.000 €

A esto hay que sumar el IVA español (21%) sobre toda la factura. Una pyme con volumen medio (entre 5.000 y 20.000 mensajes mensuales) suele moverse entre 300 y 800 euros al mes incluyendo plataforma, mensajes y software de gestión.

Proceso de integración paso a paso (10 días)

Una integración limpia de WhatsApp Business API en una pyme española estándar lleva entre 7 y 14 días desde el día que se firma. Este es el cronograma realista, no el de marketing.

Día 1-2: Preparación de Meta Business y BSP

• Alta o limpieza de Meta Business Manager. Verificar que la empresa esté correctamente registrada con NIF.
• Solicitar verificación de empresa con documentación oficial. Esto se puede hacer en paralelo a otros pasos porque tarda varios días.
• Decidir el número que se va a portar o dar de alta. Si se va a portar, asegurarse de que ya no está en uso en WhatsApp app o WhatsApp Business app.
• Firmar contrato con el BSP elegido y crear la cuenta en su consola.

Día 3-4: Alta del número y display name

• El BSP solicita el alta del número en WhatsApp Business Account. Verificación por SMS o llamada.
• Configurar el display name (el que ven los clientes) y enviarlo a Meta para revisión.
• Subir la foto de perfil, descripción del negocio, web, dirección y categoría.
• Configurar webhooks: URL del backend que recibirá los mensajes entrantes y los eventos de estado (entregado, leído, fallo).

Día 5-7: Plantillas de mensaje y opt-in

• Identificar todos los flujos que envían mensajes fuera de la ventana de 24 horas (recordatorios, notificaciones, recuperación de carrito, encuestas).
• Redactar plantillas para cada flujo. Categorizar correctamente: marketing solo si es promocional, utility para todo lo transaccional.
• Enviar las plantillas a Meta para aprobación. Suele tardar 24-48 horas. Si se rechazan, ajustar y reenviar.
• Implementar mecanismo de opt-in en los puntos de captura: web, formulario, ecommerce, punto de venta. Guardar fecha, hora y fuente del consentimiento.

Día 8-9: Integración con CRM o agente de IA

• Conectar el endpoint de la Cloud API o del BSP con el CRM, helpdesk o agente de IA personalizado.
• Mapear los campos de cliente entre sistemas. Definir qué evento de WhatsApp dispara qué acción en el CRM.
• Configurar handoff a humano: en qué casos el agente escala a un equipo, cómo se transfiere el contexto, qué horario tiene cobertura humana.
• Pruebas con números internos antes de exponer al cliente final.

Día 10: Activación y monitorización

• Cambiar el número público al nuevo flujo. Notificar al equipo interno del cambio.
• Configurar alertas sobre quality rating: si baja a Medium o Low, hay que reaccionar en horas.
• Definir KPIs de la primera semana: tasa de entrega, tasa de lectura, tasa de respuesta dentro de 24 horas, número de mensajes que escalan a humano.

Errores frecuentes que cuestan la cuenta el primer mes

La mayoría de cuentas bloqueadas o restringidas en el primer mes no se debe a la API en sí, sino a errores evitables del cliente. Estos son los más comunes en pymes españolas.

1. Enviar plantillas a contactos sin opt-in verificable

Es el error más caro. Si el destinatario reporta el mensaje como spam o lo bloquea, la quality rating de la cuenta cae. Tres días con quality rating Low y Meta restringe el envío de plantillas marketing. Si la base de contactos viene de una migración antigua sin consentimiento documentado, hay que hacer una campaña de reopt-in antes del primer envío masivo.

2. Categorizar marketing como utility

Es tentador, porque utility es mucho más barata. Meta lo detecta automáticamente con su clasificador. Si una plantilla se envía como utility pero el contenido es promocional, Meta la recategoriza, cobra como marketing y la cuenta queda marcada. Reincidir trae sanciones más duras.

3. No configurar webhooks de estado

Sin escuchar los eventos sent, delivered, read y failed no hay forma de medir nada. Tampoco se sabe si la quality rating está bajando hasta que ya es tarde. La configuración del webhook de estado debería ser parte obligada del día 4 de la integración, no algo opcional para "más adelante".

4. Mezclar agente de IA y operador humano sin handoff claro

Un cliente que pregunta dos veces lo mismo, recibe dos respuestas distintas (una del agente, otra del humano que no vio el contexto) y se va. El handoff tiene que pasar el historial completo, marcar el ticket como humano-asignado y silenciar al agente para esa conversación hasta que se libere.

5. No tener plan B si la cuenta se bloquea

Aunque todo se haga bien, Meta puede revisar la cuenta y restringirla por motivos opacos. Tener un segundo número de respaldo en otra cuenta de WhatsApp Business y un canal alternativo (email, SMS) ya configurado evita quedarse sin atención al cliente durante días.

Caso de uso: agente de IA sobre Cloud API en una pyme española

El patrón más eficiente que vemos en pymes españolas en 2026 es el de Cloud API + BSP oficial + agente de IA personalizado conectado al CRM. El agente atiende el 70-85% de las conversaciones de forma autónoma, escala el resto a un humano y registra todo en el CRM con perfil unificado del cliente.

El stack típico que recomendamos en ZENIA para una pyme con entre 5.000 y 30.000 mensajes mensuales:

• Capa de mensajería: Cloud API de Meta vía BSP oficial.
• Capa de inteligencia: agente de IA personalizado entrenado con el catálogo, FAQs, calendario y políticas del negocio.
• Capa de datos: CRM con perfil unificado, historial omnicanal y segmentación dinámica.
• Capa operativa: bandeja multiagente para el equipo humano, con asignación automática y SLA por canal.
• Capa de medición: dashboard con tasa de resolución autónoma, tiempo medio de respuesta, NPS post-conversación y conversiones atribuidas.

Con este patrón, la integración técnica deja de ser el cuello de botella. El cuello de botella pasa a ser el diseño de los flujos de conversación y de los criterios de escalado, que es donde realmente se gana o se pierde la rentabilidad del proyecto.

Preguntas frecuentes sobre WhatsApp Business API en España

¿Puedo seguir usando mi número actual de WhatsApp Business app al integrar la API?

No simultáneamente. Una vez se da de alta el número en la Cloud API queda asociado en exclusiva. Hay que decidir si se porta el número existente (perdiendo acceso a la app de WhatsApp Business) o si se usa un número nuevo dedicado a la API. Lo más frecuente es portar el número principal y dejar el equipo trabajando desde la consola del BSP o desde el CRM.

¿Es legal enviar mensajes promocionales por WhatsApp en España?

Sí, siempre que se cumpla el RGPD y la LSSI-CE. Eso significa consentimiento explícito previo (opt-in registrado y documentado), información clara sobre la finalidad del tratamiento y mecanismo de baja accesible. Sin opt-in verificable, no solo se incumple la ley española: Meta también puede bloquear la cuenta.

¿Cuánto tiempo tarda la verificación de empresa en Meta?

Entre 2 y 7 días hábiles si la documentación es correcta. Los rechazos suelen deberse a discrepancias entre el nombre legal en el Business Manager y el del Registro Mercantil, a una factura de servicios desactualizada o a un dominio web que no apunta a la empresa verificada.

¿Qué BSP recomendáis para una pyme española de 10 a 50 empleados?

Depende del stack actual. Si la empresa ya usa un CRM que tiene integración nativa, el mejor BSP suele ser el que ese CRM ya soporta. Si no hay CRM ni stack previo, conviene elegir un BSP que ofrezca también la consola de mensajería para no tener que sumar otra herramienta. Lo importante es que esté en el directorio oficial de partners de Meta y que ofrezca tarifa transparente por categoría de mensaje.

¿Vale la pena la API si solo envío 500 mensajes al mes?

Probablemente no, salvo que se necesite multiagente real, integración con CRM o flujos automatizados con un agente de IA. Por debajo de 1.000 mensajes al mes, la app de WhatsApp Business gratuita cubre la mayoría de necesidades. La API empieza a tener sentido cuando hay multiagente, automatización o volumen sostenido.

¿Qué pasa si Meta bloquea mi cuenta?

Si la quality rating cae a Low durante 7 días, Meta restringe el envío de plantillas marketing. Si hay reportes graves de spam o violaciones de los términos, puede llegarse al bloqueo total del número. La recuperación pasa por abrir un ticket en Business Help Center con evidencia de los flujos de opt-in y de las prácticas correctas. Mejor prevenir: monitorizar quality rating semanalmente y reaccionar al primer descenso.

Conclusión: la integración es solo el principio

Integrar WhatsApp Business API en España en 2026 es un proyecto técnico medible, no un misterio. Cloud API ha simplificado la infraestructura, los BSPs han ampliado el catálogo de funcionalidades nativas y las plantillas con categorización transparente permiten predecir el coste con precisión razonable.

Donde se rompe la mayoría de proyectos no es en el alta de la cuenta. Es en lo que viene después: definir flujos de conversación que aporten valor, mantener la quality rating, conectar correctamente con el CRM y diseñar un agente de IA que no parezca el típico árbol de decisiones rígido. Esa parte requiere conocer a fondo el negocio y el comportamiento real del cliente, no solo la documentación de Meta.

Si vas a integrar la API este trimestre, conviene fijar de entrada tres cosas: número dedicado y portabilidad resueltas, BSP oficial elegido y plantillas mapeadas con sus categorías. El resto se encadena.