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

Το webhook αναφοράς (mention) του Facebook: όταν κάποιος αναφέρει τη Σελίδα σας

Το πεδίο mention των webhooks σελίδας του Facebook ενημερώνει μια εφαρμογή όταν κάποιος αναφέρει τη Σελίδα με @ σε μια ανάρτηση ή σε ένα σχόλιο. Η Meta στέλνει μια αλλαγή (change) με το field ίσο με mention, της οποίας το value μπορεί να περιέχει το post_id, το comment_id για σχόλιο, το κείμενο στο message, τους συνδέσμους και τα πολυμέσα που επισυνάπτονται, καθώς και τα item και verb, σε ένα POST υπογεγραμμένο με X-Hub-Signature-256.

Η easyCoexistence εγγράφει κάθε Σελίδα που συνδέετε στο πεδίο mention, δίπλα στα feed και messages, και προωθεί τα γεγονότα αναφοράς της στο HTTPS endpoint σας καθώς φτάνουν.

mention

Πεδίο webhook Σελίδας για νέες αναφορές της Σελίδας, συμπεριλαμβανομένων αυτών σε σχόλια και αναρτήσεις.

pages_manage_metadata

Άδεια που πρέπει να χορηγήσει ένας διαχειριστής της Σελίδας με δικαιώματα MODERATE προτού τα webhooks της Σελίδας φτάσουν στο callback URL μιας εφαρμογής.

@ + name

Πώς αναφέρουν οι άνθρωποι μια Σελίδα σε ανάρτηση ή σχόλιο: πληκτρολογούν @ και το όνομα της Σελίδας, και μετά την επιλέγουν.

36 hours

Για πόσο χρόνο η Meta επαναλαμβάνει την αποστολή μιας αποτυχημένης ειδοποίησης της Σελίδας, με μειούμενη συχνότητα, πριν την απορρίψει.

tagged_time

Πεδίο που προσθέτει το edge /{page-id}/tagged σε κάθε δημόσια ανάρτηση στην οποία έχει επισημανθεί η Σελίδα.

Τι ενεργοποιεί το webhook mention;

Κάποιος που αναφέρει τη Σελίδα σε ανάρτηση ή σχόλιο. Στο Facebook, η αναφορά γίνεται πληκτρολογώντας @ και το όνομα της Σελίδας και επιλέγοντάς την από τις προτάσεις. Η τεκμηρίωση της Meta περιγράφει το πεδίο ως νέες αναφορές μιας Σελίδας, συμπεριλαμβανομένων αυτών σε σχόλια και αναρτήσεις. Το Κέντρο Βοήθειας του Facebook σημειώνει ότι οι ρυθμίσεις μιας Σελίδας μπορούν να εμποδίσουν τους χρήστες να την αναφέρουν.

Πώς μοιάζει μια ειδοποίηση αναφοράς;

Ένα POST με object ίσο με page και μία εγγραφή (entry) για τη Σελίδα που αναφέρθηκε: το ID της, μια ώρα (time) και έναν πίνακα changes του οποίου το field είναι mention. Η τεκμηρίωση της Meta απαριθμεί τα πεδία της τιμής αλλά δεν δίνει δείγμα, γι' αυτό το παρακάτω παράδειγμα αναφοράς σε ανάρτηση διαμορφώνεται από αυτή τη λίστα:

A mention in a post, from the fields in Meta's reference
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1793520000,
      "changes": [
        {
          "field": "mention",
          "value": {
            "item": "post",
            "verb": "add",
            "post_id": "<POST_ID>",
            "message": "<TEXT_WITH_THE_MENTION>"
          }
        }
      ]
    }
  ]
}

Τι σημαίνει κάθε πεδίο μιας αναφοράς;

Αυτά είναι τα πεδία της τιμής στην τεκμηρίωση της Meta. Ποια από αυτά φέρει μια ειδοποίηση εξαρτάται από την ανάρτηση ή το σχόλιο:

  • post_id: το ID της ανάρτησης που αναφέρει τη Σελίδα.
  • comment_id: το ID του σχολίου, όταν η αναφορά βρίσκεται σε σχόλιο. parent_id: το ID του γονικού του.
  • message: το κείμενο που φέρει την αναφορά.
  • link, photo, photos και video: σύνδεσμοι προς όσα έχει επισυνάψει η ανάρτηση ή το σχόλιο.
  • item και verb: το είδος του αντικειμένου και τι συνέβη σε αυτό, από τις ίδιες λίστες που χρησιμοποιεί το πεδίο feed.
  • created_time: πότε δημιουργήθηκε η ανάρτηση ή το σχόλιο.
  • from και message_tags: ο συντάκτης και τα προφίλ που έχουν επισημανθεί στο κείμενο, και τα δύο σημειωμένα ως μόνο για Workplace.
  • Επίσης αναφέρονται: action, album_id, event_id, photo_id, video_id, share_id, published, reaction_type, recipient_id και open_graph_story_id.

Ποια άδεια χρειάζεται το πεδίο mention;

Η pages_manage_metadata, την οποία η Meta απαιτεί να χορηγήσει ένας διαχειριστής της Σελίδας με δικαιώματα MODERATE προτού τα webhooks της Σελίδας φτάσουν σε μια εφαρμογή. Η Σελίδα εγγράφεται μέσω POST /{page-id}/subscribed_apps με το mention ανάμεσα στα subscribed_fields, χρησιμοποιώντας το token της Σελίδας από κάποιον με την εργασία (task) CREATE_CONTENT, MANAGE ή MODERATE, με pages_manage_metadata και pages_show_list. Η εφαρμογή κάνει συνδρομή και στο mention, αφού παραδίδονται μόνο τα πεδία που έχουν συνδρομή και στα δύο επίπεδα. Οι Σελίδες που διαχειρίζονται πρόσωπα χωρίς ρόλο στην εφαρμογή χρειάζονται αυτές τις άδειες σε Advanced Access.

Πώς διαβάζετε την ανάρτηση ή το σχόλιο που αναφέρει τη Σελίδα;

Με το ID της, με το token της Σελίδας, όπου το επιτρέπει η Meta. Ένα token Σελίδας διαβάζει αναρτήσεις που δημοσιεύτηκαν στη Σελίδα ή από αυτή. Οι δημόσια κοινοποιημένες αναρτήσεις άλλων Σελίδων χρειάζονται pages_manage_posts και τη δυνατότητα Page Public Content Access, σε token διαχειριστή της Σελίδας. Η Meta συνδέει επίσης την ανάγνωση της ανάρτησης ενός προσώπου με την άδεια user_posts αυτού του προσώπου.

Looking up the post or the comment
GET https://graph.facebook.com/<POST_ID>
  ?fields=message,permalink_url,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

GET https://graph.facebook.com/<COMMENT_ID>
  ?fields=message,from,created_time
  &access_token=<PAGE_ACCESS_TOKEN>

Πού αλλού μπορεί μια Σελίδα να βρει τις αναφορές της;

Στο edge tagged. Το GET /{page-id}/tagged απαριθμεί τις δημόσιες αναρτήσεις στις οποίες έχει επισημανθεί η Σελίδα, καθεμία με ένα tagged_time, και καλύπτει και αναρτήσεις από πριν ρυθμιστεί το webhook. Απαιτεί token Σελίδας από κάποιον με την εργασία CREATE_CONTENT, MANAGE ή MODERATE, με pages_read_user_content και pages_show_list. Η Meta αναφέρει ότι μπορεί να χρειάζεται η δυνατότητα Page Public Content Access. Σε ανάρτηση προσώπου, η Meta επιστρέφει το from μόνο στο πρόσωπο που την έγραψε.

Πώς η easyCoexistence παραδίδει τα γεγονότα αναφοράς;

Εγγράφει κάθε Σελίδα στο mention, δίπλα στα feed και messages, όταν η Σελίδα συνδέεται. Η εφαρμογή της ελέγχει το X-Hub-Signature-256 σε κάθε παράδοση, απαντά αμέσως στη Meta και στέλνει με POST κάθε εγγραφή της Σελίδας, αμετάβλητη, στο HTTPS endpoint που ορίζετε με το set_social_webhook_destination ή με PUT /channels/:id/webhook στο Partner API:

  • Το X-EC-Signature φέρει t=<unix>,v1=<hex>: το HMAC-SHA256 του χρονικού σήματος, μιας τελείας και του ακατέργαστου σώματος, με κλειδί το μυστικό υπογραφής της Σελίδας.
  • Το μυστικό ξεκινά με whsec_ και εμφανίζεται μία φορά. Αν ορίσετε ξανά τη διεύθυνση, εκδίδεται νέο μυστικό, ενώ η τιμή null σταματά την προώθηση.
  • Κάθε εγγραφή στέλνεται μία φορά, με αναμονή έως 8 δευτερόλεπτα, σε μια διεύθυνση HTTPS που επιλύεται σε δημόσια IP. Δεν ακολουθούνται ανακατευθύνσεις και δεν κρατείται αντίγραφο.
A forwarded mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>

{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793520000,
    "changes": [
      {
        "field": "mention",
        "value": {
          "item": "post",
          "verb": "add",
          "post_id": "<POST_ID>",
          "message": "<TEXT_WITH_THE_MENTION>"
        }
      }
    ]
  }
}

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

  • Ανάγνωση του entry.time ως της στιγμής της αναφοράς. Η Meta το ορίζει στη στιγμή που στάλθηκε η ειδοποίηση· το created_time στην τιμή χρονολογεί την ανάρτηση ή το σχόλιο.
  • Αντιμετώπιση μιας αποτυχημένης αναζήτησης ως χαλασμένου γεγονότος. Η Meta προειδοποιεί ότι ορισμένες τιμές post_id και comment_id στις ειδοποιήσεις αναφοράς δεν μπορούν να αναζητηθούν, λόγω έλλειψης άδειας ή για λόγους απορρήτου. Γι' αυτό κρατήστε το κείμενο του μηνύματος από το ίδιο το γεγονός.
  • Ανάκτηση της ανάρτησης πριν από την απάντηση στην προώθηση. Οι προωθήσεις δεν επαναλαμβάνονται, γι' αυτό επιστρέψτε αμέσως 2xx και αναζητήστε την ανάρτηση στη συνέχεια.
Κάντε το με EasyCoexistence

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

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

Το webhook mention λέει ποιος αναφέρει τη Σελίδα;

Όχι για Σελίδα: η τεκμηρίωση της Meta σημειώνει το from μόνο για Workplace. Η αναζήτηση της ανάρτησης ή του σχολίου με το ID της μπορεί να επιστρέψει τον συντάκτη της, όπου το επιτρέπουν οι άδειες της Meta.

Μπορώ να πάρω αναφορές από πριν εγγραφεί η Σελίδα;

Όχι από το webhook, αφού η Meta δεν κρατά ιστορικό ειδοποιήσεων για αναζήτηση. Το edge tagged απαριθμεί τις δημόσιες αναρτήσεις στις οποίες έχει επισημανθεί η Σελίδα.

Σε τι διαφέρει το πεδίο mention από το feed;

Το feed αναφέρει αλλαγές στη δική της ροή της Σελίδας, όπως αναρτήσεις, σχόλια και αντιδράσεις εκεί. Το mention αναφέρει ότι η Σελίδα αναφέρεται με @ σε ανάρτηση ή σχόλιο. Κάθε πεδίο εγγράφεται χωριστά.

Οι κανόνες σχολίων της easyCoexistence ενεργούν στις αναφορές;

Όχι. Οι κανόνες και οι αυτοματισμοί ενεργούν σε σχόλια από το πεδίο feed και σε μηνύματα Messenger. Οι αλλαγές mention προωθούνται στο endpoint σας ακριβώς όπως τις έστειλε η Meta.

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

Πεδία webhook της Facebook Page: η πλήρης λίσταΤα 64 πεδία webhook της Facebook Page της Meta: feed, mention, πεδία Messenger όπως τα messages, πεδία προφίλ και το δικαίωμα του καθενός.Webhook του feed σελίδας Facebook: σχόλια, αναρτήσεις και αντιδράσειςΤι στέλνει το webhook του feed σελίδας Facebook για σχόλια, αναρτήσεις και αντιδράσεις, με τα πεδία item και verb και τη μορφή του payload της Meta.Εγγραφή μιας Σελίδας Facebook στα webhooks: το edge subscribed_appsΠώς το POST /{page-id}/subscribed_apps εγγράφει μια Σελίδα Facebook σε πεδία webhook: tokens, εργασίες, εγγραφή εφαρμογής, έλεγχος, αφαίρεση.Επαλήθευση του webhook του Facebook: hub.challenge και X-Hub-Signature-256Επαλήθευση του webhook του Facebook: επιστροφή του hub.challenge όταν το hub.verify_token ταιριάζει, και έλεγχος του X-Hub-Signature-256 με το App Secret.Αυτοματισμός σχολίου σε DM στο Facebook: στείλτε μήνυμα Messenger σε όποιον σχολιάζει ανάρτηση της ΣελίδαςΡυθμίστε σχόλιο σε DM στο Facebook: επιλέξτε λέξεις-κλειδιά, γράψτε το μήνυμα και μια δημόσια απάντηση, και λειτουργεί όλο το 24ωρο.

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

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

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

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