FR
Guide des access tokens

Access token de l'API Facebook : tokens user, Page, app et system user expliqués

Comment obtenir chaque token, le prolonger jusqu'à environ 60 jours, le vérifier avec debug_token et gérer l'erreur 190, et comment une app SaaS peut se passer de la chaîne de gestion des tokens.

Vérification du token 200 OK
GETgraph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN}
applicationVotre app
is_validtrue
expires_atdans 60 joursuser token longue durée
data_access_expires_atdans 90 joursrenouvelé si l'utilisateur est actif
scopespublic_profilepages_show_list
TOKEN Pas de refresh token : revérifier, puis reconnecter
Réponse courte

Un access token de l'API Facebook est la chaîne que chaque appel à la Graph API exige. Vous obtenez un user token via Facebook Login (ou le Graph API Explorer pour vos tests), vous l'échangez sur votre serveur contre un token longue durée d'environ 60 jours, puis vous appelez /me/accounts pour obtenir les Page tokens. Il n'y a ni clé API ni refresh token : surveillez vos tokens avec debug_token et gérez l'erreur 190.

Pour un SaaS qui sert de nombreux clients, il existe un second modèle : les utilisateurs connectent leurs comptes Facebook via Unipile, et votre app ne détient jamais de token Meta.

Avec Unipile

Aucun token Meta à obtenir, prolonger ou déboguer

  1. 1

    Connecter le compte

    Votre utilisateur connecte une seule fois son compte Facebook ou sa Page via Hosted Auth. Ni app Meta, ni App Review.

  2. 2

    Appeler avec votre clé API

    Envoyez X-API-KEY avec l'account_id de l'utilisateur : GET /v2/{ACCOUNT_ID}/chats.

  3. 3

    Surveiller un seul statut

    Vérifiez products_connection_status ; si besoin, l'utilisateur se reconnecte via Hosted Auth.

Définition

Qu'est-ce qu'un access token de l'API Facebook ?

Meta définit un access token comme « une chaîne opaque qui identifie un utilisateur, une app ou une Page Facebook ». Chaque requête à la Graph API en porte un, et son type détermine pour le compte de qui vous agissez.

TokenAgit pourComment l'obtenirDurée de vie et usage
UserUne personne connectéeFacebook Login ou Graph API Explorer1 à 2 heures, ou environ 60 jours
PageUne Page Facebook/me/accounts avec le user token d'un adminSuit son user token
AppVotre app MetaAppel client_credentials, ou {APP_ID}|{APP_SECRET}Appels de serveur à serveur uniquement
System userVotre entrepriseParamètres de l'entrepriseSans expiration, ou 60 jours
ClientVotre app, dans le code clientTableau de bord de l'appPas un secret
User token
Agit pourUne personne connectée
Comment l'obtenirFacebook Login ou Graph API Explorer
Durée de vie et usage1 à 2 heures, ou environ 60 jours
Page token
Agit pourUne Page Facebook
Comment l'obtenir/me/accounts avec le user token d'un admin
Durée de vie et usageSuit son user token
App token
Agit pourVotre app Meta
Comment l'obtenirAppel client_credentials, ou {APP_ID}|{APP_SECRET}
Durée de vie et usageAppels de serveur à serveur uniquement
System user token
Agit pourVotre entreprise
Comment l'obtenirParamètres de l'entreprise
Durée de vie et usageSans expiration, ou 60 jours
Client token
Agit pourVotre app, dans le code client
Comment l'obtenirTableau de bord de l'app
Durée de vie et usagePas un secret

Instagram a son propre parcours : consultez notre guide token de l'API Instagram.

Source : le guide Access Tokens de Meta. Dernière vérification : 17 novembre 2026.

Obtenir un token

Comment obtenir un access token de l'API Facebook

Il n'existe pas de clé API Facebook : chaque appel utilise un access token. Pour vos tests, générez-en un pour votre propre compte dans le Graph API Explorer. En production, les utilisateurs se connectent à votre app Meta avec Facebook Login (for Business si vous avez besoin de leurs Pages), et votre serveur échange le code renvoyé contre un user access token.

Test, en 4 étapes

Graph API Explorer

  1. Ouvrez developers.facebook.com/tools/explorer
  2. Choisissez votre app Meta et « User Token »
  3. Ajoutez les permissions nécessaires
  4. Cliquez sur Generate Access Token et validez
Production, en 4 étapes

Facebook Login dans votre app Meta

  1. Créez une app Meta (App ID, App Secret)
  2. Envoyez les utilisateurs vers /dialog/oauth avec client_id, redirect_uri, state
  3. Ils accordent les permissions ; vous recevez un code
  4. Votre serveur appelle /oauth/access_token avec le code et l'App Secret

La réponse contient access_token, token_type et expires_in. D'autres personnes ne peuvent accorder des permissions qu'une fois que l'App Review a donné l'Advanced Access à votre app. Le parcours d'accès complet figure dans notre vue d'ensemble de l'API Facebook, et sa partie Pages dans notre guide de l'API Pages Facebook.

Source : le guide Manually Build a Login Flow de Meta (Graph API v27.0). Dernière vérification : 17 novembre 2026.

Token longue durée

Comment obtenir un access token longue durée

Envoyez le user token de courte durée à GET /oauth/access_token avec grant_type=fb_exchange_token, votre App ID et votre App Secret. La réponse contient un token longue durée et son expires_in, environ 60 jours. Meta est explicite : « Faites cet appel depuis votre serveur, pas depuis un client. »

  • Échangez avant l'expiration. « Vous ne pouvez pas utiliser un token expiré pour demander un token longue durée » : une fois le token court expiré, l'utilisateur doit se reconnecter.
  • Stockez l'expiration sous forme de date à côté du token.
  • Simple test ? L'Access Token Debugger propose un bouton Extend Access Token qui fait la même chose pour un token qui vous appartient.

Le cycle de vie du token en code

Les onglets 1 à 3 utilisent la Graph API de Meta ; l'onglet 4 utilise Unipile, sans token Meta.

# Server side only: this call carries your App Secret
curl -G "https://graph.facebook.com/oauth/access_token" \
  -d "grant_type=fb_exchange_token" \
  -d "client_id={APP_ID}" \
  -d "client_secret={APP_SECRET}" \
  -d "fb_exchange_token={USER_ACCESS_TOKEN}"

# Response (abridged)
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "expires_in": 5183944 }
# App access token, for server-to-server calls such as debug_token
curl -G "https://graph.facebook.com/oauth/access_token" \
  -d "client_id={APP_ID}" \
  -d "client_secret={APP_SECRET}" \
  -d "grant_type=client_credentials"

# Or pass it directly, without the call
access_token={APP_ID}|{APP_SECRET}
# Check any token with your app token
curl -G "https://graph.facebook.com/debug_token" \
  -d "input_token={LONG_LIVED_USER_TOKEN}" \
  -d "access_token={APP_ID}|{APP_SECRET}"

# Response (abridged)
{ "data": {
    "app_id": "{APP_ID}",
    "is_valid": true,
    "expires_at": 1800057600,
    "data_access_expires_at": 1802649600,
    "scopes": ["public_profile", "pages_show_list"]
} }
# No Meta token: your API key and the user's account_id
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
  --header "X-API-KEY: {API_KEY}"

# List the chats of the connected account
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {API_KEY}"
200 OK · user token longue durée, environ 60 jours
200 OK · jamais dans le code client ni les binaires
200 OK · is_valid, expires_at, data_access_expires_at
200 OK · un account_id, aucun token à échanger

Requêtes tirées des guides Long-Lived Access Tokens et Access Tokens de Meta. Unipile : documentation Facebook Pages.

Les Page tokens, en bref

Avec le user token longue durée d'un admin de Page, GET /me/accounts renvoie chaque Page avec son propre token, qui « n'a pas de date d'expiration et n'expire ou n'est invalidé que dans certaines conditions ». Détails dans notre guide de l'API Pages Facebook ; pour publier avec, voyez comment publier sur une Page avec son token.

Durée de vie

Combien de temps dure un access token Facebook ?

Selon Meta, un user token de courte durée vaut environ une à deux heures, et un token longue durée environ 60 jours. Les Page tokens obtenus à partir d'un token longue durée et certains system user tokens n'ont pas de date d'expiration. À part, votre accès aux données d'un utilisateur s'arrête après 90 jours d'inactivité.

Facebook Durées de vie des tokens, selon Meta
User token de courte durée1 à 2 heures
User token longue duréeEnviron 60 jours
Page token, issu d'un user token longue duréePas de date d'expiration
System user tokenJamais, ou 60 jours
Accès aux données de l'utilisateur90 jours après la dernière activité
L'expiration du token n'est pas celle de l'accès aux données

Meta indique que « la période d'expiration de l'accès aux données est de 90 jours, à compter de la dernière activité de l'utilisateur ». L'utilisateur reste connecté, mais votre app ne peut plus lire ses données tant qu'il ne l'a pas autorisée de nouveau.

Aucun token n'est permanent : un token « qui n'expire jamais » meurt quand même si l'utilisateur supprime votre app, change son mot de passe ou perd son rôle. Meta prévient : « Ne comptez pas sur le fait que ces durées de vie restent les mêmes. »

Sources : les guides Access Tokens, Long-Lived Access Tokens, Authorization vs. data access et system user tokens de Meta. Dernière vérification : 17 novembre 2026.

System user

System user access tokens pour les traitements de serveur à serveur

Un system user access token appartient à un system user de votre Business Manager, pas à une personne. Selon Meta, il permet à « votre app d'effectuer des actions automatisées et programmatiques sur des objets publicitaires ou des Pages ». Vous le générez dans les paramètres de l'entreprise.

Option 1

N'expire jamais

Aucun renouvellement, pour les cas où une fuite du token est un risque acceptable.

Option 2, recommandée

Expire dans 60 jours

Passez set_token_expires_in_60_days=true et renouvelez avec fb_exchange_token avant le 60e jour.

  • Même entreprise uniquement. Le system user et l'app appartiennent au même Business Manager, et « si l'utilisateur n'a pas d'accès, la requête est rejetée ».
  • Accès à la Marketing API d'abord : accès standard ou supérieur.

Sources : les guides Install apps and generate tokens et Access Tokens de Meta. Dernière vérification : 17 novembre 2026.

Débogage

Comment vérifier un access token Facebook avec debug_token

Appelez GET /debug_token?input_token={TOKEN} avec un app access token (ou le user token d'un développeur de l'app). L'appel renvoie la validité, l'expiration, la fin de l'accès aux données et les permissions accordées. Sans code, collez le token dans l'Access Token Debugger (developers.facebook.com/tools/debug/accesstoken).

Facebook Ce que renvoie debug_token
is_validLe token fonctionne-t-il encore.
expires_atExpiration du token, en timestamp Unix ; 0 signifie aucune date d'expiration.
data_access_expires_atFin de l'accès aux données, même avec un token valide.
scopesPermissions accordées ; granular_scopes ajoute les ID ciblés.
app_id, user_idPour qui le token a été émis.
profile_idL'ID de la Page, pour un Page token.

Pour vérifier qu'un access token Facebook est valide en production, lancez la requête de l'onglet 3 du bloc de code ci-dessus sur votre serveur, à intervalles réguliers, et stockez les deux dates avec chaque token. Une permission absente de scopes explique la plupart des bugs du type « ça marche chez moi, pas chez eux ».

Source : la référence debug_token de Meta (Graph API v27.0). Dernière vérification : 17 novembre 2026.

Erreurs

Erreurs d'access token Facebook : le code 190 et ses sous-codes

L'erreur 190 signifie que l'access token Facebook a expiré ou n'est pas valide. Elle revient sous forme d'OAuthException, et son error_subcode vous indique quoi demander à l'utilisateur. Réessayer avec le même token ne règle jamais le problème.

Facebook Ce que renvoie la Graph API

{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }

190 Lire error_subcode, garder fbtrace_id pour le support Meta
Sous-codeSignificationQue faire
458App non installéeReconnecter l'utilisateur
459Utilisateur bloqué par un contrôle de sécuritéL'utilisateur se connecte sur facebook.com
460Mot de passe modifiéReconnecter l'utilisateur
463Token expiréReconnexion, puis nouvel échange
464Utilisateur non confirméL'utilisateur se connecte sur facebook.com
467Token invalideReconnecter l'utilisateur
492Aucun rôle adéquat sur la PageNouveau token d'un admin actuel
Sous-code 458
SignificationApp non installée
Que faireReconnecter l'utilisateur
Sous-code 459
SignificationUtilisateur bloqué par un contrôle de sécurité
Que faireL'utilisateur se connecte sur facebook.com
Sous-code 460
SignificationMot de passe modifié
Que faireReconnecter l'utilisateur
Sous-code 463
SignificationToken expiré
Que faireReconnexion, puis nouvel échange
Sous-code 464
SignificationUtilisateur non confirmé
Que faireL'utilisateur se connecte sur facebook.com
Sous-code 467
SignificationToken invalide
Que faireReconnecter l'utilisateur
Sous-code 492
SignificationAucun rôle adéquat sur la Page
Que faireNouveau token d'un admin actuel

Dans un SaaS multi-clients, le 492 est un classique : l'admin qui a connecté une Page s'en va. Les autres codes figurent dans notre tableau des erreurs de l'API Facebook.

Source : le guide Graph API error handling de Meta. Dernière vérification : 17 novembre 2026.

Sécurité

Stocker et sécuriser les access tokens Facebook

Traitez chaque access token Facebook comme le mot de passe du compte qui se trouve derrière : gardez l'App Secret et les app tokens sur votre serveur, chiffrez les user tokens et Page tokens au repos, signez les appels serveur avec appsecret_proof, et supprimez les tokens dès qu'un client se déconnecte.

  • Les secrets, côté serveur uniquement. Meta : « N'intégrez jamais en dur des app access tokens dans le code client ou les binaires d'une app » et « N'utilisez les app access tokens que dans des appels de serveur à serveur. »
  • Les client tokens sont publics. Meta précise qu'ils « ne sont pas secrets » : ne vous en servez jamais pour autoriser une action sensible.
  • Signez les appels avec appsecret_proof. Meta le définit comme « un hachage sha256 de votre access token, avec votre app secret comme clé » ; activez Require App Secret dans le tableau de bord de l'app.
  • Chiffrement au repos, HTTPS en transit. Tenez les tokens à l'écart des logs et des URL.
  • Un enregistrement par token. Stockez l'utilisateur, la Page, l'app et expires_at.
  • Purge à la déconnexion. Supprimez le token quand un utilisateur part.

Sources : les guides Access Tokens et Securing Requests de Meta. Dernière vérification : 17 novembre 2026.

Avec Unipile

Oubliez la gestion des tokens : connectez les comptes Facebook de vos utilisateurs

Avec Unipile, chaque utilisateur connecte son compte Facebook une seule fois, via Hosted Auth. Les Pages qu'il gère arrivent sur le même account_id, et vous appelez l'API avec votre propre clé (X-API-KEY). Ni token Meta, ni app Meta, ni App Review de votre côté.

QuestionAccess tokens MetaCompte connecté Unipile
Ce que vous stockezUn token par utilisateur, plus un par Page, par admin et par appUn account_id par utilisateur et une clé API
Ce que vous surveillezexpires_at et data_access_expires_at pour chaque tokenUn statut par Page dans metadata.products_connection_status
Ce que vous renouvelezÉchange longue durée ou reconnexion avant le 60e jourAucun token Meta à échanger
En cas d'erreur 190Analyser le sous-code, puis demander à l'utilisateur de se reconnecterL'utilisateur se reconnecte via Hosted Auth si besoin
Ce que vous stockez
Tokens MetaUn token par utilisateur, plus un par Page, par admin et par app
UnipileUn account_id par utilisateur et une clé API
Ce que vous surveillez
Tokens Metaexpires_at et data_access_expires_at pour chaque token
UnipileUn statut par Page dans metadata.products_connection_status
Ce que vous renouvelez
Tokens MetaÉchange longue durée ou reconnexion avant le 60e jour
UnipileAucun token Meta à échanger
En cas d'erreur 190
Tokens MetaAnalyser le sous-code, puis demander à l'utilisateur de se reconnecter
UnipileL'utilisateur se reconnecte via Hosted Auth si besoin

Un compte connecté couvre les messages, les inbox de Pages, les posts, les commentaires et les réactions. Une Page peut répondre à ses conversations et publier des posts, mais ne peut pas lancer une conversation. Voir l'onglet 4 ci-dessus et notre page API Facebook Messenger.

Conformité

Chaque utilisateur connecte son propre compte

Unipile est une entreprise indépendante : ce n'est ni une app officielle de Meta, ni un Meta Partner. Unipile agit pour le compte de chaque utilisateur authentifié, et chaque utilisateur reste soumis aux conditions de Meta.

Développez sur Facebook sans pipeline de tokens

Chaque utilisateur relie son compte Facebook une seule fois ; vous utilisez une seule API pour Facebook, LinkedIn, WhatsApp et l'email. Essai gratuit de 7 jours.

Commission européenne
Réglementé par l'UE Digital Markets Act (DMA)

Chaque utilisateur connecte son propre compte, sans stockage de profils. Unipile n'est pas partenaire Meta. En savoir plus

Tous les endpoints de l'API Facebook au même endroit

Une fois le compte connecté, consultez tous les endpoints Facebook disponibles avec Unipile, ou lisez le guide complet de l'API Facebook pour les permissions, les limites et les erreurs.

FAQ sur l'access token de l'API Facebook

Réponses rapides sur la durée de vie des tokens, leur renouvellement, la vérification de leur validité, leur stockage et l'erreur 190.

Pas vraiment. Un user token longue durée vaut environ 60 jours. Les Page tokens qui en sont issus et certains system user tokens n'ont pas de date d'expiration, mais meurent quand même si l'utilisateur supprime votre app, change son mot de passe ou perd son rôle. Prévoyez un parcours de reconnexion.

Pas au sens OAuth : Meta ne documente aucun grant refresh_token pour Facebook Login. Vous échangez un token de courte durée encore valide avec fb_exchange_token ; une fois un token expiré, l'utilisateur se reconnecte. Dans les apps mobiles natives, Meta rafraîchit les tokens longue durée une fois par jour quand la personne utilise votre app.

Parce que 60 jours est un plafond, pas une promesse. Un token meurt plus tôt quand l'utilisateur change son mot de passe, supprime votre app, déclenche un contrôle de sécurité ou perd son rôle sur la Page, et Meta prévient que les durées de vie « peuvent changer sans préavis ou expirer plus tôt ». Lisez l'error_subcode de l'erreur 190 pour savoir dans quel cas vous êtes.

Appelez GET /debug_token?input_token={TOKEN} avec votre app access token et lisez is_valid, expires_at, data_access_expires_at et scopes. Pour une vérification ponctuelle, collez le token dans l'Access Token Debugger de Meta.

Oui, si vous les traitez comme des mots de passe : chiffrez-les au repos, tenez-les à l'écart des logs et du code client, et n'utilisez l'App Secret et les app tokens que dans des appels de serveur à serveur. Signez les appels serveur avec appsecret_proof.

L'erreur 190 avec le sous-code 492 signale une session invalide : l'utilisateur derrière un Page access token n'a plus de rôle adéquat sur la Page. Obtenez un nouveau Page token auprès d'un admin actuel.

Non. Unipile est une entreprise indépendante : ce n'est ni un Meta Partner, ni une app officielle de Meta, et elle n'est ni soutenue, ni sponsorisée, ni approuvée par Meta. Facebook est une marque de Meta Platforms, Inc.

Non. Vous appelez Unipile avec votre clé API et l'account_id de chaque utilisateur connecté. Les utilisateurs relient leur compte Facebook et les Pages qu'ils gèrent via l'authentification hébergée d'Unipile : ni app Meta, ni App Secret, ni App Review de votre côté.

Elle est conçue dans le respect du Digital Markets Act : chaque utilisateur connecte son propre compte, et Unipile agit pour son compte sans stocker de profils utilisateurs. Plus de détails sur notre page Digital Markets Act.

Oui. Chaque compte connecté reste soumis aux conditions d'utilisation de Meta. Utilisez l'API pour des usages légitimes comme le support client, le CRM et les conversations directes ; le spam et l'automatisation non autorisée peuvent entraîner la restriction des comptes.

Encore des questions ? Notre équipe est là pour vous aider.

Parler à un expert