ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Πεδία webhook της Facebook Page: η πλήρης λίστα

Η τεκμηρίωση της Meta για τα webhooks των Pages περιγράφει 64 πεδία συνδρομής: το feed για αναρτήσεις, σχόλια και αντιδράσεις, το mention για αναφορές της Page, πεδία Messenger όπως τα messages, message_echoes, messaging_postbacks και message_reads, και πεδία προφίλ όπως name, picture, hours και website. Κάθε πεδίο χρειάζεται το pages_manage_metadata, και μια εφαρμογή λαμβάνει ένα πεδίο μόλις εγγραφεί σε αυτό τόσο σε επίπεδο εφαρμογής όσο και από την Page μέσω του subscribed_apps.

Το easyCoexistence εγγράφει κάθε Page που συνδέετε στα feed, messages και mention και προωθεί αυτά τα συμβάντα στο HTTPS endpoint σας όπως φτάνουν, υπογεγραμμένα με X-EC-Signature, ενώ οι κανόνες σχολίων και οι αυτοματισμοί ενεργούν σε νέα σχόλια και μηνύματα.

64

Πεδία συνδρομής που τεκμηριώνονται στην αναφορά της Meta για τα webhooks των Pages, από το feed και το mention έως τα πεδία Messenger και προφίλ.

pages_manage_metadata

Δικαίωμα που πρέπει να χορηγήσει διαχειριστής της Page με προνόμια MODERATE πριν τα webhooks της Page φτάσουν σε μια εφαρμογή.

message_echoes

Ξεχωριστό πεδίο Messenger για τα μηνύματα που στέλνει η Page, διαθέσιμο μόνο για συζητήσεις Messenger.

ADVERTISE

Εργασία της Page που απαιτείται για συνδρομή στο leadgen, με leads_retrieval, ads_management, pages_read_engagement και pages_manage_metadata.

Both levels

Μόνο τα πεδία που έχουν εγγραφεί τόσο σε επίπεδο Page όσο και εφαρμογής παράγουν webhooks.

Πώς είναι οργανωμένα τα πεδία webhook της Page;

Η Meta τα τεκμηριώνει σε μία σελίδα αναφοράς για το αντικείμενο Page, και χωρίζονται σε τρεις οικογένειες: δραστηριότητα πάνω και γύρω από τη Page, συζητήσεις Messenger, και επεξεργασίες των δικών της στοιχείων. Οι αλλαγές feed, mention και προφίλ φτάνουν στο entry.changes, με κάθε μία να ονομάζει το πεδίο της, ή ως changed_fields όταν η εφαρμογή έχει απενεργοποιήσει το Include Values. Τα συμβάντα Messenger φτάνουν στο entry.messaging, ή στο entry.standby για εφαρμογή που δεν κατέχει τη συζήτηση.

Ποια πεδία αναφέρουν δραστηριότητα στη Page;

Δώδεκα πεδία καλύπτουν περιεχόμενο και δραστηριότητα αντί για συζητήσεις. Ένα νέο σχόλιο, για παράδειγμα, φτάνει στο feed ως αλλαγή με item ορισμένο σε comment και verb ορισμένο σε add, μαζί με τις αντιδράσεις, τις κοινοποιήσεις και τις δικές της αναρτήσεις της Page. Τι παραδίδει το καθένα, στην αναφορά της 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

Ποια πεδία μεταφέρουν συμβάντα Messenger;

Το Messenger έχει τη μακρύτερη λίστα, και ο οδηγός webhook Messenger της Meta περιγράφει τι στέλνει το καθένα. Αυτά τα δεκατρία καλύπτουν τις συζητήσεις μιας Page, ενώ το standby, που μεταφέρει μηνύματα σε εφαρμογή που δεν κατέχει τη συζήτηση, τεκμηριώνεται σε αυτόν τον οδηγό και όχι στην αναφορά της Page:

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

Ποια άλλα πεδία Messenger υπάρχουν;

Δέκα ακόμη εξυπηρετούν συγκεκριμένα προϊόντα, από τις κλήσεις έως το εμπόριο και την αναφορά ακεραιότητας:

  • send_cart: μήνυμα που μεταφέρει πληροφορίες καλαθιού ή παραγγελίας. message_context: ανιχνεύσεις που κάνουν τα μοντέλα της Meta σε ένα μήνυμα, με όνομα συμβάντος και βαθμολογία.
  • calls, call_settings_update και call_permission_reply: κλήσεις φωνής Messenger, αλλαγές στις ρυθμίσεις κλήσεων της Page και η απάντηση ενός ατόμου σε αίτημα άδειας για κλήση.
  • messaging_customer_information: όσα συμπλήρωσε ένα άτομο σε οθόνη πληροφοριών πελάτη. messaging_in_thread_lead_form_submit: φόρμα ενδιαφέροντος που υποβλήθηκε μέσα στη συζήτηση.
  • message_template_status_update: άλλαξε η κατάσταση ελέγχου ενός πρότυπου μηνύματος τύπου utility.
  • business_integrity και messaging_integrity: ενημερώσεις ακεραιότητας, με συμβάντα παραβάσεων, περιορισμών και ενεργειών στο business_integrity.

Ποια πεδία αναφέρουν αλλαγές στο προφίλ της Page;

Είκοσι εννέα πεδία αναφέρουν επεξεργασίες των δικών της στοιχείων, ένα πεδίο για κάθε στοιχείο, με κάθε μία να φτάνει ως αλλαγή που το ονομάζει:

  • Ταυτότητα: name, picture, category, που κρατά έως τρεις κατηγορίες, και description, η Story Description.
  • Στοιχεία επιχείρησης: company_overview, mission, founded, products, general_info, general_manager, members, awards και affiliation.
  • Επικοινωνία και τοποθεσία: email, phone, website, location, hours, current_location, hometown, parking και public_transit.
  • Χώρος: price_range, payment_options, attire και culinary_team.
  • Προσωπικά: birthday, personal_info και personal_interests.

Ποιο δικαίωμα χρειάζεται κάθε πεδίο;

Το pages_manage_metadata για οποιοδήποτε από αυτά, χορηγημένο από διαχειριστή της Page με προνόμια MODERATE, και περισσότερα για ορισμένα. Η Page εγγράφεται μέσω του subscribed_apps, και οι οδηγοί της Meta ορίζουν το token και τα δικαιώματα ανά είδος πεδίου. Για να λαμβάνει η εφαρμογή συμβάντα για άτομα εκτός των δικών της ρόλων, τα δικαιώματα χρειάζονται επίσης 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

Σε ποια πεδία εγγράφεται το easyCoexistence;

Σε τρία: feed, messages και mention. Όταν μια Page συνδέεται, το easyCoexistence στέλνει POST /{page-id}/subscribed_apps με αυτά τα πεδία και το token της Page, και στη συνέχεια προωθεί κάθε entry για αυτή τη Page στο endpoint που ορίσατε, υπογεγραμμένο με X-EC-Signature. Οι κανόνες σχολίων και οι αυτοματισμοί ενεργούν σε νέα σχόλια από το feed και σε μηνύματα, ενώ τα mention προωθούνται όπως έρχονται. Κανένα άλλο πεδίο δεν εγγράφεται, οπότε δεν προωθούνται τα message_echoes, τα messaging_postbacks, οι αποδείξεις, οι μεταβιβάσεις, το standby και οι αλλαγές προφίλ.

Συνηθισμένα λάθη

  • Εγγραφή της Page σε πεδίο που η εφαρμογή δεν έχει εγγράψει. Η Meta παραδίδει μόνο πεδία εγγεγραμμένα τόσο σε επίπεδο Page όσο και εφαρμογής.
  • Ανάλυση συμβάντων Messenger ως αλλαγών. Φτάνουν στο entry.messaging, με ένα αντικείμενο messaging ανά entry, και όχι στο entry.changes.
  • Αναμονή των απαντήσεων της ίδιας της Page σε μηνύματα. Τα μηνύματα που στέλνει η Page φτάνουν στο message_echoes, ένα ξεχωριστό πεδίο.
  • Υπολογισμός στο feed για likes σε μεγάλη Page. Η Meta στέλνει ειδοποιήσεις likes μόνο για Pages με λιγότερα από 10.000 likes.
Κάντε το με EasyCoexistence

Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Περιλαμβάνει το πεδίο feed σχόλια σε διαφημίσεις;

Ναι. Η Meta δεν στέλνει τίποτα για τις ίδιες τις διαφημιστικές αναρτήσεις, αλλά τα σχόλια πάνω τους φτάνουν στο feed.

Τι αλλάζει η ρύθμιση Include Values;

Όταν είναι ενεργή, μια αλλαγή μεταφέρει τις νέες τιμές στο changes. Όταν είναι απενεργοποιημένη, η Meta στέλνει μόνο τα ονόματα των αλλαγμένων πεδίων, στο changed_fields.

Πώς βλέπω σε ποια πεδία είναι εγγεγραμμένη μια Page;

Το GET /{page-id}/subscribed_apps με το token της Page εμφανίζει τις εφαρμογές που έχει εγκαταστήσει η Page και, για καθεμία, τα subscribed_fields της.

Προωθεί το easyCoexistence αλλαγές προφίλ της Page;

Όχι. Οι Pages που συνδέονται με το easyCoexistence εγγράφονται μόνο στα feed, messages και mention, οπότε το name, το picture και τα άλλα πεδία προφίλ δεν προωθούνται.

Συνεχίστε την ανάγνωση

Επαλήθευση του webhook του Facebook: hub.challenge και X-Hub-Signature-256Επαλήθευση του webhook του Facebook: επιστροφή του hub.challenge όταν το hub.verify_token ταιριάζει, και έλεγχος του X-Hub-Signature-256 με το App Secret.Εγγραφή μιας Σελίδας Facebook στα webhooks: το edge subscribed_appsΠώς το POST /{page-id}/subscribed_apps εγγράφει μια Σελίδα Facebook σε πεδία webhook: tokens, εργασίες, εγγραφή εφαρμογής, έλεγχος, αφαίρεση.Webhook του feed σελίδας Facebook: σχόλια, αναρτήσεις και αντιδράσειςΤι στέλνει το webhook του feed σελίδας Facebook για σχόλια, αναρτήσεις και αντιδράσεις, με τα πεδία item και verb και τη μορφή του payload της Meta.Το webhook του Messenger για Σελίδες Facebook: μηνύματα και συμβάντα μνείαςΤα πεδία του webhook της Σελίδας Facebook για μηνύματα και μνείες: σχήμα payload, ID αποστολέων, συνημμένα και πώς φτάνουν τα συμβάντα στο endpoint σας.Messenger profile API: χαιρετισμός, Get Started, ice breakers και μόνιμο μενούΟρίστε το Messenger profile της Σελίδας Facebook στο /{page-id}/messenger_profile: Get Started, χαιρετισμός, ice breakers, μόνιμο μενού και εντολές.Ανάγνωση του ιστορικού συνομιλιών Messenger μέσω του APIΔιαβάστε το ιστορικό Messenger μιας Σελίδας Facebook με το Conversations API: /{page-id}/conversations, πεδία, όριο 20 μηνυμάτων και δικαιώματα.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις