AccediInizia la prova gratuita
easyCoexistence API ufficiali

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.

64

Campi di sottoscrizione documentati nel riferimento sui webhook della Pagina di Meta, da feed e mention ai campi Messenger e profilo.

pages_manage_metadata

Permesso che un amministratore della Pagina con privilegi MODERATE deve concedere prima che i webhook della Pagina raggiungano un'app.

message_echoes

Un campo Messenger separato per i messaggi inviati dalla Pagina, disponibile solo per le conversazioni Messenger.

ADVERTISE

Compito della Pagina richiesto per sottoscrivere leadgen, con leads_retrieval, ads_management, pages_read_engagement e pages_manage_metadata.

Both levels

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:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

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:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

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_update e call_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_integrity e messaging_integrity: aggiornamenti di integrità, con eventi di violazione, restrizione e azione in business_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 e public_transit.
  • Locale: price_range, payment_options, attire e culinary_team.
  • Personali: birthday, personal_info e personal_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:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

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.
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 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