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

Το webhook του Messenger για Σελίδες Facebook: μηνύματα και συμβάντα μνείας

Το πεδίο messages των webhooks της Σελίδας του Facebook ενεργοποιείται όταν ένα άτομο στέλνει στη Σελίδα ένα μήνυμα Messenger, και παραδίδει έναν πίνακα messaging με το ID του αποστολέα με εύρος Σελίδας, το ID της Σελίδας, χρονική σήμανση και το mid του μηνύματος με το κείμενο ή τα συνημμένα του. Το πεδίο mention αναφέρει νέες μνείες της Σελίδας σε δημοσιεύσεις και σχόλια, και η Meta υπογράφει και τα δύο με X-Hub-Signature-256.

Το easyCoexistence προωθεί τα μηνύματα και τις μνείες του Messenger κάθε συνδεδεμένης Σελίδας στο endpoint HTTPS σας καθώς φτάνουν, υπογεγραμμένα με μυστικό για εκείνη τη Σελίδα και χωρίς να κρατά αντίγραφο, και το send_social_dm απαντά μέσα στο παράθυρο των 24 ωρών.

5 seconds

Πόσο γρήγορα ζητά η Meta από ένα endpoint webhook του Messenger να απαντά σε κάθε ειδοποίηση με 200 OK.

1 hour

Μετά από τόση ώρα αποτυχημένων παραδόσεων, η Meta καταργεί την εγγραφή της εφαρμογής στα webhooks της Σελίδας, έως ότου εγγραφεί ξανά.

PSID

Το ID αποστολέα με εύρος Σελίδας σε ένα συμβάν messages, μοναδικό για κάθε ζεύγος ατόμου και Σελίδας.

Workplace only

Πώς η αναφορά της Meta σημειώνει το πεδίο sender σε ένα συμβάν mention.

No history

Οι παλιές ειδοποιήσεις webhook δεν μπορούν να ερωτηθούν αργότερα, άρα ο παραλήπτης πρέπει να αποθηκεύει ό,τι χρειάζεται.

Τι στέλνει το πεδίο messages;

Μια ειδοποίηση όταν ένα άτομο στέλνει στη Σελίδα ένα μήνυμα Messenger. Η Meta στέλνει μηνύματα κειμένου ή μηνύματα με συνημμένα, που μπορεί να είναι εικόνες, ήχος, βίντεο, αρχεία ή αυτοκόλλητα, μεταξύ άλλων τύπων, και ένας κοινοποιημένος σύνδεσμος μπορεί να φτάσει ως εναλλακτικό συνημμένο. Μια απάντηση σε προηγούμενο μήνυμα φέρει το reply_to με το mid εκείνου του μηνύματος, και μια γρήγορη απάντηση (quick reply) φέρει το payload της.

Πώς μοιάζει ένα συμβάν messages;

Σε αντίθεση με τις αλλαγές του feed, ένα μήνυμα φτάνει σε έναν πίνακα messaging μέσα στο entry της Σελίδας. Κάθε συμβάν έχει sender, δηλαδή το ID του ατόμου με εύρος Σελίδας, recipient, δηλαδή τη Σελίδα, μια χρονική σήμανση και message, με το mid του και το text, ή attachments με έναν type και ένα URL payload:

A messages event, as Meta sends it
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1458692752478,
      "messaging": [
        {
          "sender": { "id": "<PSID>" },
          "recipient": { "id": "<PAGE_ID>" },
          "timestamp": 1458692752478,
          "message": {
            "mid": "<MESSAGE_ID>",
            "text": "hello, world!"
          }
        }
      ]
    }
  ]
}

Τι στέλνει το πεδίο mention;

Μια αλλαγή με πεδίο mention όταν η Σελίδα αναφέρεται σε δημοσίευση ή σχόλιο, με post_id ή comment_id, το message, τυχόν σύνδεσμο, φωτογραφία ή βίντεο, και item και verb. Η Meta προειδοποιεί ότι ορισμένα από αυτά τα ID δημοσιεύσεων και σχολίων δεν μπορούν να ερωτηθούν, λόγω έλλειψης άδειας ή για λόγους απορρήτου, και η αναφορά της σημειώνει ότι το πεδίο sender ισχύει μόνο για το Workplace, οπότε μια μνεία μπορεί να φτάσει χωρίς τον συντάκτη της.

Ποια πεδία Messenger δεν προωθούνται;

Το easyCoexistence εγγράφει τις Σελίδες στα messages, όχι στα message_echoes, messaging_postbacks, message_reads ή message_deliveries, οπότε τα μηνύματα που στέλνει η Σελίδα, τα πατήματα κουμπιών και οι αποδείξεις ανάγνωσης ή παράδοσης δεν προωθούνται. Μια απάντηση που στέλνεται με το send_social_dm επιστρέφει αντ' αυτού το δικό της ID μηνύματος.

Πώς φτάνουν τα συμβάντα στο endpoint σας;

Η Meta παραδίδει τα webhooks Σελίδων στην εφαρμογή που εγκατέστησε η Σελίδα, μέσω ενός URL callback για ολόκληρη την εφαρμογή. Το easyCoexistence ελέγχει το X-Hub-Signature-256 της Meta σε κάθε παράδοση, απαντά αμέσως στη Meta και προωθεί κάθε entry για μια συνδεδεμένη Σελίδα στο endpoint HTTPS που ορίζετε γι' αυτήν, υπογεγραμμένο με το δικό της μυστικό της Σελίδας. Ορίστε το μέσω του set_social_webhook_destination από το Claude ή το ChatGPT, ή με PUT /channels/:id/webhook στο Partner API· το μυστικό εμφανίζεται μία φορά, η επανάληψη της ρύθμισης εκδίδει νέο, και ένα null URL απενεργοποιεί την προώθηση.

Πώς μοιάζει ένα προωθημένο συμβάν;

Ένα POST που περιέχει την πλατφόρμα, το account_id που δίνει το list_social_accounts για τη σύνδεση της Σελίδας, το ID της Σελίδας ως external_id, και το entry: το entry της Meta για τη Σελίδα, αμετάβλητο. Το sender.id είναι το recipient_id που παίρνει το send_social_dm για μια απάντηση μέσα στο παράθυρο των 24 ωρών:

A forwarded messages event
{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793318400000,
    "messaging": [
      {
        "sender": { "id": "<PSID>" },
        "recipient": { "id": "<PAGE_ID>" },
        "timestamp": 1793318399000,
        "message": { "mid": "<MESSAGE_ID>", "text": "<MESSAGE_TEXT>" }
      }
    ]
  }
}

Πώς επαληθεύετε ένα προωθημένο συμβάν;

Κάθε προωθημένο POST φέρει την κεφαλίδα X-EC-Signature με τη μορφή t=<unix>,v1=<hex>, όπου το v1 είναι το HMAC-SHA256 της χρονικής σήμανσης, μιας τελείας και του ακατέργαστου σώματος, με κλειδί το μυστικό υπογραφής της Σελίδας. Υπολογίστε το πάνω στο σώμα ακριβώς όπως ελήφθη, συγκρίνετε σε σταθερό χρόνο και απορρίψτε χρονική σήμανση που είναι παλαιότερη από 5 λεπτά.

Node.js: verifying X-EC-Signature
import crypto from "node:crypto";

// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
  const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
  if (!sig.t || !sig.v1) return false;
  if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
  const expected = crypto
    .createHmac("sha256", secret)
    .update(sig.t + "." + rawBody)
    .digest("hex");
  return expected.length === sig.v1.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}

Γίνεται νέα προσπάθεια για την παράδοση;

Όχι από το easyCoexistence. Κάθε entry προωθείται μία φορά, στη μνήμη, χωρίς αντίγραφο από το οποίο θα γίνει επανάληψη· η προώθηση περιμένει 8 δευτερόλεπτα για απάντηση, δεν ακολουθεί ανακατευθύνσεις και στέλνεται μόνο σε διεύθυνση HTTPS που επιλύεται σε δημόσια IP. Η Meta σημειώνει ότι τις παλιές ειδοποιήσεις δεν μπορεί κανείς να τις ερωτήσει αργότερα, γι' αυτό αποθηκεύστε ό,τι χρειάζεστε καθώς φτάνει. Από τη μεριά της Meta, μια αποτυχημένη παράδοση ξαναδοκιμάζεται αμέσως μερικές φορές, οπότε το ίδιο μήνυμα μπορεί περιστασιακά να φτάσει δύο φορές: αφαιρέστε τα διπλότυπα με βάση το mid του μηνύματος.

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

  • Κάνετε τη δουλειά πριν απαντήσετε. Η προώθηση δεν επαναλαμβάνεται, άρα επιστρέψτε 2xx αμέσως και επεξεργαστείτε το συμβάν μετά.
  • Επαληθεύετε την υπογραφή σε JSON που έχει ήδη αναλυθεί. Υπολογίστε το HMAC πάνω στο ακατέργαστο σώμα ακριβώς όπως ήρθε.
  • Υποθέτετε ότι ένα μήνυμα έχει πάντα κείμενο. Ένα αυτοκόλλητο, μια εικόνα ή ένας κοινοποιημένος σύνδεσμος φτάνει ως attachments, χωρίς πεδίο text.
  • Παραλείπετε την αφαίρεση διπλοτύπων. Η Meta μπορεί να παραδώσει ξανά ένα συμβάν μετά από αποτυχία, οπότε κλειδώστε με βάση το mid του μηνύματος πριν ενεργήσετε.
Κάντε το με EasyCoexistence

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

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

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

messages για το Messenger και mention για τις μνείες, δίπλα στο feed για τις δημοσιεύσεις και τα σχόλια της Σελίδας.

Έρχεται κείμενο με ένα αυτοκόλλητο ή μια εικόνα του Messenger;

Όχι. Ένα αυτοκόλλητο, μια εικόνα ή ένας κοινοποιημένος σύνδεσμος φτάνει στα attachments, το καθένα με έναν type και ένα URL payload, και το μήνυμα δεν έχει πεδίο text.

Πόσο γρήγορα πρέπει να απαντά ένα endpoint webhook του Messenger;

Με 200 OK μέσα σε 5 δευτερόλεπτα. Μετά από 1 ώρα αποτυχημένων παραδόσεων, η Meta καταργεί την εγγραφή της εφαρμογής στα webhooks της Σελίδας.

Πώς απαντώ σε ένα προωθημένο μήνυμα;

Καλέστε το send_social_dm με το sender.id από το συμβάν ως recipient_id, μέσα σε 24 ώρες από το μήνυμα του ατόμου.

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

Webhook του feed σελίδας Facebook: σχόλια, αναρτήσεις και αντιδράσειςΤι στέλνει το webhook του feed σελίδας Facebook για σχόλια, αναρτήσεις και αντιδράσεις, με τα πεδία item και verb και τη μορφή του payload της Meta.Το παράθυρο 24 ωρών του Messenger: πότε μια Facebook Page μπορεί να στείλει μήνυμα σε κάποιονΠότε μια Facebook Page μπορεί να στείλει μήνυμα στο Messenger: τυπικό παράθυρο 24 ωρών, οι ενέργειες που το ανοίγουν και έως 7 ημέρες μετά από διαφήμιση.Ιδιωτικές απαντήσεις Facebook: API για μήνυμα σε όποιον σχολίασε μια ΣελίδαΣτείλτε ιδιωτική απάντηση στο Facebook με το API της Meta: POST /{page-id}/messages με το ID του σχολίου, ένα μήνυμα Messenger εντός 7 ημερών και τα σφάλματα.Δικαιώματα API σελίδων Facebook και απαιτήσεις App ReviewΤα εννέα δικαιώματα σελίδων Facebook, τι ανοίγει το καθένα και τι ζητά η Meta στο App Review: Advanced Access, επαλήθευση επιχείρησης, εγγραφή οθόνης.Token πρόσβασης σελίδας Facebook: πόσο διαρκεί και τι το ακυρώνειΠώς αποκτάται token πρόσβασης σελίδας Facebook χωρίς ημερομηνία λήξης, ποιος μπορεί να το αποκτήσει και τι κάνει τη Meta να σταματήσει να το δέχεται.Σφάλμα Facebook 551: το άτομο δεν είναι διαθέσιμο στο MessengerΣφάλμα Facebook 551: το Messenger δεν μπόρεσε να φτάσει σε κάποιον που μπορεί να έχει μπλοκάρει τη Σελίδα ή να έχει απενεργοποιήσει τον λογαριασμό του.

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

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

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

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