AccediInizia la prova gratuita
easyCoexistence API ufficiali

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.

Both levels

Solo i campi sottoscritti sia a livello di Pagina sia a livello di app producono webhook; una Pagina può elencarne più dell'app.

CREATE_CONTENT, MANAGE or MODERATE

Le attività della Pagina: la persona dietro il token ne deve avere una per leggere o creare una sottoscrizione.

messaging_success

Restituito insieme a success quando un'app rimuove la propria sottoscrizione webhook da una Pagina con DELETE.

App access token

Cosa richiede /{app-id}/subscriptions per leggere, creare o eliminare la sottoscrizione a livello di app.

1 hour

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:

Subscribing a Page to three fields
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, e pages_manage_metadata con pages_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_engagement e ads_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:

Reading a Page's subscriptions
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.
Farlo con EasyCoexistence

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