Sottoscrivere una Pagina Facebook ai webhook: l'edge subscribed_apps
Una Pagina Facebook viene sottoscritta ai webhook di un'app con POST /{page-id}/subscribed_apps, passando subscribed_fields come feed,messages e un token di accesso alla Pagina di qualcuno con l'attività CREATE_CONTENT, MANAGE o MODERATE, con pages_manage_metadata e pages_show_list concessi. Meta invia gli eventi di un campo solo quando anche l'app vi si sottoscrive; GET elenca la sottoscrizione e DELETE la rimuove.
easyCoexistence sottoscrive ogni Pagina che connetti a feed, messages e mention tramite subscribed_apps, la disiscrive quando la rimuovi e inoltra gli eventi della Pagina al tuo endpoint HTTPS, firmati con un secret specifico per quella Pagina, da un unico connettore MCP o dalla Partner API.
Solo i campi sottoscritti sia a livello di Pagina sia a livello di app producono webhook; una Pagina può elencarne più dell'app.
Le attività della Pagina: la persona dietro il token ne deve avere una per leggere o creare una sottoscrizione.
Restituito insieme a success quando un'app rimuove la propria sottoscrizione webhook da una Pagina con DELETE.
Cosa richiede /{app-id}/subscriptions per leggere, creare o eliminare la sottoscrizione a livello di app.
Delle consegne Messenger fallite prima che Meta annulli l'iscrizione dell'app alla Pagina, finché l'app non si iscrive di nuovo.
Cosa fa l'edge subscribed_apps?
Installa l'app sulla Pagina e stabilisce quali campi webhook della Pagina riceve l'app. Meta invia notifiche solo mentre la Pagina ha l'app installata e non ha disattivato la piattaforma app nelle impostazioni, e solo per i campi sottoscritti a entrambi i livelli: quello della Pagina, tramite questo edge, e quello dell'app, impostato nella App Dashboard o tramite /{app-id}/subscriptions. Una Pagina può essere sottoscritta a più campi di quanti ne abbia l'app.
Come si sottoscrive una Pagina?
Con un POST sull'edge, con subscribed_fields che elenca i campi separati da virgole e il token di accesso della Pagina. Una chiamata riuscita restituisce success true, e una chiamata che elenca messages richiede anche pages_messaging sul token:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }Quali token, attività e permessi servono?
Un token di accesso alla Pagina, che lega la chiamata a una sola Pagina, di qualcuno che può agire su quella Pagina. I riferimenti e le guide di Meta fissano questi requisiti:
- Qualsiasi campo: una persona con l'attività
CREATE_CONTENT, MANAGE o MODERATE, epages_manage_metadataconpages_show_list. - messages e gli altri campi Messenger: anche
pages_messaging, su un token di qualcuno che può svolgere l'attività MESSAGING. - leadgen: l'attività ADVERTISE, con
leads_retrieval,pages_read_engagementeads_management. - Leggere la sottoscrizione con GET richiede le stesse attività e gli stessi permessi necessari per crearla.
Quale livello di accesso serve ai campi?
L'accesso avanzato, per Pagine e persone che non hanno un ruolo nell'app. Con l'accesso standard, le notifiche Messenger arrivano solo da persone con un ruolo sull'app, come amministratori, sviluppatori e tester; l'accesso avanzato, concesso per ogni permesso tramite revisione dell'app e che richiede la verifica dell'azienda, le apre ai clienti dell'app. La guida Messenger di Meta elenca anche la pubblicazione dell'app tra i prerequisiti.
Cos'è la sottoscrizione a livello di app?
L'altra metà: i campi che l'app stessa ascolta, con il suo callback URL. Si imposta nella App Dashboard o con POST /{app-id}/subscriptions e un app access token, passando object=page, callback_url, fields, include_values e verify_token, che avvia la richiesta di verifica di Meta. GET sullo stesso edge mostra callback_url, fields e se la sottoscrizione è attiva per ogni oggetto, un nuovo POST modifica i campi senza sovrascrivere gli altri, e DELETE rimuove tutto o solo i campi indicati.
Come si verifica a cosa è sottoscritta una Pagina?
Con un GET sullo stesso edge e il token della Pagina. L'array data elenca ogni app che la Pagina ha installato, con nome, ID e subscribed_fields, e torna vuoto quando la Pagina non ha app installate:
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"]
}
]
}Come si rimuove una sottoscrizione?
Con DELETE /{page-id}/subscribed_apps, che dissocia l'app dalla Pagina; un'app può rimuovere la propria sottoscrizione con un app access token, e la risposta contiene success e messaging_success. Meta la rimuove anche da sola: dopo un'ora di consegne Messenger fallite, l'app viene disiscritta dalla Pagina e deve iscriversi di nuovo quando il suo endpoint torna a funzionare.
Cosa fa easyCoexistence alla connessione?
Sottoscrive ogni Pagina scelta dalla persona, subito dopo aver salvato il token di quella Pagina: POST /{page-id}/subscribed_apps con subscribed_fields impostato su feed,messages,mention. Se Meta rifiuta, la Pagina resta connessa e list_social_accounts mostra il motivo in last_error. Rimuovere la Pagina invia DELETE /{page-id}/subscribed_apps prima che il token venga scartato, e nessuno strumento raggiunge i percorsi subscribed_apps e token, quindi la sottoscrizione è gestita solo da easyCoexistence.
Errori comuni
- Chiamare l'edge con un user access token. Serve il token di accesso della Pagina da sottoscrivere.
- Sottoscrivere la Pagina ma non l'app. Un campo raggiunge il callback solo se anche la sottoscrizione dell'app lo include.
- Dimenticare pages_messaging quando si sottoscrivono messages. Meta lo richiede, su un token di qualcuno che può svolgere l'attività MESSAGING.
- Non risottoscrivere dopo un'interruzione. Un'ora di consegne Messenger fallite annulla la sottoscrizione dell'app e gli eventi si fermano finché il POST non viene inviato di nuovo.
Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.
Domande frequenti
Devo sottoscrivere ogni Pagina separatamente?
Sì. subscribed_apps funziona per Pagina, con il token di quella Pagina, mentre la sottoscrizione a livello di app per l'oggetto page si applica alle Pagine che hanno installato l'app.
Perché subscribed_apps restituisce l'errore 200?
Meta classifica il codice 200 come errore di permessi per questo edge. Verifica che il token abbia pages_manage_metadata e pages_show_list e provenga da qualcuno con CREATE_CONTENT, MANAGE o MODERATE.
Si può sottoscrivere una Pagina da Graph API Explorer?
Sì. La guida di Meta sceglie l'app, ottiene un user token con pages_manage_metadata, lo scambia con il token della Pagina e invia il POST a {page-id}/subscribed_apps.
Posso aggiungere campi webhook a una Pagina connessa a easyCoexistence?
Non tramite i suoi strumenti: nessuno raggiunge i percorsi subscribed_apps, e la Pagina resta sottoscritta a feed, messages e mention, i campi che easyCoexistence inoltra.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il