WhatsApp Business Platform: qué cambió además del nombre

Meta le cambió el nombre a su API de mensajería y casi nadie lo anunció en español. Lo que antes se buscaba como "WhatsApp Business API" ahora se llama WhatsApp Business Platform, y las búsquedas en Colombia ya lo reflejan: ese término creció más de 250% en el último año, mientras "chatbot de WhatsApp" cayó más de la mitad.

El cambio de nombre importa poco. Lo que sí importa es lo que revela sobre cómo está montada tu cuenta, porque el rebrand vino acompañado de una reorganización de quién posee qué. Ahí es donde los negocios se llevan la sorpresa.

Tu número no es tuyo del modo en que crees

Cuando conectas WhatsApp a la plataforma se crean tres cosas distintas que la mayoría confunde en una sola:

• El número de teléfono, registrado en la Cloud API.
• La WABA (WhatsApp Business Account), que agrupa números y plantillas.
• El portfolio de negocio —antes Business Manager—, que es quien posee la WABA.

Puedes tener el número funcionando, el token de acceso perfectamente vivo, todos los permisos concedidos, y aun así perder la cuenta de un momento a otro. El permiso no viaja con el token: viaja con la relación entre el portfolio y la WABA.

Lo que nos pasó, y por qué el diagnóstico obvio era el equivocado

En agosto, una cuenta que operábamos dejó de recibir y de enviar. El reflejo de cualquiera —el nuestro incluido— es sospechar del token: se venció, lo revocaron, se rotó mal.

El token estaba perfecto. Respondía is_valid: true, era de tipo SYSTEM_USER, sin fecha de expiración, y conservaba los dos permisos que hacen falta para operar. Lo que había pasado es que la WABA salió del portfolio que la administraba.

La comprobación son tres llamadas y toma dos minutos:

GET /me/assigned_whatsapp_business_accounts   →  data vacía   ← se fue el activo
GET /<ID de la WABA>                          →  400, error_subcode 33
GET /me                                       →  200          ← el token vive

Si el token estuviera muerto, la tercera fallaría con OAuthException 190. No falló. El subcode 33 con un token sano significa una cosa muy concreta: perdiste el acceso al activo, no la credencial.

El log terminó de contar la historia. Primero apareció (#133010) Account not registered y, unos veinte minutos después, el objeto dejó de existir. Ese orden es la huella de un número que se des-registra de la Cloud API, que es exactamente lo que ocurre cuando alguien lo migra a otro proveedor.

Conviene confirmarlo por dos vías, porque cada una puede mentir sola: la API con un segundo token de otra aplicación —si los dos dan el mismo subcode, no es la credencial— y el propio Business Manager, que sobre una cuenta perdida responde que no tienes acceso a ella.

Por qué esto se volvió más común con la Platform

Bajo el nombre viejo, mucha gente entró a la API a través de un proveedor que ponía su propio portfolio en el medio. El esquema actual empuja a que el negocio tenga su portfolio propio y comparta el acceso con quien lo opera. Es mejor arquitectura y es más frágil de administrar: cada vez que alguien reordena portfolios, hay accesos que se caen sin avisar.

Si en la configuración de tu portfolio, en la sección de cuentas de WhatsApp, aparece un mensaje del estilo "tal empresa es la propietaria", ya sabes de qué lado está el control. Y si el propietario es tu proveedor anterior, no hay arreglo posible desde tu lado: hay que pedir que la vuelvan a compartir.

Un detalle al mirar esa lista: es normal encontrar cuentas homónimas vacías, con cero personas, cero números y sin método de pago. Suelen ser cascarones de un intento de reconexión a medias. Averigua quién las creó antes de tocarlas.

La otra trampa: la cuenta vive, pero no llega nada

Hay un segundo caso que se ve idéntico a "está funcionando" y no lo está. Cada WABA necesita su propia dirección de webhook al suscribir la aplicación. Si se omite, la suscripción responde success: true, el número reporta CONNECTED y la calidad sale en verde — y no entra un solo evento.

Nos pasó al reconectar una cuenta en agosto: todo verde, cero mensajes durante días. El indicador que sirve no es la respuesta de la API, sino el saludo verificado en el log del servidor que recibe, más tráfico real llegando.

Y hay algo que casi nadie sabe: el token de verificación de cada cuenta no se puede leer nunca. Meta lo acepta al suscribir y jamás lo devuelve en una consulta. En el panel de la aplicación no hay nada que editar. Se actualiza repitiendo la suscripción con el valor nuevo, y mandando la dirección del webhook en la misma llamada: omitirla es justo lo que deja la cuenta apuntando al sitio equivocado.

Qué revisar esta semana

Si tienes WhatsApp conectado a un CRM o a un bot, tres comprobaciones:

1. ¿Quién posee la WABA? Míralo en la configuración del portfolio, no lo asumas.
2. ¿Tienes acceso de administrador al portfolio, o solo lo tiene el proveedor?
3. ¿El webhook de tu cuenta apunta a donde crees? Un success: true no lo prueba.

Las tres se responden en menos de diez minutos, y son la diferencia entre migrar de proveedor un martes cualquiera o quedarte sin número en plena campaña.

Si estás evaluando qué versión te toca, escribimos aparte en qué se diferencian WhatsApp, WhatsApp Business y la API. Y si prefieres que alguien la opere por ti con la cuenta a tu nombre, eso es exactamente lo que hacemos con la WhatsApp Business API.