Error 0 de WhatsApp: no se puede autenticar al usuario de la app
El código de error 0 indica que Meta no pudo autenticar al usuario de la app asociado al token de acceso. La descripción de Meta dice: "We were unable to authenticate the app user." El token caducó, fue invalidado o el usuario bloqueó todas las apps para impedirles acceder a sus datos. La solución es obtener un nuevo token de acceso, no reintentar.
El código de Meta para "We were unable to authenticate the app user."
El token caducó, fue invalidado o el usuario cambió una configuración que bloquea todas las apps.
El código independiente que Meta menciona para un token de acceso caducado.
¿Qué significa el código de error 0 de WhatsApp?
Significa que la plataforma recibió una petición y no pudo asociarla con un usuario de la app en el que confía.
Meta incluye el código 0 entre los errores de autorización de la referencia de errores de Cloud API, con el texto de detalles "We were unable to authenticate the app user." Todas las posibles causas que indica están relacionadas con el token: caducó, fue invalidado o la persona que lo concedió cambió una configuración que impide a todas las apps acceder a sus datos.
Nada de esa lista se refiere al número de teléfono, a la cuenta de WhatsApp Business ni al mensaje enviado. La petición no llegó lo bastante lejos como para comprobar ninguno de esos elementos.
¿Cómo se soluciona el error 0?
Obtén un nuevo token de acceso. Ese es el remedio que indica Meta y es el único que funciona.
Antes de reemplazarlo, determina cuál de las tres causas se produjo, porque cada una volverá a aparecer si se ignora. Un token de usuario con una duración corta caducará de nuevo según lo previsto. Un token invalidado seguirá fallando hasta que alguien conceda acceso otra vez. Si el usuario desactivó por completo el acceso de las apps, debe activarlo de nuevo antes de que funcione cualquier token de ese usuario.
Para envíos de servidor a servidor, la guía de tokens de acceso de Meta recomienda tokens de System User, que describe como duraderos y adecuados para servicios automatizados que no requieren intervención del usuario.
¿El error 0 es igual que el error 190?
En la práctica se superponen y Meta los incluye por separado.
El error 190 contiene el texto de detalles "Your access token has expired." El error 0 es más amplio: abarca un token caducado, uno invalidado y un usuario que bloqueó por completo el acceso de las apps. Ambos aparecen en la misma tabla de autorización y se solucionan obteniendo un token nuevo.
La diferencia práctica está en el diagnóstico. Un 190 indica que el token caducó. Un 0 indica que la autenticación falló y obliga a determinar por qué. Conviene hacerlo antes de emitir un reemplazo que vuelva a fallar exactamente de la misma manera una hora después.
Errores comunes
- Reintentar la misma petición. Un token no autenticado sigue sin estar autenticado, por lo que cada reintento devuelve de nuevo el código 0.
- Volver a conectar el número. El número nunca se comprobó, así que configurarlo otra vez solo da trabajo al propietario del negocio sin cambiar nada.
- Emitir un token de usuario nuevo y de corta duración para un proceso backend. Caducará según lo previsto y el error volverá a aparecer.
EasyCoexistence guarda un segundo token para cada conexión. Si una credencial es rechazada, la otra aún puede leer la cuenta y mostrar si el número está bien.
Preguntas frecuentes
¿El error 0 significa que desconectaron mi número?
No. Las causas que Meta da para el código 0 están relacionadas con el token de acceso. El número y la app de WhatsApp Business del teléfono no intervienen.
¿Dónde está documentado el error 0?
En la tabla de errores de autorización de la referencia de códigos de error de Cloud API de Meta. Cloud API se basa en Graph API, que usa el mismo formato de error.
¿Esperar hará que desaparezca el error 0?
No. Un token caducado o invalidado no se recupera por sí solo. Hace falta un token nuevo.
¿Cómo compruebo qué puede hacer un token?
Usa el depurador de tokens de acceso de Meta o el endpoint debug_token. Ambos muestran si el token es válido, cuándo caduca y qué permisos tiene.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el