Error 190 de WhatsApp: token de acceso expirado
El error 190 significa que el token de acceso usado en la petición expiró o fue invalidado. Todas las llamadas fallan igual, lo que hace parecer que el número desapareció. No desapareció: la credencial se rompió, y el número suele estar bien.
Código de Meta para un token de acceso que expiró o fue invalidado.
Código de Meta para la misma condición, reportada como fallo de autenticación.
Credenciales que EasyCoexistence guarda por conexión, para que un rechazo pueda diagnosticarse.
¿Por qué un token expirado parece un número perdido?
Porque todas las peticiones fallan, y todas fallan de la misma manera.
Leer el número, revisar su salud, listar plantillas y enviar un mensaje dejan de funcionar al mismo tiempo. Desde fuera eso es indistinguible de que el número haya sido quitado de la cuenta, y una integración con una sola credencial no tiene manera de separar las dos situaciones. Mucha gente concluye que la desconectaron cuando no pasó nada de eso.
La diferencia importa porque las respuestas son opuestas. Una credencial rota se reemplaza. Un número quitado hay que reconectarlo, y eso exige al dueño del negocio y el teléfono.
¿Cómo se distingue una cosa de la otra?
Teniendo una segunda credencial capaz de leer la misma cuenta.
EasyCoexistence guarda el token del cliente y su propio token de System User en cada conexión. Cuando uno es rechazado, el otro lee la WhatsApp Business Account y resuelve cuál de los dos se rompió realmente. Un token de cliente rechazado con una segunda lectura que funciona significa que la credencial expiró y que el número está sano. Que fallen los dos significa que algo le pasó al número en sí.
Sin ese segundo lector, la única forma de distinguirlos es pedirle al dueño del negocio que revise, que es justo el tipo de interrupción que el monitoreo debería evitar.
¿Cómo se invalidan los tokens?
De varias maneras, y la mayoría de ellas no son deliberadas.
Los tokens tienen tiempo de vida y expiran solos. Un cambio de contraseña en la cuenta de Meta los invalida. Que alguien quite el acceso de una app en la Configuración del Negocio hace lo mismo, igual que Meta revocando un token que considera comprometido. Ninguna de estas cosas avisa antes, y ninguna es visible desde la app de WhatsApp Business del teléfono.
Por eso la validez del token pertenece al monitoreo y no a un manejador de errores. Para cuando un manejador de errores lo ve, los envíos ya fallaron.
Errores comunes
- Reconectar el número. Si el problema es el token, reconectar le pide al dueño del negocio un trabajo que nunca hizo falta.
- Tratarlo como intermitente y reintentar. Un token invalidado no se recupera solo.
- Depender de una sola credencial. Con un único token no hay forma de separar un fallo de credencial de un número perdido.
EasyCoexistence guarda dos tokens en cada conexión, así una credencial rechazada se diagnostica en vez de adivinarse, y degrada el token roto en lugar de soltar el número.
Preguntas frecuentes
¿El número sigue funcionando?
Por lo general sí. La app de WhatsApp Business no se ve afectado y el número en sí está intacto. Lo que se detuvo es el acceso por la API.
¿El error 0 es lo mismo?
En la práctica sí. Meta reporta esta condición bajo los dos códigos según el endpoint.
¿Reconectar lo arregla?
Lo haría, pero es la respuesta pesada a un problema liviano, y exige al dueño del negocio y el teléfono para algo que una credencial nueva resuelve.
¿Se puede lograr que un token no expire?
Los tokens de System User pueden ser de vida larga, que es parte de por qué guardar un segundo token resulta útil.
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