Webhook per le Pagine

I webhook per le Pagine possono inviarti notifiche in tempo reale delle modifiche alle tue Pagine. Ad esempio, puoi ricevere aggiornamenti in tempo reale ogni volta che gli utenti pubblicano qualcosa nel tuo feed, commentano o mettono "Mi piace" a un post.

Per configurare un webhook per una Pagina:

1. Configura il tuo endpoint e imposta il prodotto Webhooks.
2. Installa la tua app usando la tua Pagina Facebook.

Configurazione dell'endpoint e del prodotto Webhooks

Segui la nostra guida introduttiva per creare il tuo endpoint e configurare il prodotto Webhooks. Durante la configurazione, assicurati di scegliere l'oggetto Page e di attivare l'iscrizione a uno o più campi delle Pagine indicati di seguito.

Installazione dell'app

Le notifiche webhook vengono inviate solo se la tua Pagina ha installato l'app configurata per Webhooks e se non ha disabilitato la piattaforma dell'app nelle Impostazioni app. Per fare in modo che la tua Pagina installi l'app, quest'ultima deve inviare una richiesta POST al segmento subscribed_apps della Pagina usando il token d'accesso della Pagina.

Requisiti

• Il token d'accesso della Pagina richiesto da una persona che può eseguire l'attività CREATE_CONTENT, MANAGE o MODERATE sulla Pagina interrogata
• Le autorizzazioni pages_manage_metadata e pages_show_list sono obbligatorie per i webhook feed
• pages_messaging è inoltre necessaria per i messages

Solo per i campi correlati ai messaggi

• Il token d'accesso della Pagina richiesto da una persona che può eseguire l'attività MESSAGING sulla Pagina interrogata
• pages_messaging

Esempio di richiesta

curl -i -X POST "https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed
  &access_token={page-access-token}"

Esempio di risposta

{
  "success": "true"
}

Per vedere quale app è stata installata dalla tua Pagina, invia una richiesta GET:

Esempio di richiesta

curl -i -X GET "https://graph.facebook.com/{page-id}/subscribed_apps &access_token={page-access-token} 

Esempio di risposta

{
  "data": [
    {
      "category": "Business",
      "link": "https://my-clever-domain-name.com/app",
      "name": "My Sample App",
      "id": "{page-id}"
    }
  ]
}

Se la tua Pagina non ha installato nessuna app, l'API restituirà un set di dati vuoto.

Tool di esplorazione per la API Graph

Se non desideri installare la tua app a livello di codice, puoi facilmente farlo con il Tool di esplorazione per la API Graph:

1. Seleziona la tua app nel menu a discesa Applicazione. Questa operazione restituirà il token d'accesso della tua app.
2. Clicca sul menu a discesa Ricevi token e seleziona Ricevi token d'accesso dell'utente, quindi scegli l'autorizzazione pages_manage_metadata. Questa operazione sostituirà il tuo token dell'app con un token d'accesso utente che dispone dell'autorizzazione pages_manage_metadata.
3. Clicca di nuovo su Ricevi token e seleziona la tua Pagina. Questa operazione sostituirà il tuo token d'accesso utente con un token d'accesso della Pagina.
4. Modifica il metodo di funzionamento cliccando sul menu a discesa GET e selezionando POST.
5. Sostituisci la query me?fields=id,name predefinita con l'id della Pagina seguito da /subscribed_apps, quindi invia la query.

Utilizzi comuni

Ottenere i dettagli del feed delle Pagine

La tua app può attivare l'iscrizione al feed di una Pagina e ricevere una notifica ogni volta che si verifica una modifica associata al feed. Ad esempio, ecco una notifica inviata quando un utente ha pubblicato qualcosa su una Pagina.

Esempio di risposta webhook

[
  {
    "entry": [
      {
        "changes": [
          {
            "field": "feed",
            "value": {
              "from": {
                "id": "{user-id}",
                "name": "Cinderella Hoover"
              },
              "item": "post",
              "post_id": "{page-post-id}",
              "verb": "add",
              "created_time": 1520544814,
              "is_hidden": false,
              "message": "It's Thursday and I want to eat cake."
            }
          }
        ],
        "id": "{page-id}",
        "time": 1520544816
      }
    ],
    "object": "page"
  }
]

Usa il valore post_id della notifica per commentare quel post della Pagina.

Esempio di richiesta API

curl -i -X POST   "https://graph.facebook.com/{page-post-id}/comments
  ?message=I%20want%20chocolate%20cake%20!
  &access_token=page-access-token" 

Esempio di risposta API

{
  "id": "{comment-id}"
}