Erreur Facebook 190 : token d'accès invalide ou expiré
L'erreur 190 de Facebook signifie que le token d'accès n'est plus valide. Le message de Meta affiche « Invalid OAuth 2.0 Access Token », ou commence par « Error validating access token », suivi de la raison, comme « Session has expired ». La solution consiste à obtenir un nouveau token, ce qui, pour une Page, suppose en général qu'une personne ayant un rôle sur la Page se reconnecte. Un sous-code, lorsqu'il est présent, indique la cause.
easyCoexistence appelle chaque Page connectée avec son propre token de Page et vérifie la Page toutes les 6 heures.
Le code de l'API Graph pour un token d'accès expiré ; l'action recommandée par Meta est d'en obtenir un nouveau.
Sous-code envoyé lorsqu'une personne s'est déconnectée ou a changé son mot de passe : « The session is invalid because the user logged out ».
Sous-code pour un token de Page dont l'utilisateur n'a pas le rôle approprié sur la Page.
Les tokens d'accès de Page de longue durée n'ont pas de date d'expiration ; ils expirent ou sont invalidés uniquement dans certaines conditions.
Facebook ne notifie pas une application lorsqu'un de ses tokens d'accès est devenu invalide.
Que signifie l'erreur 190 sur une Page Facebook ?
Meta n'accepte plus le token d'accès présent dans la requête. Son guide des erreurs de l'API Graph classe 190 comme token d'accès expiré, avec une seule solution : en obtenir un nouveau. Les références de Meta pour les photos et vidéos de Page décrivent ce code comme « Invalid OAuth 2.0 Access Token », et son guide d'envoi de messages Messenger indique de générer un nouveau token d'accès de Page.
Que signifient les sous-codes ?
Lorsqu'un sous-code accompagne l'erreur, la table des sous-codes d'authentification de Meta indique pourquoi le token a été refusé. Son guide de débogage des tokens montre le message associé à certains d'entre eux :
- 463, Expired : le token a expiré. Le message affiche « Error validating access token: Session has expired on », suivi de la date.
- 467, Invalid Access Token : le token a expiré, a été révoqué ou est invalide pour une autre raison.
- 460, Password Changed : « Error validating access token: The session is invalid because the user logged out ». La personne s'est déconnectée ou a changé son mot de passe, et doit se reconnecter.
- 458, App Not Installed : « Error validating access token: User {user-id} has not authorized application {app-id} ». La personne doit être authentifiée à nouveau.
- 459, User Checkpointed, et 464, Unconfirmed User : la personne doit se connecter sur facebook.com pour régler un problème.
- 492, Invalid Session : la personne à l'origine du token de Page n'a pas le rôle approprié sur la Page.
Les tokens de Page Facebook expirent-ils ?
Pas selon un calendrier fixe lorsqu'ils proviennent d'un token utilisateur de longue durée. Le guide de Meta sur les tokens de longue durée indique qu'un tel token utilisateur dure en général environ 60 jours, alors que les tokens d'accès de Page de longue durée n'ont pas de date d'expiration et n'expirent ou ne sont invalidés que dans certaines conditions. Le guide de débogage des tokens précise que des tokens peuvent être invalidés avant leur échéance prévue à la suite d'événements liés à la sécurité.
Comment le corriger ?
Obtenez un nouveau token, qui, pour une Page, provient d'une nouvelle connexion. Meta n'émet un token de Page qu'à une personne ayant un rôle sur la Page : si la personne qui l'a connectée a quitté la Page ou perdu ce rôle, c'est une personne qui gère encore la Page qui doit se connecter à sa place. Avec le sous-code 459 ou 464, la personne doit d'abord se connecter sur facebook.com et répondre à ce que Facebook demande, puis se reconnecter.
Comment le détecter avant qu'un appel échoue ?
Vérifiez le token selon un calendrier régulier. Facebook ne prévient pas une application lorsqu'un token cesse de fonctionner ; une requête régulière avec le token de Page, par exemple la lecture de l'identifiant et du nom de la Page, révèle une erreur 190 avant qu'une publication ou une réponse Messenger n'en dépende. L'endpoint debug_token de Meta indique aussi si un token est valide, quand il expire et les permissions qu'il détient.
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": "..."}}Erreurs courantes
- Relancer l'appel. Un token rejeté reste rejeté : seul un nouveau token issu d'une nouvelle connexion supprime l'erreur.
- Croire qu'un token de Page dure éternellement. Il n'a pas de date d'expiration, mais Meta invalide quand même les tokens dans certaines conditions, et l'erreur 190 en est la manifestation.
- Reconnecter la Page avec un compte qui n'y a aucun rôle. Meta ne délivre des tokens de Page qu'aux personnes ayant un rôle sur la Page.
- Garder votre propre copie du token de Page. Après une nouvelle connexion, la copie stockée est toujours celle rejetée : récupérez plutôt le token actuel.
Lorsque Meta répond 190, pendant une vérification ou lors de tout autre appel, la connexion est aussitôt marquée à reconnecter et vous recevez un courriel ; les outils indiquent aussi à votre IA que la Page doit être reconnectée. Se connecter depuis le tableau de bord rétablit la même connexion avec un nouveau token. De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.
Questions fréquemment posées
Que signifie Error validating access token ?
C'est le début du message de Meta pour l'erreur 190 : le token présent dans la requête n'est plus valide. La suite du message donne la raison, comme une session expirée ou une déconnexion.
La modification de mon mot de passe Facebook casse-t-elle le token de Page ?
Oui. Une déconnexion ou un changement de mot de passe l'invalide, avec le sous-code 460, et une personne ayant un rôle sur la Page doit se reconnecter.
Que signifie le sous-code 492 ?
La personne dont la connexion a produit le token de Page n'a pas le rôle approprié sur la Page. Une personne qui gère la Page doit la reconnecter.
Peut-on rafraîchir un token de Page après l'erreur 190 ?
Non. La solution de Meta est un nouveau token d'accès, et pour une Page, celui-ci provient d'une personne ayant un rôle sur la Page qui se reconnecte.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le