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

Εγγραφή μιας Σελίδας Facebook στα webhooks: το edge subscribed_apps

Μια Σελίδα Facebook εγγράφεται στα webhooks μιας εφαρμογής με POST /{page-id}/subscribed_apps, περνώντας subscribed_fields όπως feed,messages, και ένα access token της Σελίδας από κάποιον με την εργασία CREATE_CONTENT, MANAGE ή MODERATE, με τα δικαιώματα pages_manage_metadata και pages_show_list. Η Meta στέλνει τα συμβάντα ενός πεδίου μόνο όταν και η εφαρμογή εγγράφεται σε αυτό. Το GET εμφανίζει την εγγραφή και το DELETE την αφαιρεί.

Το easyCoexistence εγγράφει κάθε Σελίδα που συνδέετε στα feed, messages και mention μέσω subscribed_apps, την αποεγγράφει όταν την αφαιρείτε και προωθεί τα συμβάντα της Σελίδας στο HTTPS endpoint σας, υπογεγραμμένα με μυστικό για εκείνη τη Σελίδα, από έναν μόνο σύνδεσμο MCP ή από το Partner API.

Both levels

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

CREATE_CONTENT, MANAGE or MODERATE

Οι εργασίες της Σελίδας, μία από τις οποίες χρειάζεται το άτομο πίσω από το token για να διαβάσει ή να δημιουργήσει εγγραφή.

messaging_success

Επιστρέφεται δίπλα στο success όταν μια εφαρμογή αφαιρεί την εγγραφή webhook της από μια Σελίδα με DELETE.

App access token

Τι απαιτεί το /{app-id}/subscriptions για να διαβάσει, να δημιουργήσει ή να διαγράψει την εγγραφή σε επίπεδο εφαρμογής.

1 hour

Αποτυχημένες παραδόσεις Messenger, μετά τις οποίες η Meta αποσυνδέει την εφαρμογή από τη Σελίδα μέχρι να εγγραφεί ξανά.

Τι κάνει το edge subscribed_apps;

Εγκαθιστά την εφαρμογή στη Σελίδα και ορίζει ποια από τα πεδία webhook της Σελίδας λαμβάνει η εφαρμογή. Η Meta στέλνει ειδοποιήσεις μόνο όσο η Σελίδα έχει εγκατεστημένη την εφαρμογή και δεν έχει απενεργοποιήσει την πλατφόρμα εφαρμογών στις ρυθμίσεις της, και μόνο για πεδία εγγεγραμμένα και στα δύο επίπεδα: της Σελίδας, μέσω αυτού του edge, και της εφαρμογής, που ορίζεται στο App Dashboard ή μέσω του /{app-id}/subscriptions. Μια Σελίδα μπορεί να είναι εγγεγραμμένη σε περισσότερα πεδία από την εφαρμογή.

Πώς εγγράφετε μια Σελίδα;

Με ένα POST στο edge, με subscribed_fields που παραθέτει τα πεδία χωρισμένα με κόμμα, και το access token της Σελίδας. Μια επιτυχημένη κλήση επιστρέφει success true, και μια κλήση που περιλαμβάνει messages χρειάζεται και pages_messaging στο token:

Subscribing a Page to three fields
POST https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed,messages,mention
  &access_token=<PAGE_ACCESS_TOKEN>

{ "success": true }

Ποιο token, ποιες εργασίες και ποια δικαιώματα χρειάζεται;

Ένα access token της Σελίδας, που δένει την κλήση με μία Σελίδα, από κάποιον που μπορεί να ενεργεί για τη Σελίδα αυτή. Οι αναφορές και οι οδηγοί της Meta ορίζουν αυτές τις απαιτήσεις:

  • Οποιοδήποτε πεδίο: ένα άτομο με την εργασία CREATE_CONTENT, MANAGE ή MODERATE, και τα pages_manage_metadata με pages_show_list.
  • messages και τα άλλα πεδία Messenger: επιπλέον pages_messaging, σε token από κάποιον που μπορεί να εκτελέσει την εργασία MESSAGING.
  • leadgen: η εργασία ADVERTISE, με leads_retrieval, pages_read_engagement και ads_management.
  • Η ανάγνωση της εγγραφής με GET απαιτεί τις ίδιες εργασίες και δικαιώματα με τη δημιουργία της.

Ποιο επίπεδο πρόσβασης χρειάζονται τα πεδία;

Advanced Access, για Σελίδες και άτομα εκτός των ρόλων της ίδιας της εφαρμογής. Με Standard Access, οι ειδοποιήσεις Messenger έρχονται μόνο από άτομα με ρόλο στην εφαρμογή, όπως διαχειριστές, προγραμματιστές και δοκιμαστές. Το Advanced Access, που χορηγείται ανά δικαίωμα μέσω του App Review και απαιτεί Business Verification, τις ανοίγει στους πελάτες της εφαρμογής. Ο οδηγός Messenger της Meta αναφέρει επίσης τη δημοσίευση της εφαρμογής ανάμεσα στις προϋποθέσεις.

Τι είναι η εγγραφή σε επίπεδο εφαρμογής;

Το άλλο μισό: τα πεδία που ακούει η ίδια η εφαρμογή, με το callback URL της. Ορίζεται στο App Dashboard ή με POST /{app-id}/subscriptions και app access token, περνώντας object=page, callback_url, fields, include_values και verify_token, πράγμα που ενεργοποιεί το αίτημα επαλήθευσης της Meta. Το GET στο ίδιο edge δείχνει το callback_url, τα fields και αν η εγγραφή είναι ενεργή για κάθε αντικείμενο. Ένα νέο POST τροποποιεί τα πεδία χωρίς να αντικαθιστά τα υπόλοιπα, και το DELETE αφαιρεί όλα ή μόνο τα ονομαζόμενα πεδία.

Πώς ελέγχετε σε τι είναι εγγεγραμμένη μια Σελίδα;

Με GET στο ίδιο edge και το token της Σελίδας. Ο πίνακας data παραθέτει κάθε εφαρμογή που έχει εγκαταστήσει η Σελίδα, με το όνομά της, το ID της και τα subscribed_fields, και επιστρέφει κενός όταν η Σελίδα δεν έχει εγκατεστημένες εφαρμογές:

Reading a Page's subscriptions
GET https://graph.facebook.com/{page-id}/subscribed_apps
  ?access_token=<PAGE_ACCESS_TOKEN>

{
  "data": [
    {
      "category": "Business",
      "link": "https://example.com/app",
      "name": "<APP_NAME>",
      "id": "<APP_ID>",
      "subscribed_fields": ["feed", "messages", "mention"]
    }
  ]
}

Πώς αφαιρείτε μια εγγραφή;

Με DELETE /{page-id}/subscribed_apps, που αποσυνδέει την εφαρμογή από τη Σελίδα. Μια εφαρμογή μπορεί να αφαιρέσει τη δική της εγγραφή με app access token, και η απάντηση περιλαμβάνει τα success και messaging_success. Η Meta την αφαιρεί και μόνη της: μετά από μία ώρα αποτυχημένων παραδόσεων Messenger, η εφαρμογή αποσυνδέεται από τη Σελίδα και πρέπει να εγγραφεί ξανά όταν λειτουργεί το endpoint της.

Τι κάνει το easyCoexistence κατά τη σύνδεση;

Εγγράφει κάθε Σελίδα που επιλέγει το άτομο, αμέσως μετά την αποθήκευση του token της Σελίδας: POST /{page-id}/subscribed_apps με subscribed_fields feed,messages,mention. Αν η Meta αρνηθεί, η Σελίδα μένει συνδεδεμένη και το list_social_accounts δείχνει τον λόγο στο last_error. Η αφαίρεση της Σελίδας στέλνει DELETE /{page-id}/subscribed_apps πριν διαγραφεί το token, και κανένα εργαλείο δεν φτάνει σε διαδρομές subscribed_apps ή token, οπότε την εγγραφή τη διαχειρίζεται μόνο το easyCoexistence.

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

  • Κλήση του edge με user access token. Θέλει το access token της Σελίδας που εγγράφεται.
  • Εγγραφή της Σελίδας χωρίς της εφαρμογής. Ένα πεδίο φτάνει στο callback μόνο όταν η δική του εγγραφή της εφαρμογής το περιλαμβάνει επίσης.
  • Παράλειψη του pages_messaging όταν εγγράφεστε σε messages. Η Meta το απαιτεί, σε token από κάποιον που μπορεί να εκτελέσει την εργασία MESSAGING.
  • Να μην ξαναγράψετε τη Σελίδα μετά από διακοπή. Μία ώρα αποτυχημένων παραδόσεων Messenger αποσυνδέει την εφαρμογή, και τα συμβάντα σταματούν μέχρι να σταλεί ξανά το POST.
Κάντε το με EasyCoexistence

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

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

Χρειάζεται να εγγράψω κάθε Σελίδα ξεχωριστά;

Ναι. Το subscribed_apps λειτουργεί ανά Σελίδα, με το δικό της token, ενώ η εγγραφή σε επίπεδο εφαρμογής για το αντικείμενο page ισχύει για τις Σελίδες που έχουν εγκαταστήσει την εφαρμογή.

Γιατί το subscribed_apps επιστρέφει σφάλμα 200;

Η Meta καταγράφει το 200 ως σφάλμα δικαιωμάτων για αυτό το edge. Ελέγξτε ότι το token έχει pages_manage_metadata και pages_show_list και προέρχεται από κάποιον με CREATE_CONTENT, MANAGE ή MODERATE.

Μπορεί να εγγραφεί μια Σελίδα από το Graph API Explorer;

Ναι. Ο οδηγός της Meta επιλέγει την εφαρμογή, παίρνει user token με pages_manage_metadata, το ανταλλάσσει με το token της Σελίδας και στέλνει το POST στο {page-id}/subscribed_apps.

Μπορώ να προσθέσω πεδία webhook σε μια Σελίδα συνδεδεμένη στο easyCoexistence;

Όχι μέσω των εργαλείων του: κανένα δεν φτάνει σε διαδρομές subscribed_apps, και η Σελίδα μένει εγγεγραμμένη στα feed, messages και mention, τα πεδία που προωθεί το easyCoexistence.

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

Πεδία webhook της Facebook Page: η πλήρης λίσταΤα 64 πεδία webhook της Facebook Page της Meta: feed, mention, πεδία Messenger όπως τα messages, πεδία προφίλ και το δικαίωμα του καθενός.Επαλήθευση του webhook του Facebook: hub.challenge και X-Hub-Signature-256Επαλήθευση του webhook του Facebook: επιστροφή του hub.challenge όταν το hub.verify_token ταιριάζει, και έλεγχος του X-Hub-Signature-256 με το App Secret.Δικαιώματα API σελίδων Facebook και απαιτήσεις App ReviewΤα εννέα δικαιώματα σελίδων Facebook, τι ανοίγει το καθένα και τι ζητά η Meta στο App Review: Advanced Access, επαλήθευση επιχείρησης, εγγραφή οθόνης.Token πρόσβασης σελίδας Facebook: πόσο διαρκεί και τι το ακυρώνειΠώς αποκτάται token πρόσβασης σελίδας Facebook χωρίς ημερομηνία λήξης, ποιος μπορεί να το αποκτήσει και τι κάνει τη Meta να σταματήσει να το δέχεται.Webhook του feed σελίδας Facebook: σχόλια, αναρτήσεις και αντιδράσειςΤι στέλνει το webhook του feed σελίδας Facebook για σχόλια, αναρτήσεις και αντιδράσεις, με τα πεδία item και verb και τη μορφή του payload της Meta.Πρωτόκολλο μεταβίβασης Messenger: κοινή χρήση του inbox μιας Σελίδας μεταξύ AI agent και ανθρώπωνΠώς μεταβιβάζονται οι συνομιλίες Messenger μιας Σελίδας Facebook μεταξύ εφαρμογών και του inbox: Conversation Routing, pass_thread_control και thread owner.

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

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

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

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