Error 190 de Facebook: token de acceso no válido o vencido
El error 190 de Facebook significa que el token de acceso ya no es válido. El mensaje de Meta dice Invalid OAuth 2.0 Access Token, o empieza con Error validating access token, seguido del motivo, como Session has expired. La solución es obtener un token nuevo, que para una Página normalmente significa que alguien con un rol en la Página vuelva a iniciar sesión. Un subcódigo, cuando aparece, indica el motivo.
easyCoexistence llama a cada Página conectada con su propio token de Página y verifica la Página cada 6 horas.
El código de la Graph API para un token de acceso vencido; la acción recomendada por Meta es obtener uno nuevo.
Subcódigo enviado cuando una persona cerró sesión o cambió su contraseña: The session is invalid because the user logged out.
Subcódigo para un token de Página cuyo usuario no tiene un rol adecuado en la Página.
Los tokens de acceso de Página de larga duración no tienen fecha de vencimiento; solo vencen o se invalidan bajo ciertas condiciones.
Facebook no notifica a una app cuando uno de sus tokens de acceso deja de ser válido.
¿Qué significa el error 190 en una Página de Facebook?
Meta ya no acepta el token de acceso en la petición. Su guía de errores de la Graph API lista el 190 como token de acceso vencido, con una sola solución: obtener un token de acceso nuevo. Las referencias de Meta para fotos y videos de Página describen el código como Invalid OAuth 2.0 Access Token, y su guía para enviar mensajes de Messenger indica generar un nuevo token de acceso de Página.
¿Qué significan los subcódigos?
Cuando el error viene con un subcódigo, la tabla de subcódigos de autenticación de Meta indica por qué se rechazó el token, y su guía de depuración de tokens muestra el mensaje que acompaña a algunos de ellos:
- 463, Expired: el token ha vencido. El mensaje dice Error validating access token: Session has expired on, seguido de la fecha.
- 467, Invalid Access Token: el token ha vencido, fue revocado o es inválido por otro motivo.
- 460, Password Changed: Error validating access token: The session is invalid because the user logged out. La persona cerró sesión o cambió su contraseña, y vuelve a iniciar sesión.
- 458, App Not Installed: Error validating access token: User {user-id} has not authorized application {app-id}. La persona debe autenticarse de nuevo.
- 459, User Checkpointed, y 464, Unconfirmed User: la persona debe iniciar sesión en facebook.com para corregir un problema.
- 492, Invalid Session: la persona detrás del token de Página no tiene un rol adecuado en la Página.
¿Los tokens de Página de Facebook vencen?
No por calendario, cuando provienen de un token de usuario de larga duración. La guía de Meta sobre tokens de larga duración indica que ese token de usuario generalmente dura unos 60 días, mientras que los tokens de acceso de Página de larga duración no tienen fecha de vencimiento y solo vencen o se invalidan bajo ciertas condiciones. Su guía de depuración de tokens añade que los tokens pueden invalidarse antes de su vencimiento previsto por eventos relacionados con la seguridad.
¿Cómo se soluciona?
Hay que obtener un token nuevo, que para una Página viene de un nuevo inicio de sesión. Meta emite un token de Página solo a una persona con un rol en la Página, así que si quien la conectó ya no está o perdió ese rol, en su lugar debe iniciar sesión alguien que todavía administre la Página. Con el subcódigo 459 o 464, la persona primero inicia sesión en facebook.com y resuelve lo que pide Facebook, y luego vuelve a iniciar sesión.
¿Cómo detectarlo antes de que falle una llamada?
Verificando el token periódicamente. Facebook no avisa a una app cuando un token deja de funcionar, así que una petición regular con el token de Página, como leer el id y el nombre de la Página, detecta un 190 antes de que una publicación o una respuesta de Messenger dependa de él. El endpoint debug_token de Meta también indica si un token es válido, cuándo vence y los permisos que tiene.
curl "https://graph.facebook.com/<PAGE_ID>?fields=id,name&access_token=<PAGE_ACCESS_TOKEN>"
# Valid: the Page comes back
{"id": "<PAGE_ID>", "name": "<PAGE_NAME>"}
# Rejected: code 190, with a subcode when Meta gives one
{"error": {"type": "OAuthException", "code": 190, "error_subcode": 460, "message": "..."}}Errores comunes
- Reintentar la llamada. Un token rechazado sigue rechazado, y solo un token nuevo de un inicio de sesión nuevo elimina el error.
- Suponer que un token de Página dura para siempre. No tiene fecha de vencimiento, pero Meta igual invalida tokens bajo ciertas condiciones, y el error 190 es la forma en que eso se manifiesta.
- Volver a conectar la Página con una cuenta que no tiene rol en ella. Meta solo entrega tokens de Página a personas con un rol en la Página.
- Guardar tu propia copia del token de Página. Tras un inicio de sesión nuevo, la copia guardada sigue siendo la rechazada, así que obtén el token actual en su lugar.
Cuando Meta responde 190, durante una verificación o cualquier otra llamada, la conexión se marca de inmediato para reconectar y recibes un correo, y las herramientas indican a tu IA que la Página necesita volver a conectarse. Iniciar sesión desde el panel devuelve la misma conexión con un token nuevo. De US$ 9 a US$ 0.75 por conexión al mes, con descenso al agregar conexiones, y los primeros 3 días gratis.
Preguntas frecuentes
¿Qué significa Error validating access token?
Es el inicio del mensaje de Meta para el error 190: el token de la petición ya no es válido. El resto del mensaje indica el motivo, como una sesión vencida o un cierre de sesión.
¿Cambiar mi contraseña de Facebook rompe el token de Página?
Sí. Un cierre de sesión o un cambio de contraseña lo invalida, con el subcódigo 460, y alguien con un rol en la Página tiene que volver a iniciar sesión.
¿Qué significa el subcódigo 492?
La persona cuyo inicio de sesión produjo el token de Página no tiene un rol adecuado en la Página. Alguien que administre la Página tiene que volver a conectarla.
¿Se puede renovar un token de Página después del error 190?
No. La solución de Meta es un token de acceso nuevo, y en una Página eso viene de que alguien con un rol en la Página vuelva a iniciar sesión.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el