
Guides d'intégration
Guide de l'API LinkedIn
Guide de l'API Email
Guide de l'API WhatsApp
Contacter l'équipe commerciale
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.
graph.facebook.com/debug_token?input_token={USER_ACCESS_TOKEN} applicationVotre appis_validtrueexpires_atdans 60 joursuser token longue duréedata_access_expires_atdans 90 joursrenouvelé si l'utilisateur est actifscopesPas de refresh token : revérifier, puis reconnecter
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.
Aucun token Meta à obtenir, prolonger ou déboguer
Connecter le compte
Votre utilisateur connecte une seule fois son compte Facebook ou sa Page via Hosted Auth. Ni app Meta, ni App Review.
Appeler avec votre clé API
Envoyez X-API-KEY avec l'account_id de l'utilisateur : GET /v2/{ACCOUNT_ID}/chats.
Surveiller un seul statut
Vérifiez products_connection_status ; si besoin, l'utilisateur se reconnecte via Hosted Auth.
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.
| Token | Agit pour | Comment l'obtenir | Durée de vie et usage |
|---|---|---|---|
| User | Une personne connectée | Facebook Login ou Graph API Explorer | 1 à 2 heures, ou environ 60 jours |
| Page | Une Page Facebook | /me/accounts avec le user token d'un admin | Suit son user token |
| App | Votre app Meta | Appel client_credentials, ou {APP_ID}|{APP_SECRET} | Appels de serveur à serveur uniquement |
| System user | Votre entreprise | Paramètres de l'entreprise | Sans expiration, ou 60 jours |
| Client | Votre app, dans le code client | Tableau de bord de l'app | Pas un secret |
/me/accounts avec le user token d'un adminclient_credentials, ou {APP_ID}|{APP_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.
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.
developers.facebook.com/tools/explorer/dialog/oauth avec client_id, redirect_uri, statecode/oauth/access_token avec le code et l'App SecretLa 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.
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. »
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}"
Requêtes tirées des guides Long-Lived Access Tokens et Access Tokens de Meta. Unipile : documentation Facebook Pages.
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.
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é.
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.
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.
Aucun renouvellement, pour les cas où une fuite du token est un risque acceptable.
Passez set_token_expires_in_60_days=true et renouvelez avec fb_exchange_token avant le 60e jour.
Sources : les guides Install apps and generate tokens et Access Tokens de Meta. Dernière vérification : 17 novembre 2026.
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).
0 signifie aucune date d'expiration.granular_scopes ajoute les ID ciblés.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.
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.
{ "error": { "type": "OAuthException", "code": 190, "error_subcode": 460, "fbtrace_id": "EJplcsCHuLu" } }
Lire error_subcode, garder fbtrace_id pour le support Meta
| Sous-code | Signification | Que faire |
|---|---|---|
| 458 | App non installée | Reconnecter l'utilisateur |
| 459 | Utilisateur bloqué par un contrôle de sécurité | L'utilisateur se connecte sur facebook.com |
| 460 | Mot de passe modifié | Reconnecter l'utilisateur |
| 463 | Token expiré | Reconnexion, puis nouvel échange |
| 464 | Utilisateur non confirmé | L'utilisateur se connecte sur facebook.com |
| 467 | Token invalide | Reconnecter l'utilisateur |
| 492 | Aucun rôle adéquat sur la Page | Nouveau 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.
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.
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.expires_at.Sources : les guides Access Tokens et Securing Requests de Meta. Dernière vérification : 17 novembre 2026.
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é.
| Question | Access tokens Meta | Compte connecté Unipile |
|---|---|---|
| Ce que vous stockez | Un token par utilisateur, plus un par Page, par admin et par app | Un account_id par utilisateur et une clé API |
| Ce que vous surveillez | expires_at et data_access_expires_at pour chaque token | Un statut par Page dans metadata.products_connection_status |
| Ce que vous renouvelez | Échange longue durée ou reconnexion avant le 60e jour | Aucun token Meta à échanger |
| En cas d'erreur 190 | Analyser le sous-code, puis demander à l'utilisateur de se reconnecter | L'utilisateur se reconnecte via Hosted Auth si besoin |
account_id par utilisateur et une clé APIexpires_at et data_access_expires_at pour chaque tokenmetadata.products_connection_statusUn 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.
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.
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.
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