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

Πεδία webhook του Instagram: η πλήρης λίστα

Για επαγγελματικό λογαριασμό στο Instagram Login, ο πίνακας των πεδίων webhook της Meta περιλαμβάνει τα comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover και standby, με τα mentions να παραδίδονται μέσα στα comments. Τα παραδείγματά της προσθέτουν το message_edit. Κάθε πεδίο χρειάζεται το instagram_business_basic και είτε το instagram_business_manage_comments είτε, για τα περισσότερα πεδία μηνυμάτων, το instagram_business_manage_messages. Το story_insights δεν προσφέρεται με Instagram Login.

Το easyCoexistence εγγράφει κάθε συνδεδεμένο λογαριασμό Instagram σε comments, messages και mentions, και προωθεί αυτά τα συμβάντα στο HTTPS endpoint σας καθώς φτάνουν, υπογεγραμμένα με το μυστικό του κάθε λογαριασμού.

8

Τα πεδία στα οποία εγγράφεται αρχικά ένα νέο προϊόν Instagram στο App Dashboard, μεταξύ των οποίων τα comments, messages και message_reactions.

Per app

Τα πεδία επιλέγονται για την εφαρμογή, όχι ανά λογαριασμό: ένας λογαριασμός λαμβάνει τα πεδία που έχει επιλέξει η εφαρμογή.

Advanced Access

Το επίπεδο πρόσβασης που αναφέρει ο οδηγός ρύθμισης της Meta για τα webhooks του Instagram Login, και το οποίο απαιτείται για τις ειδοποιήσεις comments και live_comments.

story_insights

Σημειώνεται ως μη διαθέσιμο για το Instagram Login στον πίνακα πεδίων της Meta, ο οποίος το προσφέρει με Facebook Login και Unified Login.

10 Sep 2025

Πότε η Meta πρόσθεσε το webhook message_edit για το Business Login for Instagram και το Facebook Login for Business.

Ποια πεδία webhook προσφέρει το Instagram Login;

Αυτά, από τον πίνακα πεδίων της Meta, με όσα ενεργοποιούν το καθένα, όπως προκύπτουν από τα παραδείγματα και την τεκμηρίωση webhook της. Κάθε πεδίο χρειάζεται επιπλέον το instagram_business_basic, πέρα από το δικαίωμα που εμφανίζεται, και η Meta απαιτεί Advanced Access για τις ειδοποιήσεις comments και live_comments.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

Ποια πεδία δεν είναι διαθέσιμα με το Instagram Login;

Τρεις γραμμές του πίνακα πεδίων της Meta δεν έχουν δικαίωμα για το Instagram Login, οπότε μια εφαρμογή με Instagram Login δεν τις λαμβάνει, και ένα ακόμη πεδίο υπάρχει μόνο εκτός αυτού:

  • story_insights: οι μετρήσεις ενός Story όταν λήξει, με Facebook Login ή Unified Login και instagram_manage_insights. Η τεκμηρίωση των media insights της Meta αναφέρει ότι το webhook insights δεν υποστηρίζεται με Instagram Login.
  • messaging_policy_enforcement και response_feedback: μόνο στη στήλη του Instagram Messaging API της Meta.
  • mentions ως αυτόνομο πεδίο: το Facebook Login και το Unified Login το περιλαμβάνουν, με instagram_manage_comments, ενώ το Instagram Login ενσωματώνει τα mentions στα comments.

Πώς γίνεται η εγγραφή σε πεδία;

Σε δύο σημεία. Στο App Dashboard, στις ρυθμίσεις webhook του προϊόντος Instagram, αποθηκεύετε τη διεύθυνση callback και το verify token, κάτι που ενεργοποιεί το αίτημα επαλήθευσης της Meta, και έπειτα επιλέγετε τα πεδία. Ένα νέο προϊόν Instagram ξεκινά εγγεγραμμένο σε οκτώ από αυτά. Στη συνέχεια εγγράφετε κάθε λογαριασμό με POST /<IG_ID>/subscribed_apps στο graph.instagram.com, με subscribed_fields ίσο με τα πεδία που επιλέξατε στο App Dashboard, χωρισμένα με κόμμα.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

Μπορεί κάθε λογαριασμός να έχει διαφορετικά πεδία;

Όχι. Ο οδηγός ρύθμισης της Meta λέει ότι δεν μπορούν να επιλεγούν πεδία για τον λογαριασμό κάθε χρήστη της εφαρμογής: ένας λογαριασμός λαμβάνει τα πεδία που έχουν επιλεγεί για την εφαρμογή. Το subscribed_fields της συνδρομής του λογαριασμού προορίζεται να απαριθμεί τα πεδία του App Dashboard, οπότε ο χειριστής του webhook πρέπει να περιμένει οποιοδήποτε πεδίο επέλεξε η εφαρμογή και να αποφασίζει με βάση όσα περιέχει κάθε συμβάν, όχι με βάση όσα ζήτησε για έναν λογαριασμό.

Πώς ξεχωρίζετε τα πεδία σε μια ειδοποίηση;

Από το σχήμα της εγγραφής. Τα πεδία σχολίων φτάνουν σε έναν πίνακα changes, με κάθε αλλαγή να δηλώνει το πεδίο της. Τα πεδία μηνυμάτων φτάνουν σε έναν πίνακα messaging χωρίς όνομα πεδίου, και το κλειδί δίπλα στα sender, recipient και timestamp τα ξεχωρίζει:

  • changes[].field: comments ή live_comments, με το σχόλιο στο value.
  • message: messages, συμπεριλαμβανομένων των echoes των μηνυμάτων του ίδιου του λογαριασμού, που έχουν is_echo ίσο με true.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • referral δίπλα στο sender: messaging_referral. Ένα referral μέσα στο message ανήκει στα messages, από νέο νήμα ή διαφήμιση Click-to-Direct.
  • pass_thread_control, take_thread_control ή request_thread_control: messaging_handover, όπως τα αναφέρει η τεκμηρίωση webhook της Meta.

Ποια πεδία εγγράφει το easyCoexistence;

comments, messages και mentions, τη λίστα με την οποία εγγράφεται κάθε λογαριασμός Instagram όταν συνδέεται. Με Instagram Login τα mentions έρχονται μέσα στα comments, οπότε η συνδρομή καλύπτει comments και DMs, με τα echoes, τις απαντήσεις σε Story, τις αναφορές σε Story και τα συνημμένα μεταξύ των DMs. Τα άλλα πεδία του πίνακα τα παραδίδει η Meta σε εφαρμογή που είναι εγγεγραμμένη σε αυτά και δεν αποτελούν μέρος της συνδρομής μιας σύνδεσης. Μόλις οριστεί ένα endpoint με το set_social_webhook_destination ή το Partner API, το easyCoexistence ελέγχει την υπογραφή της Meta, απαντά αμέσως στη Meta και στέλνει με POST κάθε entry του λογαριασμού σε αυτό:

  • platform και external_id: instagram, και το ID του λογαριασμού Instagram, ίσο με το entry.id.
  • account_id: το ID της σύνδεσης στο easyCoexistence, αυτό που παίρνουν τα εργαλεία MCP.
  • entry: το entry της Meta για τον λογαριασμό, αναλλοίωτο. Το πεδίο object της Meta και η κεφαλίδα της X-Hub-Signature-256 δεν προωθούνται.
  • X-EC-Signature: t=<unix>,v1=<hex>, ένα HMAC-SHA256 του timestamp, μιας τελείας και του ακατέργαστου σώματος, με κλειδί το μυστικό του ίδιου του λογαριασμού.
  • Παράδοση: μία προσπάθεια έως 8 δευτερόλεπτα, χωρίς ακολούθηση ανακατευθύνσεων, χωρίς αποθηκευμένο αντίγραφο και χωρίς επαναλήψεις.

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

  • Η αναμονή για πεδίο mentions με Instagram Login. Η Meta ενσωματώνει τα mentions στην ειδοποίηση comments, οπότε ένας χειριστής που έχει ως κλειδί το πεδίο mentions δεν εκτελείται ποτέ.
  • Η παραδοχή ότι ένας λογαριασμός λαμβάνει μόνο τα πεδία που όρισε η δική του συνδρομή. Η Meta παραδίδει τα πεδία που έχει επιλέξει η εφαρμογή, οπότε διακλαδώστε με βάση όσα περιέχει κάθε συμβάν.
  • Η αντιμετώπιση του message.referral και ενός referral ανώτερου επιπέδου ως ενός και του αυτού συμβάντος. Το πρώτο ανήκει στα messages. Το δεύτερο είναι το messaging_referral, για σύνδεσμο ig.me που ανοίγεται σε υπάρχουσα συνομιλία.
  • Η αναμονή για story_insights με Instagram Login. Η Meta το σημειώνει ως μη διαθέσιμο εκεί, οπότε διαβάστε τις μετρήσεις ενός Story από το endpoint insights όσο αυτό είναι ακόμη διαθέσιμο.
Κάντε το με EasyCoexistence

Τα συμβάντα δεν αποθηκεύονται από προεπιλογή. Ένας λογαριασμός με ενεργό αυτοματισμό κρατά τα DMs και τα σχόλιά του για 7 ημέρες. Ορίστε το endpoint με το set_social_webhook_destination από το Claude ή το ChatGPT, ή με το Partner API. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.

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

Έχει το Instagram Login πεδίο webhook για mentions;

Όχι ως ξεχωριστό πεδίο. Η Meta περιλαμβάνει τα mentions στην ειδοποίηση comments για το Instagram Login. Το mentions είναι δικό του πεδίο με Facebook Login και Unified Login.

Είναι το story_insights διαθέσιμο με Instagram Login;

Όχι. Ο πίνακας πεδίων της Meta το σημειώνει ως μη διαθέσιμο για το Instagram Login, και η τεκμηρίωση των media insights της αναφέρει ότι το webhook insights δεν υποστηρίζεται εκεί.

Ποια δικαιώματα χρειάζεται το webhook μηνυμάτων του Instagram;

Το instagram_business_basic και το instagram_business_manage_messages, με Advanced Access, το οποίο αναφέρει ο οδηγός ρύθμισης της Meta για τα webhooks του Instagram Login.

Πότε πρόσθεσε η Meta το webhook message_edit για το Instagram;

Στις 10 Σεπτεμβρίου 2025, για το Business Login for Instagram και το Facebook Login for Business. Μια επεξεργασία φτάνει στον πίνακα messaging κάτω από το κλειδί message_edit.

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

Το webhook σχολίων του Instagram: το payload, πεδίο προς πεδίοΤι στέλνει το webhook σχολίων του Instagram όταν κάποιος σχολιάζει posts και Reels: το payload πεδίο προς πεδίο, τι παραλείπει και οι παγίδες.Το webhook μηνυμάτων του Instagram: το payload των DM, τα echoes και τα πεδίαΤι στέλνει το webhook μηνυμάτων του Instagram για DM: το Instagram-scoped ID του αποστολέα, κείμενο, συνημμένα, απαντήσεις σε Story, echoes και το παράθυρο 24 ωρών.Το webhook message_reactions του Instagram: το payload για react και unreactΤι στέλνει το webhook message_reactions του Instagram όταν κάποιος αντιδρά σε DM ή την αφαιρεί, και πότε δεν στέλνει τίποτα.Webhook messaging_postbacks του Instagram: ice breakers και κουμπιάΤι στέλνει το webhook messaging_postbacks του Instagram όταν κάποιος πατά ice breaker, κουμπί ή στοιχείο μενού: title, payload και mid, και πώς ρυθμίζονται.Το webhook messaging_referral του Instagram: συνδέσμοι ig.me και παραπομπές διαφημίσεωνΤι στέλνει το messaging_referral webhook του Instagram όταν κάποιος ανοίγει σύνδεσμο ig.me με ref, και πού φτάνουν οι νέες παραπομπές.Instagram live_comments webhook: σχόλια κατά τη μετάδοση LiveΤι στέλνει το webhook live_comments του Instagram κατά τη μετάδοση Live: το payload, η διαφορά από τα σχόλια και η απάντηση σε αυτά.

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

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

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

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