# Error 0 de WhatsApp: no se pudo autenticar — solución

URL: https://wa.genuka.com/es/docs/errors/0
Language: Spanish

> 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#authorization-errors)

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](https://developers.facebook.com/docs/graph-api/guides/error-handling)).

### ¿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](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#user-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.

```json title="409 — POST /api/v1/messages"
{
  "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.

1. **Deja de reintentar.** `retryable: false`: nada cambiará hasta que cambie el token.
2. **Contacta al soporte de Genuka** con el encabezado `x-request-id` y `meta.traceId`.
3. **Verifica el número** con `GET /api/v1/connections`. `disconnected` significa 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](https://wa.genuka.com/es/docs/onboarding); un número liberado necesita de nuevo un espacio
   libre; una cuenta eliminada, o desactivada por Meta ([error 368](https://wa.genuka.com/es/docs/errors/368)), no se
   restablece así. El evento `account_update` reenviado a tus webhooks te indica qué caso aplica.

### Si llamas a la Cloud API con tu propio token

1. **Pasa el token por el depurador.** El
   [depurador de tokens de acceso](https://developers.facebook.com/tools/debug/accesstoken/) muestra
   si sigue siendo válido, quién es su propietario y qué permisos tiene.
2. **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](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens)).
   Genéralo con `business_management`, `whatsapp_business_management` y
   `whatsapp_business_messaging`.
3. **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](https://wa.genuka.com/es/docs/errors/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 respuestas
  `meta.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](https://wa.genuka.com/es/docs/errors/190): el token expiró.
* [200](https://wa.genuka.com/es/docs/errors/200): el token es válido pero no tiene acceso a la cuenta o al permiso.
* [10](https://wa.genuka.com/es/docs/errors/10): permiso no otorgado o retirado.
* [3](https://wa.genuka.com/es/docs/errors/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

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Access tokens](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens)
* [Meta — Graph API, Handling errors](https://developers.facebook.com/docs/graph-api/guides/error-handling)
