Error 0 de WhatsApp: no se pudo autenticar — solución
Error 0 de WhatsApp "We were unable to authenticate the app user": token expirado o invalidado, o acceso cortado. Cómo corregirlo, y el caso de Genuka WA.
El error 0 de WhatsApp significa que Meta no pudo autenticar al usuario que está detrás del token de acceso. En la práctica, el token expiró, fue invalidado o su propietario impidió que las aplicaciones accedan a sus datos. Se corrige igual que el error 190: con un token nuevo, idealmente un token de usuario del sistema que no dependa de ninguna persona.
¿Qué significa el error 0?
Es la primera fila de los errores de autorización de la Cloud API:
"We were unable to authenticate the app user." — Meta, códigos de error de la Cloud API
Meta lo explica así: "Typically this means the included access token has expired, been
invalidated, or the app user has changed a setting to prevent all apps from accessing their data."
(Normalmente significa que el token de acceso incluido expiró, fue invalidado o que el usuario de
la aplicación cambió un ajuste para impedir que todas las aplicaciones accedan a sus datos). La
solución sugerida es obtener un nuevo token de acceso, con una referencia a los tokens de usuario
del sistema. La documentación general de Graph describe el mismo síntoma para los errores
OAuthException sin subcódigo: el estado de inicio de sesión o el token expiró, fue revocado o no
es válido por otro motivo
(Meta, gestión de errores de la Graph API).
¿Error 0 o error 190?
| Error 0 | Error 190 | |
|---|---|---|
| Texto de Meta | "We were unable to authenticate the app user." | "Your access token has expired." |
| Qué falla | El usuario detrás del token, o el token en sí | El token, expirado o invalidado |
| Solución de Meta | Un nuevo token de acceso | Un nuevo token de acceso |
En ambos casos, la misma solicitud con el mismo token siempre fallará.
¿Cuándo aparece el error 0?
- El token expiró o fue invalidado, por ejemplo un token de usuario generado desde la página API Setup del panel de la aplicación, que Meta hace expirar en pocas horas (Meta, Access tokens).
- El token depende de una persona que cambió sus ajustes. Un token de usuario está ligado a la cuenta de Facebook de quien lo generó: si esa persona corta el acceso de las aplicaciones a sus datos, el token deja de funcionar.
- El token fue revocado por Meta.
¿Dónde lo ves en Genuka WA?
Genuka WA clasifica el error 0 en la clase config y lo trata como una credencial inservible: en
una campaña MARKETING no activa el respaldo de la Marketing Messages API hacia /messages, que
solo duplicaría el fallo y ocultaría la causa real.
{
"error": "send_config",
"message": "We were unable to authenticate the app user.",
"meta": {
"errorClass": "config",
"retryable": false,
"code": 0,
"traceId": "AbC…"
}
}En POST /api/v1/templates, el mismo error vuelve como 403 meta_rejected.
¿Cómo corrijo el error 0?
Si usas Genuka WA
No tienes ningún token de Meta que renovar: cada llamada en tu número sale con el token de usuario del sistema de Genuka, que no depende de ninguna persona y no tiene fecha de expiración. Por lo tanto, un error 0 le corresponde corregirlo a Genuka.
- Deja de reintentar.
retryable: false: nada cambiará hasta que cambie el token. - Contacta al soporte de Genuka con el encabezado
x-request-idymeta.traceId. - Verifica el número con
GET /api/v1/connections.disconnectedsignifica que Meta informó que la cuenta ya no está compartida con Genuka, o que fue eliminada, o que tú mismo liberaste el número. Un cliente que retiró el acceso lo restablece con el enlace de conexión; un número liberado necesita de nuevo un espacio libre; una cuenta eliminada, o desactivada por Meta (error 368), no se restablece así. El eventoaccount_updatereenviado a tus webhooks te indica qué caso aplica.
Si llamas a la Cloud API con tu propio token
Pasa el token por el depurador. El depurador de tokens de acceso muestra si sigue siendo válido, quién es su propietario y qué permisos tiene.
Reemplázalo por un token de usuario del sistema. Meta los describe como de larga duración y
capaces de representar un servicio automatizado sin intervención de un usuario, a diferencia de
los tokens de usuario
(Meta, Access tokens).
Genéralo con business_management, whatsapp_business_management y
whatsapp_business_messaging.
Asígnale las cuentas. Sin acceso a la cuenta de WhatsApp y a la cuenta de mensajería, el nuevo token recibe un error 200 en lugar del 0.
¿Cómo evito el error 0?
- Nada de tokens personales en producción. La salida de un empleado, un cambio de contraseña o un ajuste de privacidad no deben poder detener tus envíos.
- Vigila la clase
config. En Genuka WA, un aumento repentino de respuestasmeta.errorClass: "config"en varios números a la vez apunta a un problema de credenciales, no de contenido. - Guarda el
traceId. Es lo que pide el soporte de Meta, y según la documentación de Graph el identificador expira pronto.
Códigos de error relacionados
- 190: el token expiró.
- 200: el token es válido pero no tiene acceso a la cuenta o al permiso.
- 10: permiso no otorgado o retirado.
- 3: falta una capacidad o un permiso para este endpoint.
Preguntas frecuentes
¿Debo reintentar una llamada rechazada con el error 0?
No. El problema es el token: la misma solicitud fallará igual hasta que se reemplace.
¿Mi clave API de Genuka está comprometida?
No. El error 0 se refiere al token de Meta, no a tu clave pk_live_…. Una clave rechazada produce
un 401 invalid_token de Genuka.
¿Por qué mi token funcionaba ayer?
Porque un token de usuario expira en pocas horas, o deja de funcionar en cuanto su propietario cambia sus ajustes. Un token de usuario del sistema no tiene esa debilidad.
Fuentes
Códigos de error de WhatsApp Cloud API: causas y soluciones
Códigos de error de WhatsApp Cloud API explicados: qué significan 131047, 131026, 130429, 132001, 141010 y los demás, y si conviene reintentar.
Error 3 de WhatsApp: falta una capacidad o un permiso
Error 3 de la Cloud API de WhatsApp (Capability or permissions issue): en qué se diferencia de los errores 0, 10, 190 y 200, y cómo corregirlo.