Een Facebook-pagina abonneren op webhooks: de subscribed_apps-edge
Een Facebook-pagina wordt geabonneerd op de webhooks van een app met POST /{page-id}/subscribed_apps, met subscribed_fields zoals feed,messages en een Page-toegangstoken van iemand met de taak CREATE_CONTENT, MANAGE of MODERATE, met pages_manage_metadata en pages_show_list toegekend. Meta stuurt de events van een veld alleen wanneer de app zich er ook op abonneert; GET toont het abonnement en DELETE verwijdert het.
easyCoexistence abonneert elke pagina die je verbindt op feed, messages en mention via subscribed_apps, meldt haar af wanneer je haar verwijdert, en stuurt de events van de pagina door naar je HTTPS-endpoint, ondertekend met een geheim voor die pagina, vanuit één MCP-connector of de Partner API.
Alleen velden die op zowel pagina- als app-niveau zijn geabonneerd, leveren webhooks op; een pagina kan meer tonen dan de app.
Paginataken, waarvan de persoon achter het token er één nodig heeft om een abonnement te lezen of aan te maken.
Teruggegeven naast success wanneer een app zijn webhookabonnement van een pagina verwijdert met DELETE.
Wat /{app-id}/subscriptions nodig heeft om het abonnement op app-niveau te lezen, aan te maken of te verwijderen.
Na een uur mislukte Messenger-leveringen meldt Meta de app af van de pagina, tot zij opnieuw abonneert.
Wat doet de subscribed_apps-edge?
Hij installeert de app op de pagina en bepaalt welke webhookvelden van de pagina de app ontvangt. Meta stuurt meldingen alleen zolang de app op de pagina geïnstalleerd is en het app-platform niet is uitgeschakeld in de instellingen van de pagina, en alleen voor velden die op beide niveaus zijn geabonneerd: dat van de pagina, via deze edge, en dat van de app, ingesteld in het App Dashboard of via /{app-id}/subscriptions. Een pagina kan op meer velden geabonneerd zijn dan de app.
Hoe abonneer je een pagina?
Met een POST naar de edge, met subscribed_fields met de velden gescheiden door komma's, en het Page-toegangstoken. Een geslaagde aanroep geeft success true terug, en een aanroep die messages bevat heeft daarnaast pages_messaging nodig op het token:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }Welk token, welke taken en welke machtigingen zijn nodig?
Een Page-toegangstoken, dat de aanroep aan één pagina koppelt, van iemand die namens die pagina kan handelen. De referenties en gidsen van Meta stellen deze eisen:
- Elk veld: iemand met de taak
CREATE_CONTENT, MANAGE of MODERATE, enpages_manage_metadatametpages_show_list. - messages en de andere Messenger-velden: daarnaast
pages_messaging, op een token van iemand die de taak MESSAGING kan uitvoeren. - leadgen: de taak ADVERTISE, met
leads_retrieval,pages_read_engagementenads_management. - Het abonnement lezen met GET vereist dezelfde taken en machtigingen als het aanmaken ervan.
Welk toegangsniveau hebben de velden nodig?
Advanced Access, voor pagina's en personen buiten de eigen rollen van de app. Met Standard Access komen Messenger-meldingen alleen van personen met een rol in de app, zoals de beheerders, ontwikkelaars en testers. Advanced Access, per machtiging toegekend via App Review, waarvoor Business Verification nodig is, opent ze voor de klanten van de app. De Messenger-gids van Meta noemt ook het publiceren van de app als vereiste.
Wat is het abonnement op app-niveau?
Het andere deel: de velden waarnaar de app zelf luistert, met zijn callback-URL. Het wordt ingesteld in het App Dashboard of met POST /{app-id}/subscriptions en een app-toegangstoken, met object=page, callback_url, fields, include_values en verify_token, wat Meta's verificatieverzoek in gang zet. GET op dezelfde edge toont per object de callback-URL, fields en of het abonnement actief is. Een nieuwe POST wijzigt de velden zonder de andere te overschrijven, en DELETE verwijdert ze allemaal of de genoemde velden.
Hoe controleer je waarop een pagina geabonneerd is?
Met een GET op dezelfde edge en het token van de pagina. De data-array somt elke app op die de pagina heeft geïnstalleerd, met naam, ID en subscribed_fields, en komt leeg terug wanneer de pagina geen apps heeft geïnstalleerd:
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"]
}
]
}Hoe verwijder je een abonnement?
Met DELETE /{page-id}/subscribed_apps, dat de app van de pagina loskoppelt. Een app kan zijn eigen abonnement verwijderen met een app-toegangstoken, en het antwoord bevat success en messaging_success. Meta verwijdert het ook zelf: na een uur mislukte Messenger-leveringen wordt de app van de pagina afgemeld en moet ze opnieuw abonneren zodra het endpoint werkt.
Wat doet easyCoexistence bij het verbinden?
Het abonneert elke pagina die de persoon kiest, direct nadat het token van die pagina is opgeslagen: POST /{page-id}/subscribed_apps met subscribed_fields op feed,messages,mention. Weigert Meta, dan blijft de pagina verbonden en toont list_social_accounts de reden in last_error. Het verwijderen van de pagina stuurt DELETE /{page-id}/subscribed_apps voordat het token wordt weggegooid, en geen enkele tool bereikt subscribed_apps- of token-paden, zodat easyCoexistence als enige het abonnement beheert.
Veelgemaakte fouten
- De edge aanroepen met een user-toegangstoken. Hij vraagt het Page-toegangstoken van de pagina die wordt geabonneerd.
- De pagina abonneren maar niet de app. Een veld bereikt de callback alleen als het abonnement van de app het ook bevat.
- pages_messaging weglaten bij het abonneren op messages. Meta vereist het, op een token van iemand die de taak MESSAGING kan uitvoeren.
- Vergeten opnieuw te abonneren na een storing. Een uur mislukte Messenger-leveringen meldt de app af, en events stoppen tot de POST opnieuw is verzonden.
Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Moet ik elke pagina apart abonneren?
Ja. subscribed_apps werkt per pagina, met het eigen token van die pagina, terwijl het abonnement op app-niveau voor het object page geldt voor de pagina's die de app hebben geïnstalleerd.
Waarom geeft subscribed_apps fout 200?
Meta noemt 200 een machtigingsfout voor deze edge. Controleer of het token pages_manage_metadata en pages_show_list bevat en afkomstig is van iemand met CREATE_CONTENT, MANAGE of MODERATE.
Kan een pagina worden geabonneerd vanuit Graph API Explorer?
Ja. De gids van Meta kiest de app, haalt een gebruikerstoken met pages_manage_metadata op, wisselt het in voor het token van de pagina en stuurt de POST naar {page-id}/subscribed_apps.
Kan ik webhookvelden toevoegen aan een pagina die met easyCoexistence is verbonden?
Niet via de tools: geen enkele bereikt subscribed_apps-paden, en de pagina blijft geabonneerd op feed, messages en mention, de velden die easyCoexistence doorstuurt.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op