Το webhook σχολίων του Instagram: το payload, πεδίο προς πεδίο
Το webhook σχολίων του Instagram ειδοποιεί μια εφαρμογή όταν κάποιος σχολιάζει, ή απαντά σε σχόλιο, στο media ενός επαγγελματικού λογαριασμού, συμπεριλαμβανομένων των Reels. Η Meta στέλνει αλλαγή με field ίσο με comments, της οποίας η τιμή περιέχει το id και το κείμενο του σχολίου, το Instagram-scoped ID και το username του συντάκτη στο from, το id και το media_product_type του media, και το parent_id όταν το σχόλιο είναι απάντηση.
Το easyCoexistence εγγράφει κάθε συνδεδεμένο λογαριασμό Instagram στα σχόλια και προωθεί στο HTTPS endpoint σας τα συμβάντα comments που η Meta στέλνει γι' αυτόν, όπως φτάνουν, υπογεγραμμένα με το μυστικό κλειδί του λογαριασμού και χωρίς να κρατείται αντίγραφο.
Υπάρχει όταν το σχόλιο είναι απάντηση, και κρατά το ID του σχολίου στο οποίο απαντά.
Προστίθεται στο from όταν ο λογαριασμός σχολιάζει στο δικό του media, δίπλα στο δικό του ID.
Ξεχωριστό πεδίο για τα σχόλια κατά τη διάρκεια μετάδοσης Live· οι ειδοποιήσεις του σταματούν όταν τελειώσει η μετάδοση.
Απαιτείται για ειδοποιήσεις comments και live_comments· το media ιδιωτικών λογαριασμών δεν ενεργοποιεί καμία.
Χρόνος που απομένει για να σταλεί στον σχολιαστή μία ιδιωτική απάντηση, με διεύθυνση το ID του σχολίου.
Πότε ενεργοποιείται το πεδίο comments;
Όταν κάποιος σχολιάζει media που ανήκει στον επαγγελματικό λογαριασμό ή τον αναφέρει, μόλις η εφαρμογή και ο λογαριασμός είναι και οι δύο εγγεγραμμένοι στο πεδίο. Κάθε σχόλιο είναι μία αλλαγή στην ειδοποίηση, και αυτές οι περιπτώσεις μοιράζονται το ίδιο σχήμα:
- Ένα νέο σχόλιο σε post, Reel, Story ή ad, με το media.
media_product_typeνα δηλώνει σε ποια επιφάνεια βρίσκεται το media. - Μια απάντηση κάτω από υπάρχον σχόλιο, που φέρει
parent_idμε το ID του σχολίου στο οποίο απαντά. - Ένα σχόλιο που κάνει ο ίδιος ο λογαριασμός στο δικό του media, συμπεριλαμβανομένων των απαντήσεών του: το from.id είναι το δικό του ID, και το from προσθέτει
self_ig_scoped_id. - Μία αναφορά @mention του λογαριασμού: με Instagram Login, η Meta τις συμπεριλαμβάνει στην ειδοποίηση σχολίων αντί σε δικό τους πεδίο.
- Ένα σχόλιο κατά τη διάρκεια μετάδοσης Live έρχεται σε ξεχωριστό πεδίο, το
live_comments, με το ίδιο σχήμα τιμής, και σταματά όταν τελειώσει η μετάδοση.
Πώς μοιάζει μια ειδοποίηση σχολίων;
Ένα POST του οποίου το JSON έχει object ίσο με instagram και έναν πίνακα entry. Κάθε entry είναι ένας επαγγελματικός λογαριασμός: το ID του, η ώρα που η Meta έστειλε την ειδοποίηση, και ένας πίνακας changes με μία αλλαγή ανά σχόλιο. Μια απάντηση σε Reel μοιάζει έτσι:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}Τι σημαίνει κάθε πεδίο;
Τα πεδία που αναφέρει η τεκμηρίωση webhook της Meta για ένα σχόλιο, από έξω προς τα μέσα:
- entry[].id: το ID του επαγγελματικού λογαριασμού, δηλαδή το
user_idπου επιστρέφει το /me γι' αυτόν. Σας δείχνει σε ποιον λογαριασμό ανήκει το σχόλιο. - entry[].time: πότε η Meta έστειλε την ειδοποίηση, ως Unix timestamp. Δεν είναι η ώρα που γράφτηκε το σχόλιο.
- changes[].field: comments, ή
live_commentsγια μετάδοση Live. Ελέγξτε το πριν διαβάσετε το value. - value.id: το ID του σχολίου, με το οποίο απαντάτε δημόσια ή ιδιωτικά, το κρύβετε ή το διαγράφετε.
- value.text: το κείμενο του σχολίου, όταν το σχόλιο έχει κείμενο.
- value.from.id και value.from.username: το Instagram-scoped ID και το username του συντάκτη. Το value.from.
self_ig_scoped_idεμφανίζεται όταν ο ίδιος ο λογαριασμός έγραψε το σχόλιο. - value.media.id και value.media.
media_product_type: το media που σχολιάστηκε και η επιφάνειά του· η αναφορά του media της Meta ονομάζει AD, FEED, STORY και REELS. - value.
parent_id: σε απάντηση, το ID του σχολίου στο οποίο απαντά. Ένα σχόλιο πρώτου επιπέδου δεν έχει αυτό το πεδίο. - value.media.
ad_id,ad_titleκαιoriginal_media_id: αναφέρονται στην τεκμηρίωση για σχόλια σε ad.
Τι δεν αναφέρει το πεδίο comments;
Μερικά πράγματα που ένας χειριστής μπορεί να περιμένει λείπουν από το συμβάν ή δεν στέλνονται ποτέ, σύμφωνα με τον οδηγό ρύθμισης και τις αναφορές της Meta:
- Σχόλια σε media ιδιωτικού λογαριασμού: η Meta δεν στέλνει γι' αυτά ειδοποιήσεις σχολίων ή αναφορών.
- Τα ID των άλμπουμ: το συμβάν δεν τα περιλαμβάνει, και η Meta λέει να αναζητήσετε το άλμπουμ με το ID του σχολίου.
- Τα ID των ads για media που χρησιμοποιούνται σε dynamic ads.
- Η ώρα δημιουργίας του σχολίου: το GET /<
COMMENT_ID>?fields=timestamp την επιστρέφει σε ISO 8601. - Σχόλια Live μετά το τέλος της μετάδοσης, όταν σταματούν οι ειδοποιήσεις για live media.
- Αναφορές σε Stories, που το mentions API της Meta δεν υποστηρίζει· φτάνουν στον λογαριασμό ως DM.
- Παρελθόντα συμβάντα: η Meta δεν κρατά ιστορικό ειδοποιήσεων για ερωτήματα, οπότε αποθηκεύστε ό,τι χρειάζεστε καθώς φτάνει το καθένα.
Τι χρειάζεται το πεδίο comments;
Με Instagram Login, τις άδειες instagram_business_basic και instagram_business_manage_comments, και Advanced Access, το οποίο η Meta απαιτεί για ειδοποιήσεις comments και live_comments. Η εφαρμογή πρέπει να είναι Live και εγγεγραμμένη στο comments στο App Dashboard, και κάθε λογαριασμός πρέπει να εγγραφεί μέσω POST /<IG_ID>/subscribed_apps με comments μεταξύ των subscribed_fields. Η Meta συνιστά ανεπιφύλακτα αυτό το webhook αντί για polling για σχόλια, γιατί δεν καταναλώνει το rate limit.
Πώς απαντάτε σε σχόλιο από το συμβάν;
Με τα ID που μεταφέρει. Το POST /<COMMENT_ID>/replies με ένα message δημοσιεύει δημόσια απάντηση κάτω από το σχόλιο, χρησιμοποιώντας το value.id. Το POST /<IG_ID>/messages με recipient.comment_id ίσο με value.id στέλνει στον συντάκτη μία ιδιωτική απάντηση, εντός 7 ημερών από το σχόλιο, ή όσο διαρκεί η μετάδοση Live. Το from.id είναι Instagram-scoped ID, αλλά ένα DM που στέλνεται απευθείας σε αυτό αποτυγχάνει μέχρι το άτομο να έχει στείλει μήνυμα στον λογαριασμό· γι' αυτό η ιδιωτική απάντηση είναι ο τρόπος να φτάσετε σε αυτό με DM.
Πώς προωθεί το easyCoexistence ένα σχόλιο;
Όπως φτάνει, μόλις οριστεί endpoint για τον λογαριασμό με το set_social_webhook_destination από το Claude ή το ChatGPT, ή με PUT /channels/:id/webhook στο Partner API. Το easyCoexistence εγγράφει κάθε συνδεδεμένο λογαριασμό στα πεδία που μεταφέρουν τα σχόλιά του, τις αναφορές και τα DM του, ελέγχει την υπογραφή της Meta σε κάθε παράδοση, απαντά αμέσως στη Meta και κάνει POST κάθε entry του λογαριασμού στη διεύθυνση HTTPS σας, μέσα σε φάκελο:
- platform και
external_id: instagram, και το Instagram ID του λογαριασμού, ίσο με entry.id. account_id: το ID της σύνδεσης στο easyCoexistence, αυτό που επιστρέφει τοlist_social_accountsκαι χρησιμοποιούν τα εργαλεία MCP.- entry: το entry της Meta για τον λογαριασμό, αναλλοίωτο, ώστε μια ομαδοποιημένη παράδοση να γίνεται ένα POST ανά entry. Το πεδίο object της Meta και το X-Hub-Signature-256 δεν προωθούνται.
- Παράδοση: μία προσπάθεια, με αναμονή έως 8 δευτερόλεπτα, χωρίς να ακολουθούνται ανακατευθύνσεις, σε διεύθυνση HTTPS που επιλύεται σε δημόσια IP. Δεν κρατείται αντίγραφο και δεν γίνεται επανάληψη.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}Τι κάνουν οι κανόνες σχολίων σε DM με το ίδιο συμβάν;
Το διαβάζουν παράλληλα με την προώθηση. Ένας κανόνας ταιριάζει όταν το σχόλιο περιέχει μία από τις λέξεις-κλειδιά του, χωρίς διάκριση πεζών και κεφαλαίων, σε ένα επιλεγμένο post ή σε όλα, και στέλνει στον συντάκτη το DM του κανόνα ως ιδιωτική του απάντηση, συν μια δημόσια απάντηση αν ο κανόνας έχει μία. Τα σχόλια του ίδιου του λογαριασμού παραλείπονται, οι αυτοματισμοί που ξεκινούν από σχόλιο παίρνουν αυτά στα οποία δεν απάντησε κανένας κανόνας, και ένα σχόλιο στο οποίο απάντησε ένας κανόνας φτάνει ακόμη στο endpoint σας. Η δημόσια απάντηση του κανόνα μπορεί να επιστρέψει ως νέο συμβάν comments από τον ίδιο τον λογαριασμό.
Συνηθισμένα λάθη
- Αναζήτηση του comment_id. Με Instagram Login, το ID του σχολίου βρίσκεται στο value.id· το comment_id ανήκει στα payloads των άλλων τρόπων σύνδεσης της Meta.
- Απάντηση στα σχόλια του ίδιου του λογαριασμού. Οι απαντήσεις του επιστρέφουν ως συμβάντα comments με from.id ίσο με entry.id, και ένας αυτοματισμός που απαντά σε αυτές καταλήγει να μιλά με τον εαυτό του.
- Ανάγνωση του entry.time ως ώρας του σχολίου. Καταγράφει πότε η Meta έστειλε την ειδοποίηση· το δικό του πεδίο timestamp δείχνει πότε γράφτηκε το σχόλιο.
- Αναμονή σχολίων Live στο πεδίο comments. Φτάνουν στο live_comments, που χρειάζεται δική του εγγραφή και σιωπά όταν τελειώσει η μετάδοση.
Οι κανόνες σχολίων σε DM και οι αυτοματισμοί απαντούν στα ίδια σχόλια όλο το 24ωρο. US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, με 3 ημέρες δωρεάν δοκιμή.
Συχνές ερωτήσεις
Περιλαμβάνει το webhook σχολίων του Instagram τις απαντήσεις σε σχόλια;
Ναι. Μια απάντηση φτάνει ως δικό της συμβάν comments, με το parent_id να κρατά το ID του σχολίου στο οποίο απαντά.
Τα σχόλια σε Reels ενεργοποιούν το webhook σχολίων του Instagram;
Ναι. Ένα σχόλιο σε Reel έρχεται στο πεδίο comments όπως ένα σε post, και το media.media_product_type τα ξεχωρίζει.
Γιατί δεν ενεργοποιείται το webhook σχολίων του Instagram;
Συνήθως επειδή η εφαρμογή δεν είναι Live ή δεν έχει Advanced Access, ο λογαριασμός δεν εγγράφηκε ποτέ μέσω του /subscribed_apps, το media ανήκει σε ιδιωτικό λογαριασμό, ή το σχόλιο έγινε σε Live, το οποίο χρησιμοποιεί το live_comments.
Περιλαμβάνει το webhook σχολίων το username του σχολιαστή;
Ναι. Το value.from φέρει το username του ατόμου δίπλα στο Instagram-scoped ID του, οπότε δεν χρειάζεται επιπλέον κλήση για να δείξετε ποιος σχολίασε.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις