Guía práctica · PotencIA · WhatsApp y CRM

WhatsApp Cloud API: qué es, cómo funciona y para qué sirve

La API oficial de Meta para conectar WhatsApp a tu software: cómo funciona, qué reglas trae y qué cuesta en España desde el 1 de octubre de 2026.

Erick José Piñerua JiménezPublicado el Actualizado el
El responsable de una clínica revisa mensajes en el ordenador de recepción con el móvil del negocio apoyado al lado.

WhatsApp Cloud API es la API oficial de Meta para que un programa envíe y reciba mensajes de WhatsApp sin un móvil de por medio, con los servidores puestos por Meta. Se paga por mensaje entregado según la tarifa de Meta y, desde el 1 de octubre de 2026, también las respuestas a partir de la número 1.001 de cada mes y número.

La documentación de Meta la define como la interfaz que «te permite enviar mensajes y llamar por WhatsApp de forma programática» (traducción nuestra del inglés). No es una aplicación que se instala ni una versión distinta de WhatsApp: es un servicio alojado por Meta al que se conecta tu software.

Debajo está qué la compone, cómo viaja un mensaje de ida y de vuelta, qué reglas trae de serie y en qué momento compensa —y en cuál no— para un negocio.

Las tres piezas que hay que entender

Casi todo el lío con este tema viene de mezclar tres cosas distintas que se llaman parecido.

  • La aplicación WhatsApp Business. La que se descarga en el móvil, gratuita, pensada para un negocio pequeño atendido por una persona. Tiene respuestas rápidas y mensajes de ausencia, pero por sí sola no se conecta con nada.
  • La Plataforma de WhatsApp Business. El producto de Meta para empresas que necesitan conectar WhatsApp con sus sistemas. No se usa: se integra.
  • Cloud API. La forma concreta de acceder a esa plataforma en la que la infraestructura la pone Meta. Es la vía habitual hoy y la que no obliga a mantener servidores propios.

Cuando alguien dice «tengo la API de WhatsApp» casi siempre se refiere a la tercera. Qué hace falta para acceder a ella y qué se puede hacer una vez dentro está desarrollado en la API oficial de WhatsApp para empresas.

Qué hace falta para que exista un número conectado

Tres objetos, y conviene saber sus nombres porque aparecen en cualquier configuración. El primero acaba de cambiar:

  1. Una cuenta de WhatsApp y una cuenta de mensajería. La cuenta de WhatsApp guarda el número y la identidad del negocio; la de mensajería, las plantillas, la facturación y las suscripciones a webhooks. Hasta septiembre de 2026 las dos cosas eran una sola: la cuenta de WhatsApp Business (WABA).
  2. Un número de teléfono dado de alta. Tiene que poder recibir una verificación y no puede estar en uso en la aplicación normal de WhatsApp; si está en la aplicación WhatsApp Business, hay dos caminos, que se explican en las preguntas del final. Al darlo de alta, Meta le asigna un identificador interno que es el que usará tu software, no el número en sí.
  3. Un identificador de aplicación y un token de acceso. Son las credenciales con las que tu servidor demuestra que puede actuar sobre ese número.

Sobre el primer punto, lo que cuenta Meta en su página sobre el nuevo modelo de cuentas, actualizada el 22 de septiembre de 2026: la WABA se parte en una cuenta de WhatsApp (WAAC, por sus siglas en inglés) y una cuenta de mensajería (Messaging account). El cambio está disponible desde el 23 de septiembre de 2026 y llega a todas las empresas hacia mediados de octubre, por fases. Los identificadores, las direcciones de la API y los tokens que ya existían siguen funcionando, y el identificador de la antigua WABA pasa a ser el de la cuenta de mensajería. Si en tu panel todavía ves «cuenta de WhatsApp Business», es que tu empresa aún no se ha migrado. Para quien programa la integración, la fecha que importa es otra: Meta anuncia que en el primer semestre de 2028 las llamadas que hoy usan el identificador del número tendrán que usar el de la cuenta de WhatsApp.

Cómo viaja un mensaje

Es más simple de lo que suena, y entenderlo evita casi todos los malentendidos comerciales.

Lo que sale

Tu servidor hace una petición al servicio de Meta indicando a qué número escribir y qué decir. Meta se encarga de entregarlo y responde con un identificador del mensaje. Ese identificador es el que después permite saber si se entregó y si se leyó.

Lo que entra

Aquí está la parte que más se malinterpreta: tu sistema no pregunta cada cierto tiempo si hay mensajes nuevos. Es Meta quien avisa. La documentación lo describe así: los webhooks «entregan cargas JSON a tu servidor para actualizaciones de estado de mensajes, mensajes entrantes y gestión asíncrona de errores» (traducción nuestra).

Un webhook es simplemente una dirección de tu servidor que tú declaras en la configuración. Cuando alguien te escribe, Meta llama a esa dirección con los datos del mensaje. Tu sistema lo recibe, decide qué hacer y responde. Todo el recorrido dura menos de lo que tarda el cliente en soltar el móvil.

Esa llamada va firmada, de modo que el servidor puede comprobar que viene de Meta y no de cualquiera que haya adivinado la dirección. Es una comprobación que conviene exigir a quien monte la integración.

Las reglas que vienen incluidas

Usar la vía oficial no es solo una decisión técnica: es aceptar un marco de uso que condiciona lo que se puede escribir y cuándo. Ese marco lo fijan la Política de mensajes de WhatsApp Business, actualizada el 23 de septiembre de 2026, y las Condiciones de Meta para la Plataforma de WhatsApp Business, con fecha de ese mismo día, que sustituyen a las antiguas condiciones de la Solución para Empresas de WhatsApp.

  • Consentimiento previo. La política solo permite escribir a quien te haya dado su número y haya aceptado recibir tus mensajes. No es una recomendación.
  • La ventana de 24 horas. Cuando una persona te escribe se abre un plazo de 24 horas durante el cual puedes responder con texto libre, y se reinicia cada vez que vuelve a escribir, según la documentación de los mensajes de servicio. Pasado ese plazo, no.
  • Plantillas fuera de la ventana. Para iniciar una conversación o retomarla después de ese plazo hace falta un mensaje de plantilla aprobado previamente por Meta, clasificado como marketing, utilidad o autenticación según los fundamentos de las plantillas.
  • Un coste por mensaje. Desde el 1 de julio de 2025, Meta cobra por mensaje entregado, no por conversación. Desde el 1 de octubre de 2026 cobra también los mensajes de servicio, que son las respuestas de texto libre dentro de la ventana y no se cobraban desde noviembre de 2024, y las plantillas de utilidad enviadas dentro de esa ventana, según su página sobre el cambio de precios. A cambio, cada número tiene 1.000 mensajes de servicio gratis al mes, que no se acumulan de un mes a otro.

En España, la tarifa de Meta en vigor desde el 1 de octubre de 2026 queda así, por mensaje entregado y en dólares:

  • Marketing: 0,0707 USD.
  • Utilidad: 0,0200 USD.
  • Autenticación: 0,0200 USD.
  • Servicio: 0,0200 USD, a partir del mensaje 1.001 de cada mes.

Si la cuenta factura en euros, son 0,0585 euros el marketing y 0,0166 cada una de las otras tres. Y un detalle que no encarece el servicio, sino que lo corta: sin un método de pago en la cuenta de mensajería, Meta entrega los mensajes de servicio del cupo gratuito, pero no los siguientes.

La consecuencia práctica: pasado el cupo, un asistente que resuelve una consulta en dos mensajes y otro que la resuelve en seis ya no cuestan lo mismo. El cálculo para un negocio que recibe cuarenta mensajes al día está en cuánto cuesta un CRM conversacional, y las reglas completas y cómo condicionan una automatización, en automatizar WhatsApp Business con IA.

En qué cambia respecto a atender desde el móvil

La diferencia no está en lo que ve el cliente —él sigue viendo una conversación de WhatsApp normal—, sino en todo lo demás:

  • Varias personas sobre el mismo número. El número deja de pertenecer a quien tiene el teléfono en la mano.
  • El historial no vive en un dispositivo. Si quien atendía se va de vacaciones, el contexto se queda.
  • Se puede conectar con otros sistemas. Una agenda, un CRM, un sistema de facturación. Los pasos para engancharla a un CRM están en cómo integrar WhatsApp Cloud API con un CRM.
  • No hay una sesión que se caiga. No depende de que un móvil tenga batería y cobertura.
  • Se puede automatizar de verdad. Un programa puede leer lo que entra y decidir qué hacer con ello.

Un ejemplo concreto

Una clínica dental recibe cuarenta mensajes al día en el móvil de recepción. Con la aplicación, dos personas se turnan ese teléfono, nadie sabe qué se le dijo a quién y las citas se apuntan a mano en otro sitio.

Con un número conectado por Cloud API, el mismo mensaje entra en un panel, por ejemplo el de un CRM con la API oficial de WhatsApp, donde la recepcionista ve quién escribe, qué se le dijo la última vez y en qué estado quedó. Si el paciente pregunta un horario, puede responderlo un asistente automático; si pregunta por un presupuesto, lo coge una persona. Y cuando se cierra una cita, queda en la agenda sin que nadie la copie.

No ha cambiado el canal. Ha cambiado lo que pasa con la información después.

Cuándo no compensa

Por honestidad, porque nosotros vendemos algo de esta familia:

  • Si recibes cinco mensajes a la semana. La aplicación gratuita te sobra.
  • Si atiende una sola persona y no piensa delegar. Buena parte de la ventaja es el trabajo en equipo.
  • Si lo que quieres es enviar promociones a una lista comprada. Eso no es un caso de uso, es una forma rápida de que te bloqueen el número.
  • Si nadie va a mantener la información del negocio. Un asistente que responde precios de hace un año hace daño.

Preguntas relacionadas

¿WhatsApp Cloud API es de pago?

El acceso a la plataforma no tiene cuota, pero los mensajes sí se facturan según la tarifa de Meta, que varía por país y por categoría. Desde el 1 de octubre de 2026 eso incluye las respuestas dentro de la ventana a partir de la número 1.001 de cada mes y número; las tarifas de España están más arriba. A eso se suma lo que cobre la herramienta que uses para gestionarlo, que es una cosa aparte; los CRM con WhatsApp que publican su cuota están comparados en otra pieza.

¿Pierdo mi número actual de WhatsApp?

Esta es la razón más frecuente por la que un negocio empieza por una conexión mediante código QR en lugar de por la vía oficial; las dos opciones, comparadas sin adjetivos, están en API oficial o conexión por QR. Si el número está en la aplicación WhatsApp Business, hay dos caminos:

  • Pasarlo a la plataforma. Se da de baja de la aplicación y se da de alta en Cloud API. El historial de conversaciones anterior no se migra, y por eso muchos negocios prefieren empezar con un número nuevo.
  • Conectarlo sin dejar la aplicación. Meta permite conectar a Cloud API un número que sigue en la aplicación WhatsApp Business, siempre a través de un proveedor que sea Solution Partner o Tech Provider; en soporte lo llaman coexistencia. Según su guía para incorporar usuarios de la aplicación, actualizada el 26 de junio de 2026, el número sigue funcionando en el móvil, se pueden sincronizar los chats individuales de los últimos seis meses y los mensajes se reflejan en los dos lados. Los grupos no se sincronizan, los mensajes temporales y las listas de difusión se desactivan en la aplicación, y el número queda limitado a 20 mensajes por segundo. Lo que se envía desde la aplicación sigue siendo gratis; lo que sale por Cloud API, se paga con la tarifa de arriba.

¿Necesito un programador?

Para integrarla directamente, sí: es una interfaz pensada para desarrolladores, y la propia documentación de Meta declara estar dirigida «a los desarrolladores que usan nuestras API» (traducción nuestra). La alternativa habitual es usar una herramienta que ya tenga la integración hecha.

¿Cuánto se tarda en tenerlo funcionando?

La parte de dar de alta el número y verificar el negocio depende de Meta y puede ir de unas horas a varios días. Lo que suele llevar más tiempo no es eso, sino decidir qué va a responder el sistema y con qué información.

Fuentes consultadas

Este artículo lo firma una parte interesada: PotencIA comercializa un CRM con WhatsApp integrado que funciona sobre esta misma vía oficial.