FR
Guide de la Pages API

API Pages Facebook : Page access tokens, permissions et une façon plus simple de connecter des Pages

Page access tokens, tâches sur la Page, permissions pages_* et App Review en 2026, et comment une app SaaS peut connecter les Pages que gèrent ses utilisateurs.

Page access tokens 200 OK
GETgraph.facebook.com/me/accounts?fields=id,name,tasks,access_token
Northwind BakeryFacebookPage · contrôle total
access_token: {PAGE_ACCESS_TOKEN_1}
CREATE_CONTENTMODERATEMESSAGINGANALYZEADVERTISEMANAGE
Harbor YogaFacebookPage · accès partiel
access_token: {PAGE_ACCESS_TOKEN_2}
ANALYZEMESSAGING
Requis pages_show_list Facebook Login for Business App Review pour les Pages clientes
TOKEN Un token par Page, admin et app
Réponse courte

L'API Pages Facebook (Meta l'appelle la Facebook Pages API) est un ensemble d'endpoints de la Graph API pour gérer une Page Facebook : publier et lire des posts, modérer les commentaires, lire les statistiques et traiter les conversations de la Page. Chaque appel exige un Page access token, obtenu auprès d'une personne qui peut effectuer des tâches sur la Page. Pour vos propres Pages, gérées par des personnes qui ont un rôle sur votre app, aucune App Review n'est nécessaire ; servir les Pages de vos clients exige une app qui a passé l'App Review.

Pour un SaaS qui sert de nombreux clients, il existe un second modèle : les utilisateurs connectent leurs comptes Facebook via Unipile et leurs Pages arrivent avec la connexion.

Avec Unipile

Les Pages de vos utilisateurs, sans Page token à gérer

  1. Connecter. Votre utilisateur connecte son compte Facebook via Hosted Auth, et ses Pages suivent. Ni app Meta, ni App Review.

  2. Lister les Pages. Appelez GET /v2/{ACCOUNT_ID}/inboxes avec votre X-API-KEY : chaque Page est une inbox PAGE_<page_id>_INBOX.

  3. Agir en tant que Page. Répondez avec POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send, ou publiez au nom de la Page avec post_as.

Définition

Qu'est-ce que l'API Pages Facebook ?

C'est la partie de la Graph API construite autour du nœud Page : des endpoints qui lisent et modifient une Page, ses posts, ses commentaires et ses statistiques. La messagerie passe par la Messenger Platform et la publicité par la Marketing API, avec le même Page access token.

Malgré son nom, la Graph API n'est pas du GraphQL. C'est une API HTTP versionnée, sur graph.facebook.com, organisée en nœuds, arêtes et champs. Pour la vue d'ensemble (Login, Messenger, versions, rate limits), voyez comment les API Facebook s'articulent.

Facebook Ce que couvre la Pages API
Infos de la PageLire et modifier les informations et les paramètres de la PageGET / POST /{page-id}pages_manage_metadata · MANAGE
PostsPublier, lire, modifier et supprimer des posts en tant que PagePOST /{page-id}/feedpages_manage_posts · CREATE_CONTENT
CommentairesLire les commentaires des posts de la Page, y répondre et les supprimer (guide de l'API des commentaires)GET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATE
StatistiquesStatistiques de la Page et des postsGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZE
ConversationsL'inbox de la Page, via la Messenger PlatformGET /{page-id}/conversationspages_messaging · MESSAGING
WebhooksÉvénements en temps réel sur le fil et l'inbox de la Page, une fois votre app installée sur la Page via son arête subscribed_appsPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_list

Rate limits de la Facebook Pages API

Les appels faits avec un Page access token relèvent des limites Business Use Case de Meta, comptées par Page : 4 800 appels multipliés par le nombre d'utilisateurs engagés sur 24 heures, les utilisateurs engagés étant les personnes qui ont interagi avec la Page sur cette période. Chaque réponse contient un en-tête X-Business-Use-Case-Usage avec votre consommation actuelle. Les limites des autres API Facebook figurent dans notre guide de l'API Facebook.

Sources : la présentation de la Pages API, Manage a Page, Page Insights, Webhooks for Pages, Posts, Comments, Page conversations, subscribed_apps, le rate limiting et la référence des permissions de Meta. Dernière vérification : 17 novembre 2026.

Access token

Comment obtenir un Page access token Facebook

Il n'existe pas de clé API pour les Pages Facebook. Un admin de la Page se connecte à votre app Meta avec Facebook Login for Business, ce qui vous donne un user access token. Ensuite, GET /me/accounts renvoie toutes les Pages qu'il gère, avec ses tâches et un Page access token pour chacune.

1

Créer une app Meta

Sur Meta for Developers, avec le cas d'usage « Manage everything on your Page ».

App ID + App Secret
2

Ajouter Facebook Login for Business

Demandez pages_show_list et ce dont vos fonctionnalités ont besoin.

Fenêtre de connexion
3

Obtenir un user access token

Courte durée : échangez-le côté serveur (fb_exchange_token) contre un token longue durée.

{USER_ACCESS_TOKEN}
4

Appeler /me/accounts

Chaque Page renvoie son ID, ses tâches et son token.

GET /me/accounts

Selon Meta, les Page access tokens sont propres à chaque combinaison de Page, d'admin et d'app. Dix Pages clientes, dix tokens à stocker et à surveiller.

L'appel d'échange et la requête /me/accounts sont prêts à copier dans l'onglet « Meta token exchange » du bloc de code ci-dessous. Les tokens utilisateur, app et utilisateur système sont traités dans notre guide sur l'access token de l'API Facebook.

Obtenir un Page access token dans le Graph API Explorer

Pour tester sur une Page que vous gérez, sans écrire de code :

  • Choisissez votre app dans le menu des apps du Graph API Explorer, puis ajoutez pages_show_list et les permissions à tester.
  • Ouvrez le menu « User or Page », choisissez votre Page et générez le token : l'Explorer vous demande d'accorder les permissions.
  • Copiez le token affiché en haut de l'outil. Il est de courte durée : échangez-le comme à l'étape 3 pour obtenir un Page token qui n'expire pas.

Quelle est la durée de vie d'un Page access token Facebook ?

Elle dépend du user token de départ. Un Page token obtenu avec un user token de courte durée est valable environ une heure. Échangez d'abord le user token contre un token longue durée, rappelez /me/accounts, et Meta indique que le Page token obtenu n'a pas de date d'expiration, même s'il peut encore être invalidé.

Facebook Durée de vie des tokens, selon Meta
User token courte duréeEnviron une à deux heures
User token longue duréeEnviron 60 jours
Page token issu d'un user token courte duréeValable 1 heure
Page token issu d'un user token longue duréeSans date d'expiration, mais peut être invalidé

Sources : Access Tokens, Long-Lived Access Tokens et Get a Page Access Token chez Meta ; étapes du Graph API Explorer tirées de son guide. Meta précise qu'il ne faut pas compter sur la stabilité de ces durées. Dernière vérification : 17 novembre 2026.

Un Page access token Facebook peut-il ne jamais expirer ?

Oui. Un Page access token longue durée, obtenu en appelant /me/accounts avec un user token longue durée, n'a pas de date d'expiration. Selon Meta, les Page access tokens longue durée n'expirent ou ne sont invalidés que dans certaines conditions. C'est le Page token « permanent » dont parlent la plupart des guides. Il n'est pourtant pas éternel : les événements ci-dessous l'invalident encore, alors stockez-le, surveillez les erreurs et prévoyez un parcours de reconnexion. Pour les Pages détenues par votre propre entreprise, un system user token est l'autre option.

Ce qui casse un Page token en production

  • L'admin perd son rôle sur la Page. Meta ne délivre de Page tokens qu'aux personnes ayant un rôle sur la Page : obtenez un nouveau token auprès d'un autre admin.
  • L'admin se déconnecte de votre app, change son mot de passe ou supprime votre app. Il doit se reconnecter.
  • Votre app perd une permission. L'accès s'arrête alors pour tous les clients à la fois.

Meta signale ces cas par l'erreur 190. Ses sous-codes et la façon de vérifier un token avec debug_token sont détaillés dans notre guide sur l'access token de l'API Facebook ; pour un Page token, la solution est toujours la même : demander à l'admin de se reconnecter.

Permissions

Tâches sur la Page et permissions : qui peut faire quoi

Un appel ne réussit que si la personne derrière le token peut effectuer la tâche correspondante sur la Page, et si votre app détient la permission correspondante, avec l'Advanced Access pour les personnes extérieures à votre app.

Les 8 tâches sur une Page

Les tâches définissent ce qu'une personne peut faire sur une Page. /me/accounts les liste pour chaque Page ; un admin peut toutes les effectuer.

Facebook Tâches sur la Page
ADVERTISECréer des publicités et des posts de Page non publiés
ANALYZEVoir les statistiques de la Page et quel admin a publié un post ou un commentaire
CREATE_CONTENTPublier du contenu en tant que Page
MANAGEAttribuer et gérer les tâches sur la Page ; nécessaire aussi pour modifier ses informations et ses paramètres
MANAGE_LEADSVoir et gérer les leads
MESSAGINGEnvoyer des messages en tant que Page
MODERATERépondre aux commentaires des posts de la Page et les supprimer
VIEW_MONETIZATION_INSIGHTSVoir les statistiques de monétisation

Les permissions pages_* que vous demanderez

Les permissions définissent ce que votre app peut faire. Une app Meta créée avec le cas d'usage « Manage everything on your Page » démarre avec pages_show_list, business_management et public_profile. N'ajoutez que ce qu'une fonctionnalité utilise : chaque permission est examinée séparément.

Facebook Permissions pages_*
pages_show_listLister les Pages qu'une personne gère : le sélecteur de Pages après la connexion
pages_read_engagementLire le contenu, les métadonnées, les abonnés et les statistiques de la Page
pages_manage_postsCréer, modifier et supprimer les posts de la Page
pages_manage_engagementCréer, modifier et supprimer les commentaires publiés sur la Page
pages_read_user_contentLire les posts et commentaires des visiteurs de la Page, supprimer leurs commentaires
read_insightsLire les statistiques de la Page, avec pages_read_engagement
pages_messagingGérer les conversations de la Page dans Messenger et y accéder
pages_manage_metadataS'abonner aux webhooks de la Page et modifier ses paramètres

Lire des Pages que vous ne gérez pas est un autre cas : il faut la fonctionnalité Page Public Content Access, que Meta limite à l'analyse ou à l'affichage des posts et de l'engagement des Pages, avec sa propre App Review et sa propre Business Verification.

Sources : la présentation de la Pages API (tâches), Manage a Page (MANAGE pour les paramètres), Page Insights, la référence des permissions (descriptions résumées) et Page Public Content Access de Meta. Dernière vérification : 17 novembre 2026.

App Review

App Review : pourquoi ça marche sur votre Page mais pas sur celles de vos clients

Votre app démarre en Standard Access, et Meta précise que les permissions en Standard Access ne peuvent être demandées qu'aux utilisateurs ayant un rôle sur l'app. Votre prototype fonctionne sur votre Page et échoue dès qu'un client se connecte. Servir leurs Pages exige l'Advanced Access, accordé permission par permission via l'App Review.

1Standard Access

Votre équipe uniquement

Seules les personnes ayant un rôle sur l'app peuvent accorder des permissions.

2Examen

App Review

Une demande par permission, et une entreprise vérifiée.

3Advanced Access

En ligne pour les clients

Tout admin de Page peut accorder les permissions approuvées.

Ce qu'un SaaS multiclient doit faire tourner

Une fois en ligne, chaque Page cliente devient une petite intégration à part entière : une connexion d'admin, un token stocké, les tâches de cet admin, un contrôle de santé et un parcours de reconnexion. Rien dans l'API Pages Facebook ne les suit pour vous d'un client à l'autre. Le guide de soumission de Meta demande :

  • Un enregistrement d'écran par permission, qui montre l'utilisateur l'accorder et la fonctionnalité qui l'utilise : selon Meta, toute permission sans enregistrement d'écran ne sera pas approuvée.
  • Une description par permission, aussi précise que possible.
  • Un accès pour les examinateurs : une app publique ou des instructions pour atteindre la fonctionnalité.
  • Uniquement les permissions dont votre app a besoin.

Meta exige aussi la Business Verification : elle est obligatoire pour obtenir l'Advanced Access.

Sources : les niveaux d'accès, le guide de soumission à l'App Review et la présentation de la Pages API de Meta (toutes les permissions et fonctionnalités liées aux Pages passent par l'App Review). Dernière vérification : 17 novembre 2026.

Messagerie

Messagerie d'une Page Facebook : là où la Pages API passe le relais à Messenger

Les conversations d'une Page ne font pas partie de la Pages API elle-même. Elles passent par la Messenger Platform, avec le même Page access token, la permission pages_messaging et la tâche MESSAGING.

Les personnes sont identifiées par un ID propre à la Page (PSID), elles écrivent en premier, et la Page peut répondre pendant 24 heures après leur dernier message. La façon dont une app SaaS lit ces conversations et y répond est décrite sur notre page API Facebook Messenger. Pour les conversations d'un profil personnel, consultez l'API Facebook Messenger pour les comptes personnels ; pour ce que Meta facture, voir les prix de l'API Facebook Messenger.

Avec Unipile

Un autre modèle : connecter les Pages que gèrent vos utilisateurs

Avec Unipile, votre utilisateur connecte son compte Facebook une seule fois, via Hosted Auth. Les Pages qu'il administre sont activées sur le même account_id, par défaut. Pas d'app Meta, pas d'App Review, pas de Page token de votre côté.

Votre app Synchronisé
Une seule connexion
FacebookAnna LeeInbox personnelle
FacebookNorthwind BakeryInbox de Page
FacebookHarbor YogaInbox de Page
Northwind Bakery 2Harbor YogaPersonnel
Leo MartinLa boutique est ouverte dimanche ?Page
Sara KimPhoto d'une commande de gâteauPage
Omar HaddadVous : Prêt à midiPage
Statut de connexion
Inbox personnelleConnectée
Northwind BakeryConnectée
Harbor YogaÀ vérifier

Un problème sur une Page n'affecte ni l'inbox personnelle ni les autres Pages.

GET api.unipile.com/v2/{ACCOUNT_ID}/inboxes 200 OK
Une Page connectée peut
  • Lire les messages de la Page, chaque Page apparaissant comme une inbox PAGE_<page_id>_INBOX
  • Répondre dans les conversations de la Page
  • Publier des posts en tant que Page, avec le paramètre post_as (API Facebook post)
  • Lire les posts de la Page
Elle ne peut pas
  • Démarrer une nouvelle conversation : la personne écrit en premier
  • Supprimer ses messages (501 api/not_implemented)
  • Publier des Stories
  • Utiliser les groupes Facebook

Chaque Page indique son propre état dans metadata.products_connection_status (clé page_<page_id>). La même connexion transporte les messages personnels de l'admin, et la même API couvre LinkedIn, WhatsApp, Instagram, Telegram, l'email et les calendriers.

La même tâche en code

Lister les Pages, puis répondre dans une conversation de Page. L'onglet « Meta Graph API » utilise un Page token, l'onglet « Meta token exchange » montre comment obtenir un Page token qui n'expire pas, et l'onglet « Unipile » utilise le compte connecté.

# 1. List the Pages a person manages, with tasks and Page tokens
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={USER_ACCESS_TOKEN}"

# Response (abridged)
{ "data": [ {
    "id": "{PAGE_ID}",
    "name": "Northwind Bakery",
    "tasks": ["CREATE_CONTENT", "MODERATE", "MESSAGING", "ANALYZE"],
    "access_token": "{PAGE_ACCESS_TOKEN}"
} ] }

# 2. Store one token per Page, then call Page endpoints with it
curl "https://graph.facebook.com/{PAGE_ID}/conversations?platform=messenger&access_token={PAGE_ACCESS_TOKEN}"
# 1. Server side: exchange the short lived user token for a long lived one
curl "https://graph.facebook.com/oauth/access_token?grant_type=fb_exchange_token&client_id={APP_ID}&client_secret={APP_SECRET}&fb_exchange_token={SHORT_LIVED_USER_TOKEN}"

# Response
{ "access_token": "{LONG_LIVED_USER_TOKEN}", "token_type": "bearer", "expires_in": 5183944 }

# 2. Call /me/accounts with the long lived user token:
#    the Page tokens it returns have no expiration date
curl "https://graph.facebook.com/me/accounts?fields=id,name,tasks,access_token&access_token={LONG_LIVED_USER_TOKEN}"
# 1. List the inboxes of the connected account: one per managed Page,
#    with the ID PAGE_{PAGE_ID}_INBOX
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. List the chats of one Page inbox
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/inboxes/PAGE_{PAGE_ID}_INBOX/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 3. Reply in a Page chat (chat ID PAGE_{PAGE_ID}_{THREAD_KEY})
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Yes, we open at 9am on Sunday." }'
200 OK · un Page access token par Page, admin et app
200 OK · expires_in est en secondes : environ 60 jours pour le user token
200 OK · un seul account_id pour l'inbox personnelle et chaque Page

Appels Meta vérifiés le 17 novembre 2026 avec Long-Lived Access Tokens. L'activation, les ID d'inbox et post_as sont détaillés dans la documentation Facebook Pages.

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 se connecte pour le compte de chaque utilisateur authentifié, et chaque utilisateur reste soumis aux conditions de Meta. Réservez son usage aux conversations clients sur les Pages que gèrent vos utilisateurs.

Décision

Pages API ou compte connecté : lequel convient à votre produit ?

La Pages API de Meta convient à une équipe qui gère ses propres Pages, ou qui a besoin des statistiques et de la publicité. Un compte connecté convient à un SaaS dont les utilisateurs apportent leurs propres Pages.

QuestionPages API de MetaCompte connecté Unipile
Qui connecte la PageUn admin de la Page, via Facebook Login for Business dans votre app MetaVotre utilisateur, via Hosted Auth
App Meta et App ReviewObligatoires, plus l'Advanced Access et la Business VerificationInutiles de votre côté
Tokens à gérerUn Page token par Page, admin et appAucun : un account_id et votre clé API
Messages de la PageMessenger Platform, pages_messaging, fenêtre de 24 heuresLecture et réponse ; une Page ne peut pas démarrer de conversation
Publier en tant que Pagepages_manage_postspost_as sur l'endpoint des posts
Compte personnel de l'adminIndisponible pour la messagerieMême connexion : chats personnels, posts et profil
Statut par PageVous vérifiez chaque token vous-mêmepage_<page_id> dans products_connection_status
Qui connecte la Page
Pages API de MetaUn admin de la Page, via Facebook Login for Business dans votre app Meta
UnipileVotre utilisateur, via Hosted Auth
App Meta et App Review
Pages API de MetaObligatoires, plus l'Advanced Access et la Business Verification
UnipileInutiles de votre côté
Tokens à gérer
Pages API de MetaUn Page token par Page, admin et app
UnipileAucun : un account_id et votre clé API
Messages de la Page
Pages API de MetaMessenger Platform, pages_messaging, fenêtre de 24 heures
UnipileLecture et réponse ; une Page ne peut pas démarrer de conversation
Publier en tant que Page
Pages API de Metapages_manage_posts
Unipilepost_as sur l'endpoint des posts
Compte personnel de l'admin
Pages API de MetaIndisponible pour la messagerie
UnipileMême connexion : chats personnels, posts et profil
Statut par Page
Pages API de MetaVous vérifiez chaque token vous-même
Unipilepage_<page_id> dans products_connection_status

Vous hésitez encore entre Login, Messenger, Marketing API et Pages ? Notre grille de décision indique de quelle API Facebook vous avez besoin pour chaque type de produit.

Connectez des Pages sans pipeline de tokens

Laissez chaque utilisateur relier son compte Facebook une seule fois, et travaillez avec les inbox et les posts de ses Pages via la même API que ses comptes LinkedIn, WhatsApp et email. Essai gratuit de 7 jours, sans carte bancaire.

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

Les Pages ne sont qu'une partie du tableau. Consultez tous les endpoints Facebook disponibles avec Unipile (messages, posts, commentaires, profils, webhooks), ou lisez le guide complet de l'API Facebook.

FAQ sur l'API Pages Facebook

Réponses rapides sur le Page access token Facebook, sa durée de vie, l'App Review et les permissions.

Connectez un admin de la Page à votre app Meta avec Facebook Login for Business, en demandant pages_show_list. Échangez le user token contre un token longue durée sur votre serveur avec grant_type=fb_exchange_token, puis appelez GET /me/accounts : chaque Page revient avec son propre access_token et les tâches que l'admin peut effectuer.

Elle dépend du user token dont il est issu. Selon Meta, un Page token obtenu avec un user token de courte durée est valable 1 heure. Obtenu à partir d'un user token longue durée (environ 60 jours), le Page token n'a pas de date d'expiration, mais une déconnexion, un changement de mot de passe ou la suppression de l'app l'invalident quand même.

Oui. Appelez /me/accounts avec un user token longue durée : les Page tokens renvoyés n'ont pas de date d'expiration. Ils ne sont pas permanents dans tous les cas : si l'admin perd son rôle sur la Page, change son mot de passe ou supprime votre app, le token cesse de fonctionner et l'admin doit se reconnecter.

Votre app n'a que le Standard Access : seules les personnes ayant un rôle sur l'app peuvent lui accorder des permissions. Pour servir les Pages de vos clients, chaque permission doit obtenir l'Advanced Access, accordé via l'App Review avec un enregistrement d'écran par permission, et Meta exige pour cela la Business Verification.

Presque toutes les intégrations commencent par pages_show_list. Ajoutez ensuite uniquement ce que vous utilisez : pages_read_engagement pour lire le contenu et les métadonnées, pages_manage_posts pour publier, pages_manage_engagement pour les commentaires, pages_messaging pour les conversations, pages_manage_metadata pour les webhooks et les paramètres, et read_insights pour les statistiques.

Non. Unipile est une entreprise indépendante, pas un Meta Partner, et Meta ne la soutient, ne la sponsorise ni ne l'approuve. Connecter des Pages via Unipile ne fait pas non plus de votre produit une app Meta. Facebook et Messenger sont des marques de Meta Platforms, Inc.

Non. Au lieu d'une app Meta qui collecte des Page access tokens, vos utilisateurs connectent une seule fois leur compte Facebook via l'authentification hébergée d'Unipile, et les Pages qu'ils administrent arrivent avec cette connexion. Vous n'avez ni App Review, ni Advanced Access, ni Business Verification à passer de votre côté.

Elle est conçue dans l'esprit du Digital Markets Act : chaque admin de Page connecte son propre compte, Unipile agit en son nom pour les Pages qu'il gère déjà, et ne stocke pas de profils utilisateurs. Tous les détails sont sur notre page Digital Markets Act.

Oui. Une Page connectée via Unipile reste régie par les conditions d'utilisation et les règles des Pages de Meta. Tenez-vous-en à des usages légitimes comme répondre aux clients dans l'inbox de la Page, publier le contenu propre à la Page ou synchroniser les conversations dans un CRM ; le spam et l'automatisation non autorisée peuvent entraîner la restriction du compte ou de la Page.

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

Parler à un expert