Webhook del feed di una Pagina Facebook: eventi di commento, post e reazione
Il campo feed dei webhook delle Pagine di Facebook segnala quasi tutte le modifiche al feed di una Pagina non appena avvengono. Ogni modifica contiene un item, come post, comment o reaction, e un verb, come add, edit o remove, oltre agli ID coinvolti, l'autore in from e il testo in message. Meta lo invia come JSON, firmato con X-Hub-Signature-256.
easyCoexistence iscrive ogni Pagina che colleghi al campo feed e inoltra le sue modifiche al tuo endpoint HTTPS non appena arrivano, firmate con il segreto di quella Pagina, mentre le regole di comment-to-DM e le automazioni agiscono sui nuovi commenti.
Le notifiche del feed per i Mi piace delle Pagine vengono inviate solo alle Pagine con meno Mi piace di questo valore.
Il campo feed non invia nulla per i post pubblicitari in sé, ma invia i commenti su di essi.
Il permesso che un amministratore della Pagina con privilegi MODERATE deve concedere perché i webhook delle Pagine raggiungano un'app.
La maggior parte degli aggiornamenti Meta li raggruppa in un'unica consegna del webhook, ma non garantisce il raggruppamento.
Per quanto tempo Meta continua a ritentare una consegna non riuscita all'endpoint dell'app, con frequenza decrescente.
Cosa segnala il campo feed?
Quasi tutte le modifiche al feed di una Pagina, secondo le parole di Meta, come post, commenti, reazioni e condivisioni; ciò che una modifica contiene dipende dal suo tipo. Meta non invia nulla per i post pubblicitari in sé, anche se arrivano i commenti su di essi, e invia notifiche per i Mi piace alle Pagine solo finché una Pagina ha meno di 10.000 Mi piace.
Cosa significano item e verb?
Due campi del valore di ogni modifica indicano cosa è successo:
- item: cosa è cambiato, dall'elenco di Meta, che include post, status, photo, video, link, share, comment, reaction e album.
- verb: cosa è accaduto, ovvero add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute o update.
- Un nuovo commento arriva con item comment e verb add, cioè ciò che cercano le regole di comment-to-DM.
- Una reazione contiene item reaction e un
reaction_typeche la identifica.
Come appare una modifica del feed?
Una POST il cui JSON ha object impostato su page e una voce per Pagina, che contiene l'ID della Pagina, un orario e un array di changes. Questo è l'esempio stesso di Meta, una persona che pubblica sulla Pagina:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}Quali campi può contenere una modifica?
Il riferimento di Meta elenca questi tra i campi del valore di una modifica del feed, presenti a seconda del tipo di modifica:
post_id,comment_ideparent_id: il post, il commento e ciò a cui appartiene.- from: l'ID e il nome di chi ha effettuato la modifica.
- message: il testo, con link, photo, photos o video per i contenuti allegati.
created_time, eedited_timeper le modifiche.reaction_typeper le reazioni, eis_hiddenper indicare se un post è nascosto.- post: dettagli come
status_type,is_published,updated_timeepermalink_url.
Come si iscrive una Pagina?
L'app invia POST /{page-id}/subscribed_apps con subscribed_fields=feed e il token della Pagina, da parte di chi può eseguire il compito CREATE_CONTENT, MANAGE o MODERATE, con pages_manage_metadata e pages_show_list concessi. Meta invia notifiche solo mentre la Pagina ha installata l'app e non ha disattivato la piattaforma app nelle sue impostazioni. easyCoexistence iscrive ogni Pagina a feed, messages e mention quando si connette.
Come arrivano gli eventi del feed al tuo endpoint?
Meta li consegna all'app di easyCoexistence, che verifica X-Hub-Signature-256, risponde subito a Meta e inoltra ogni voce per una Pagina connessa all'endpoint HTTPS che hai impostato per essa. L'inoltro contiene un header X-EC-Signature, un HMAC-SHA256 di un timestamp e del corpo grezzo, firmato con il segreto di quella Pagina, e viene inviato una sola volta, senza copie conservate e senza nuovi tentativi. Imposta l'endpoint con set_social_webhook_destination oppure con PUT /channels/:id/webhook nella Partner API.
Quali modifiche del feed avviano regole per i commenti e automazioni?
Solo i nuovi commenti: una modifica con item comment e verb add su uno dei post della Pagina. Le regole di comment-to-DM controllano il campo message per le parole chiave e ignorano i commenti che la Pagina ha scritto da sé, mentre le automazioni prendono i commenti a cui nessuna regola ha risposto. Modifiche, contenuti nascosti, reazioni e post vanno direttamente al tuo endpoint, se ne hai impostato uno.
Errori comuni
- Trattare ogni modifica del feed come un nuovo commento. Controlla item e verb: reazioni, modifiche, nascondimenti e rimozioni arrivano sullo stesso campo.
- Rispondere ai commenti della Pagina stessa. Le sue risposte tornano anch'esse come modifiche del feed, quindi salta quelle il cui from.id è l'ID della Pagina.
- Supporre una modifica per consegna. Meta può raggruppare fino a 1.000 aggiornamenti, quindi scorri ogni voce e ogni modifica al suo interno.
- Leggere entry.time come il momento della modifica. Meta lo imposta all'invio della notifica; created_time nel valore indica quando l'oggetto è stato creato.
Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.
Domande frequenti
Il webhook del feed include i commenti?
Sì. Un nuovo commento arriva come modifica del feed con item comment e verb add, con comment_id, post_id, from e message.
Ricevo webhook per i Mi piace alle Pagine?
Solo per le Pagine con meno di 10.000 Mi piace, secondo il riferimento dei webhook delle Pagine di Meta.
I post pubblicitari sono nel webhook del feed?
Non i post pubblicitari in sé, ma vengono inviati i commenti su di essi.
Ho bisogno di una mia app Meta per ricevere gli eventi del feed di una Pagina?
No. Meta li consegna all'app di easyCoexistence, che inoltra ciascuno all'endpoint che hai impostato per quella Pagina.
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