Abonner une Page Facebook aux webhooks : l'edge subscribed_apps
Une Page Facebook s'abonne aux webhooks d'une application avec POST /{page-id}/subscribed_apps, en passant subscribed_fields, par exemple feed,messages, et un token d'accès à la Page émis par une personne ayant la tâche CREATE_CONTENT, MANAGE ou MODERATE, avec pages_manage_metadata et pages_show_list accordés. Meta n'envoie les événements d'un champ que si l'application s'y abonne aussi ; GET liste l'abonnement et DELETE le supprime.
easyCoexistence abonne chaque Page que vous connectez à feed, messages et mention via subscribed_apps, la désabonne quand vous la retirez, et transmet les événements de la Page à votre endpoint HTTPS, signés avec un secret propre à cette Page, depuis un seul connecteur MCP ou l'API Partenaire.
Seuls les champs abonnés au niveau de la Page et de l'application produisent des webhooks ; une Page peut en lister davantage que l'application.
Tâches de Page, dont l'une est nécessaire à la personne derrière le token pour lire ou créer un abonnement.
Renvoyé à côté de success lorsqu'une application retire son abonnement webhook d'une Page avec DELETE.
Ce que /{app-id}/subscriptions exige pour lire, créer ou supprimer l'abonnement au niveau de l'application.
Échecs de livraison Messenger avant que Meta désabonne l'application de la Page, qui doit ensuite s'abonner à nouveau.
Que fait l'edge subscribed_apps ?
Il installe l'application sur la Page et définit les champs webhook que l'application reçoit de la Page. Meta n'envoie des notifications que tant que la Page a l'application installée et n'a pas désactivé la plateforme d'application dans ses paramètres, et seulement pour les champs abonnés aux deux niveaux : celui de la Page, via cet edge, et celui de l'application, défini dans le tableau de bord de l'application ou via /{app-id}/subscriptions. Une Page peut être abonnée à davantage de champs que l'application.
Comment abonner une Page ?
Par un POST sur l'edge, avec subscribed_fields listant les champs séparés par des virgules, et le token d'accès de la Page. Un appel réussi renvoie success true, et un appel qui liste messages exige en plus pages_messaging sur le token :
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }Quels token, tâches et permissions faut-il ?
Un token d'accès à la Page, qui lie l'appel à une seule Page, émis par une personne pouvant agir sur cette Page. Les références et guides de Meta fixent ces exigences :
- Tout champ : une personne ayant la tâche
CREATE_CONTENT, MANAGE ou MODERATE, avecpages_manage_metadataetpages_show_list. - messages et les autres champs Messenger :
pages_messagingen plus, sur le token d'une personne pouvant exécuter la tâche MESSAGING. - leadgen : la tâche ADVERTISE, avec
leads_retrieval,pages_read_engagementetads_management. - Lire l'abonnement avec GET demande les mêmes tâches et permissions que le créer.
Quel niveau d'accès les champs exigent-ils ?
L'Accès avancé, pour les Pages et les personnes extérieures aux rôles de l'application. Avec l'Accès standard, les notifications Messenger ne viennent que des personnes ayant un rôle sur l'application, comme ses administrateurs, développeurs et testeurs ; l'Accès avancé, accordé permission par permission via l'examen de l'application et exigeant la vérification de l'entreprise, les ouvre aux clients de l'application. Le guide Messenger de Meta cite aussi la publication de l'application parmi les prérequis.
Qu'est-ce que l'abonnement au niveau de l'application ?
L'autre moitié : les champs que l'application écoute elle-même, avec son URL de rappel. Il se règle dans le tableau de bord de l'application ou avec POST /{app-id}/subscriptions et un token d'accès à l'application, en passant object=page, callback_url, fields, include_values et verify_token, ce qui déclenche la requête de vérification de Meta. GET sur le même edge affiche le callback_url, les champs de chaque objet et si l'abonnement est actif ; un nouveau POST modifie les champs sans écraser les autres, et DELETE supprime tous les champs ou ceux nommés.
Comment vérifier à quoi une Page est abonnée ?
Avec un GET sur le même edge et le token de la Page. Le tableau data liste chaque application installée sur la Page, avec son nom, son ID et ses subscribed_fields, et revient vide lorsque la Page n'a aucune application installée :
GET https://graph.facebook.com/{page-id}/subscribed_apps
?access_token=<PAGE_ACCESS_TOKEN>
{
"data": [
{
"category": "Business",
"link": "https://example.com/app",
"name": "<APP_NAME>",
"id": "<APP_ID>",
"subscribed_fields": ["feed", "messages", "mention"]
}
]
}Comment supprimer un abonnement ?
Avec DELETE /{page-id}/subscribed_apps, qui dissocie l'application de la Page ; une application peut retirer son propre abonnement avec un token d'accès à l'application, et la réponse contient success et messaging_success. Meta le retire aussi de lui-même : après une heure de livraisons Messenger en échec, l'application est désabonnée de la Page et doit s'abonner à nouveau une fois que son endpoint fonctionne.
Que fait easyCoexistence à la connexion ?
Il abonne chaque Page choisie par la personne, juste après avoir enregistré le token de cette Page : POST /{page-id}/subscribed_apps avec subscribed_fields réglé sur feed,messages,mention. Si Meta refuse, la Page reste connectée et list_social_accounts affiche la raison dans last_error. Retirer la Page envoie DELETE /{page-id}/subscribed_apps avant que le token ne soit supprimé, et aucun outil n'atteint les chemins subscribed_apps ou token, si bien que l'abonnement est géré par easyCoexistence seul.
Erreurs courantes
- Appeler l'edge avec un token d'accès utilisateur. Il faut le token d'accès de la Page abonnée.
- Abonner la Page sans abonner l'application. Un champ n'atteint l'URL de rappel que si l'abonnement de l'application l'inclut aussi.
- Oublier pages_messaging en s'abonnant à messages. Meta l'exige, sur le token d'une personne pouvant exécuter la tâche MESSAGING.
- Oublier de se réabonner après une panne. Une heure de livraisons Messenger en échec désabonne l'application, et les événements cessent jusqu'à un nouveau POST.
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Dois-je abonner chaque Page séparément ?
Oui. subscribed_apps fonctionne par Page, avec le token de cette Page, tandis que l'abonnement au niveau de l'application pour l'objet page concerne les Pages ayant installé l'application.
Pourquoi subscribed_apps renvoie-t-il l'erreur 200 ?
Meta classe le code 200 comme erreur de permissions pour cet edge. Vérifiez que le token porte pages_manage_metadata et pages_show_list et qu'il provient d'une personne ayant CREATE_CONTENT, MANAGE ou MODERATE.
Peut-on abonner une Page depuis Graph API Explorer ?
Oui. Le guide de Meta choisit l'application, obtient un token utilisateur avec pages_manage_metadata, l'échange contre le token de la Page, puis envoie le POST vers {page-id}/subscribed_apps.
Puis-je ajouter des champs webhook à une Page connectée à easyCoexistence ?
Pas avec ses outils : aucun n'atteint les chemins subscribed_apps, et la Page reste abonnée à feed, messages et mention, les champs que easyCoexistence transmet.
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