
Guides d'intégration
Guide de l'API LinkedIn
Guide de l'API Email
Guide de l'API WhatsApp
Contacter l'équipe commerciale
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.
graph.facebook.com/me/accounts?fields=id,name,tasks,access_token access_token: {PAGE_ACCESS_TOKEN_1}
access_token: {PAGE_ACCESS_TOKEN_2}
Un token par Page, admin et app
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.
Les Pages de vos utilisateurs, sans Page token à gérer
Connecter. Votre utilisateur connecte son compte Facebook via Hosted Auth, et ses Pages suivent. Ni app Meta, ni App Review.
Lister les Pages. Appelez GET /v2/{ACCOUNT_ID}/inboxes avec votre X-API-KEY : chaque Page est une inbox PAGE_<page_id>_INBOX.
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.
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.
GET / POST /{page-id}pages_manage_metadata · MANAGEPOST /{page-id}/feedpages_manage_posts · CREATE_CONTENTGET / POST /{post-id}/commentspages_read_user_content, pages_manage_engagement · MODERATEGET /{page-id}/insightsread_insights, pages_read_engagement · ANALYZEGET /{page-id}/conversationspages_messaging · MESSAGINGPOST /{page-id}/subscribed_appspages_manage_metadata, pages_show_listLes 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.
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.
Sur Meta for Developers, avec le cas d'usage « Manage everything on your Page ».
App ID + App SecretDemandez pages_show_list et ce dont vos fonctionnalités ont besoin.
Courte durée : échangez-le côté serveur (fb_exchange_token) contre un token longue durée.
Chaque Page renvoie son ID, ses tâches et son token.
GET /me/accountsSelon 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.
Pour tester sur une Page que vous gérez, sans écrire de code :
pages_show_list et les permissions à tester.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é.
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.
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.
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.
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 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.
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.
pages_read_engagementLire 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.
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.
Seules les personnes ayant un rôle sur l'app peuvent accorder des permissions.
Une demande par permission, et une entreprise vérifiée.
Tout admin de Page peut accorder les permissions approuvées.
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 :
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.
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, 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é.
Un problème sur une Page n'affecte ni l'inbox personnelle ni les autres Pages.
api.unipile.com/v2/{ACCOUNT_ID}/inboxes
200 OK
PAGE_<page_id>_INBOXpost_as (API Facebook post)501 api/not_implemented)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.
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." }'
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.
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.
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.
| Question | Pages API de Meta | Compte connecté Unipile |
|---|---|---|
| Qui connecte la Page | Un admin de la Page, via Facebook Login for Business dans votre app Meta | Votre utilisateur, via Hosted Auth |
| App Meta et App Review | Obligatoires, plus l'Advanced Access et la Business Verification | Inutiles de votre côté |
| Tokens à gérer | Un Page token par Page, admin et app | Aucun : un account_id et votre clé API |
| Messages de la Page | Messenger Platform, pages_messaging, fenêtre de 24 heures | Lecture et réponse ; une Page ne peut pas démarrer de conversation |
| Publier en tant que Page | pages_manage_posts | post_as sur l'endpoint des posts |
| Compte personnel de l'admin | Indisponible pour la messagerie | Même connexion : chats personnels, posts et profil |
| Statut par Page | Vous vérifiez chaque token vous-même | page_<page_id> dans products_connection_status |
account_id et votre clé APIpages_messaging, fenêtre de 24 heurespages_manage_postspost_as sur l'endpoint des postspage_<page_id> dans products_connection_statusVous 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.
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.
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