Campi webhook di Facebook Page: l'elenco completo
Il riferimento di Meta sui webhook della Pagina documenta 64 campi di sottoscrizione: feed per post, commenti e reazioni, mention per le menzioni della Pagina, campi Messenger come messages, message_echoes, messaging_postbacks e message_reads, e campi profilo come name, picture, hours e website. Ognuno richiede pages_manage_metadata, e un'app riceve un campo solo quando è sottoscritto sia a livello di app sia dalla Pagina tramite subscribed_apps.
easyCoexistence sottoscrive ogni Pagina che colleghi a feed, messages e mention e inoltra quegli eventi al tuo endpoint HTTPS man mano che arrivano, firmati con X-EC-Signature, mentre le regole per i commenti e le automazioni agiscono su nuovi commenti e messaggi.
Campi di sottoscrizione documentati nel riferimento sui webhook della Pagina di Meta, da feed e mention ai campi Messenger e profilo.
Permesso che un amministratore della Pagina con privilegi MODERATE deve concedere prima che i webhook della Pagina raggiungano un'app.
Un campo Messenger separato per i messaggi inviati dalla Pagina, disponibile solo per le conversazioni Messenger.
Compito della Pagina richiesto per sottoscrivere leadgen, con leads_retrieval, ads_management, pages_read_engagement e pages_manage_metadata.
Solo i campi sottoscritti sia a livello della Pagina sia a livello dell'app producono webhook.
Come sono organizzati i campi webhook della Pagina?
Meta li documenta in un'unica pagina di riferimento per l'oggetto Page, e si dividono in tre famiglie: attività sulla Pagina e intorno a essa, conversazioni Messenger e modifiche ai dettagli della Pagina stessa. Feed, mention e modifiche al profilo arrivano in entry.changes, ciascuno con il proprio campo indicato, oppure come changed_fields quando l'app ha disattivato Include Values; gli eventi Messenger arrivano in entry.messaging, oppure in entry.standby per un'app che non possiede la conversazione.
Quali campi segnalano l'attività sulla Pagina?
Dodici campi riguardano contenuti e attività, non conversazioni. Un nuovo commento, per esempio, arriva su feed come modifica con item impostato su comment e verb impostato su add, insieme alle reazioni, alle condivisioni e ai post della Pagina stessa. Cosa consegna ciascuno, secondo il riferimento di Meta:
Quali campi trasportano gli eventi Messenger?
Messenger ha l'elenco più lungo, e la guida ai webhook Messenger di Meta spiega cosa invia ciascun campo. Questi tredici coprono le conversazioni di una Pagina; standby, che porta i messaggi a un'app che non possiede la conversazione, è documentato in quella guida e non nel riferimento della Pagina:
Quali altri campi Messenger esistono?
Altri dieci servono prodotti specifici, dalle chiamate al commercio fino alle segnalazioni di integrità:
send_cart: un messaggio con informazioni sul carrello o sull'ordine;message_context: rilevamenti che i modelli di Meta fanno su un messaggio, con un nome evento e un punteggio.- calls,
call_settings_updateecall_permission_reply: chiamate vocali Messenger, modifiche alle impostazioni di chiamata della Pagina e la risposta di una persona alla richiesta di permesso di chiamare. messaging_customer_information: ciò che una persona ha inserito in una schermata di informazioni cliente;messaging_in_thread_lead_form_submit: un modulo lead inviato all'interno della conversazione.message_template_status_update: lo stato di revisione di un template di messaggio di utilità è cambiato.business_integrityemessaging_integrity: aggiornamenti di integrità, con eventi di violazione, restrizione e azione inbusiness_integrity.
Quali campi segnalano le modifiche al profilo della Pagina?
Ventinove campi segnalano modifiche ai dettagli della Pagina, uno per ciascun dettaglio, e ognuno arriva come modifica che ne indica il nome:
- Identità: name, picture, category, che ne accetta fino a tre, e description, la Story Description.
- Dati aziendali:
company_overview, mission, founded, products,general_info,general_manager, members, awards e affiliation. - Contatto e luogo: email, phone, website, location, hours,
current_location, hometown, parking epublic_transit. - Locale:
price_range,payment_options, attire eculinary_team. - Personali: birthday,
personal_infoepersonal_interests.
Quale permesso richiede ciascun campo?
pages_manage_metadata per tutti, concesso da un amministratore della Pagina con privilegi MODERATE, e altri per alcuni. La Pagina si sottoscrive tramite subscribed_apps, e le guide di Meta fissano il token e i permessi per ciascun tipo di campo; per ricevere eventi su persone esterne ai ruoli dell'app, i permessi richiedono anche Advanced Access:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
A quali campi si sottoscrive easyCoexistence?
Tre: feed, messages e mention. Quando una Pagina si connette, easyCoexistence invia POST /{page-id}/subscribed_apps con quei campi e il token della Pagina, poi inoltra ogni entry per quella Pagina all'endpoint che hai impostato, firmato con X-EC-Signature. Le regole per i commenti e le automazioni agiscono sui nuovi commenti dal feed e sui messaggi, e le mention vengono inoltrate così come sono. Nessun altro campo è sottoscritto, quindi echo, postback, conferme di lettura, passaggi di consegna, standby e modifiche al profilo non vengono inoltrati.
Errori comuni
- Sottoscrivere la Pagina a un campo che l'app non ha sottoscritto. Meta consegna solo i campi sottoscritti sia a livello della Pagina sia a livello dell'app.
- Analizzare gli eventi Messenger come modifiche. Arrivano in entry.messaging, con un oggetto messaging per entry, non in entry.changes.
- Aspettarsi le risposte della Pagina sui messaggi. I messaggi inviati dalla Pagina arrivano su message_echoes, un campo separato.
- Contare su feed per i Mi piace di una Pagina grande. Meta invia notifiche di Mi piace solo per le Pagine con meno di 10.000 Mi piace.
Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e 3 giorni di prova gratuita.
Domande frequenti
Il campo feed include i commenti sugli annunci?
Sì. Meta non invia nulla per i post pubblicitari in sé, ma i commenti su di essi arrivano su feed.
Cosa cambia l'impostazione Include Values?
Attivata, una modifica contiene i nuovi valori in changes. Disattivata, Meta invia solo i nomi dei campi modificati, in changed_fields.
Come vedo a quali campi è sottoscritta una Pagina?
GET /{page-id}/subscribed_apps con il token della Pagina elenca le app installate dalla Pagina e, per ciascuna, i suoi subscribed_fields.
easyCoexistence inoltra le modifiche al profilo della Pagina?
No. Le Pagine collegate a easyCoexistence sono sottoscritte solo a feed, messages e mention, quindi nome, foto e gli altri campi del profilo non vengono inoltrati.
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