Πεδία 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, ενώ οι κανόνες σχολίων και οι αυτοματισμοί ενεργούν σε νέα σχόλια και μηνύματα.
Πεδία συνδρομής που τεκμηριώνονται στην αναφορά της Meta για τα webhooks των Pages, από το feed και το mention έως τα πεδία Messenger και προφίλ.
Δικαίωμα που πρέπει να χορηγήσει διαχειριστής της Page με προνόμια MODERATE πριν τα webhooks της Page φτάσουν σε μια εφαρμογή.
Ξεχωριστό πεδίο Messenger για τα μηνύματα που στέλνει η Page, διαθέσιμο μόνο για συζητήσεις Messenger.
Εργασία της Page που απαιτείται για συνδρομή στο leadgen, με leads_retrieval, ads_management, pages_read_engagement και pages_manage_metadata.
Μόνο τα πεδία που έχουν εγγραφεί τόσο σε επίπεδο 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:
Ποια πεδία μεταφέρουν συμβάντα Messenger;
Το Messenger έχει τη μακρύτερη λίστα, και ο οδηγός webhook Messenger της Meta περιγράφει τι στέλνει το καθένα. Αυτά τα δεκατρία καλύπτουν τις συζητήσεις μιας Page, ενώ το standby, που μεταφέρει μηνύματα σε εφαρμογή που δεν κατέχει τη συζήτηση, τεκμηριώνεται σε αυτόν τον οδηγό και όχι στην αναφορά της Page:
Ποια άλλα πεδία 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:
| 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 |
Σε ποια πεδία εγγράφεται το 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.
Από 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 και τα άλλα πεδία προφίλ δεν προωθούνται.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις