Συμβάντα webhook του Instagram: σχόλια, αναφορές και DMs
Τα συμβάντα webhook του Instagram αναφέρουν δραστηριότητα σε επαγγελματικό λογαριασμό καθώς συμβαίνει: νέα σχόλια, αναφορές (@mentions) και DMs. Η Meta στέλνει το καθένα ως JSON με POST στο HTTPS endpoint της συνδεδεμένης εφαρμογής και επαναλαμβάνει μια αποτυχημένη αποστολή προς αυτό για έως 36 ώρες. Το easyCoexistence προωθεί κάθε συμβάν στο δικό σας endpoint μία φορά, υπογεγραμμένο ανά λογαριασμό, χωρίς επαναλήψεις. Με το Instagram Login, οι αναφορές φτάνουν μέσα στην ειδοποίηση σχολίων.
Για πόσο χρονικό διάστημα η Meta συνεχίζει να επαναλαμβάνει μια αποτυχημένη αποστολή στο endpoint της εφαρμογής, πριν την απορρίψει.
Τις περισσότερες ενημερώσεις η Meta τις ομαδοποιεί σε μία αποστολή webhook, χωρίς όμως να το εγγυάται.
Τη σήμανση που θέτει η Meta στα συμβάντα μηνυμάτων που έστειλε ο ίδιος ο λογαριασμός.
Μόνο τα μέσα δημόσιων λογαριασμών ενεργοποιούν ειδοποιήσεις σχολίων και αναφορών.
Ποια συμβάντα υπάρχουν;
Για επαγγελματικό λογαριασμό συνδεδεμένο με Instagram Login, φτάνουν τρία είδη δραστηριότητας ως συμβάντα:
- Σχόλια: ένα νέο σχόλιο στα μέσα του λογαριασμού, με το ID του σχολίου, το Instagram-scoped ID και το username του συγγραφέα, το κείμενο, και το ID και τον τύπο του μέσου.
- Αναφορές: με το Instagram Login έρχονται μέσα στην ειδοποίηση σχολίων, και όχι ως δικό τους πεδίο.
- Μηνύματα: ένα DM προς τον λογαριασμό, με τον αποστολέα, τον παραλήπτη, χρονική σήμανση και το ίδιο το μήνυμα, συμπεριλαμβανομένου κειμένου, συνημμένων και απαντήσεων σε Stories.
Πώς φτάνουν τα συμβάντα στο endpoint σας;
Η Meta παραδίδει τα webhooks του Instagram στην εφαρμογή στην οποία συνδέθηκε ο λογαριασμός. Το easyCoexistence τα λαμβάνει και προωθεί το καθένα στο HTTPS endpoint που ορίσατε για τον λογαριασμό, όπως φτάνει, υπογεγραμμένο με μυστικό για τον συγκεκριμένο λογαριασμό.
Ορίστε το endpoint με set_social_webhook_destination από το Claude ή το ChatGPT, ή με το Partner API μέσω PUT /channels/:id/webhook. Το μυστικό υπογραφής εμφανίζεται μία φορά. Η νέα ρύθμιση του endpoint εκδίδει νέο μυστικό, και η τιμή null στο URL απενεργοποιεί την προώθηση.
Πώς είναι μια αποστολή;
Ένα POST με σώμα JSON που περιέχει το platform, το account_id που δίνει το list_social_accounts για τη σύνδεση, το external_id του λογαριασμού Instagram και το entry: το entry της Meta για το συμβάν, αμετάβλητο. Ένα DM φτάνει με τον ίδιο τρόπο, με πίνακα messaging στη θέση του changes. Ένα νέο σχόλιο μοιάζει με αυτό:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}Πώς επαληθεύετε μια αποστολή;
Κάθε αποστολή φέρει την κεφαλίδα X-EC-Signature σε μορφή t=<unix>,v1=<hex>, όπου το v1 είναι το HMAC-SHA256 του timestamp, μιας τελείας και του ακατέργαστου σώματος του αιτήματος, με κλειδί το μυστικό υπογραφής του λογαριασμού. Υπολογίστε το πάνω στο ακατέργαστο σώμα ακριβώς όπως ελήφθη, συγκρίνετε σε σταθερό χρόνο και απορρίψτε χρονική σήμανση παλαιότερη των 5 λεπτών.
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: η προώθηση στέλνει κάθε συμβάν μία φορά, στη μνήμη, και δεν κρατά αντίγραφο για επανάληψη. Απαντήστε γρήγορα με 2xx και κάντε τη δουλειά στη συνέχεια, και αποθηκεύστε ό,τι χρειάζεστε κατά την άφιξη, αφού ούτε η Meta κρατά ιστορικό παλαιότερων ειδοποιήσεων που να μπορεί να ερωτηθεί.
Η ίδια η Meta επαναλαμβάνει μια αποτυχημένη αποστολή στην εφαρμογή για έως 36 ώρες, οπότε το ίδιο συμβάν μπορεί σπάνια να φτάσει δύο φορές: κάντε deduplication με βάση το ID του σχολίου ή το mid του μηνύματος.
Τι άλλο πρέπει να ελέγχει ένας handler;
Μερικές λεπτομέρειες στα payloads της Meta που δυσκολεύουν τον πρώτο handler:
is_echo: ένα συμβάν μηνύματος μεis_echoορισμένο σε true στάλθηκε από τον ίδιο τον λογαριασμό, άρα δεν χρειάζεται απάντηση.- Απαντήσεις σε Stories: ένα DM που απαντά σε Story φέρει
reply_toμε το ID και το URL της Story. - Αναφορές σε Stories: φτάνουν ως μήνυμα με τύπο συνημμένου
story_mention. - time: η στιγμή που έστειλε η Meta την ειδοποίηση, όχι η στιγμή που έγινε το σχόλιο ή το μήνυμα. Η δική χρονική σήμανση του μηνύματος βρίσκεται στην καταχώρισή του στο messaging.
- IDs άλμπουμ: τα συμβάντα σχολίων δεν τα περιλαμβάνουν. Αναζητήστε το άλμπουμ με το ID του σχολίου.
Συνηθισμένα λάθη
- Η επεξεργασία πριν την απάντηση. Η προώθηση δεν επαναλαμβάνεται, γι αυτό επιστρέψτε 2xx αμέσως και επεξεργαστείτε το συμβάν στη συνέχεια.
- Έλεγχος της υπογραφής σε JSON που έχει ήδη αναλυθεί. Υπολογίστε το HMAC πάνω στο ακατέργαστο σώμα ακριβώς όπως ήρθε.
- Απάντηση σε echoes. Ένα συμβάν μηνύματος με is_echo είναι αυτό που έστειλε ο λογαριασμός, και μια απάντηση σε αυτό ξεκινά έναν βρόχο.
- Παράλειψη deduplication. Η Meta μπορεί να στείλει ξανά το ίδιο συμβάν μετά από αποτυχία. Κάντε κλειδί το ID του σχολίου ή το mid του μηνύματος.
Το easyCoexistence προωθεί τα σχόλια, τις αναφορές και τα DMs του λογαριασμού Instagram στο HTTPS endpoint σας καθώς φτάνουν, υπογεγραμμένα με μυστικό για τον λογαριασμό και χωρίς αντίγραφο στη διαδρομή. Ενεργοποιήστε το με set_social_webhook_destination από το Claude ή το ChatGPT, ή με το Partner API. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Τι σημαίνει το πεδίο time σε ένα webhook του Instagram;
Η στιγμή που έστειλε η Meta την ειδοποίηση, και όχι η στιγμή που έγινε το σχόλιο ή το μήνυμα. Η δική χρονική σήμανση ενός DM βρίσκεται στην καταχώρισή του στο messaging.
Επαναλαμβάνει η Meta τις αποτυχημένες αποστολές webhook του Instagram;
Ναι. Η Meta επαναλαμβάνει μια αποτυχημένη αποστολή στην εφαρμογή για έως 36 ώρες, οπότε το ίδιο συμβάν μπορεί σπάνια να φτάσει δύο φορές: κάντε deduplication με βάση το ID του σχολίου ή το mid του μηνύματος. Το easyCoexistence προωθεί κάθε συμβάν στο endpoint σας μία φορά, γι αυτό απαντήστε γρήγορα με 2xx.
Πόσες ενημερώσεις μπορεί να περιέχει μία αποστολή webhook του Instagram;
Έως 1.000 όταν η Meta τις ομαδοποιεί, χωρίς όμως να εγγυάται την ομαδοποίηση. Διατρέξτε ολόκληρο τον πίνακα entry αντί να διαβάζετε μόνο το πρώτο στοιχείο του.
Έχουν οι αναφορές δικό τους συμβάν;
Όχι με το Instagram Login. Η Meta τις περιλαμβάνει στην ειδοποίηση σχολίων, οπότε φτάνουν στην ίδια διαδρομή με τα σχόλια.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις