Το webhook μηνυμάτων του Instagram: το payload των DM, τα echoes και τα πεδία
Το πεδίο messages του webhook του Instagram στέλνει τα DM ενός επαγγελματικού λογαριασμού καθώς φτάνουν: κείμενο, συνημμένα, κοινοποιήσεις, απαντήσεις σε Story και αναφορές, ενσωματωμένες απαντήσεις και διαγραφές. Κάθε συμβάν βρίσκεται σε πίνακα messaging, με το Instagram-scoped ID του αποστολέα, τον παραλήπτη, χρονική σήμανση (timestamp) και αντικείμενο message, ενώ τα μηνύματα που στέλνει ο ίδιος ο λογαριασμός επιστρέφουν στο ίδιο πεδίο με is_echo ίσο με true.
Το easyCoexistence εγγράφει κάθε συνδεδεμένο λογαριασμό Instagram σε messages και προωθεί τα DM του, μαζί με τα echoes, στο HTTPS endpoint σας καθώς φτάνουν, υπογεγραμμένα με το μυστικό του λογαριασμού· η προώθηση δεν κρατά αντίγραφο, και τα DM δεν αποθηκεύονται από προεπιλογή.
Ορίζεται σε true σε συμβάν μηνύματος για μήνυμα που έστειλε ο ίδιος ο λογαριασμός.
Τυπικό παράθυρο μηνυμάτων για τις περισσότερες ενέργειες χρήστη, εντός του οποίου η εφαρμογή μπορεί να απαντήσει στο άτομο.
Τύπος συνημμένου για κοινοποιημένη ανάρτηση· ο παλιός τύπος share υποστηριζόταν μόνο έως 1 Φεβρουαρίου 2026.
Τύπος συνημμένου του συμβάντος DM που στέλνει η Meta όταν κάποιος αναφέρει τον λογαριασμό στο Story του.
Υποκωδικός σφάλματος, κάτω από τον κωδικό 200, όταν ο ιδιοκτήτης του λογαριασμού έχει απενεργοποιήσει την πρόσβαση στα άμεσα μηνύματα του Instagram.
Πότε ενεργοποιείται το πεδίο messages;
Όταν ένα άτομο στέλνει DM στον επαγγελματικό λογαριασμό, και όταν ο λογαριασμός στέλνει ένα. Τα παραδείγματα και οι αναφορές της Meta καταγράφουν αυτές τις περιπτώσεις, καθεμία ως συμβάν messaging με αντικείμενο message:
- Κείμενο, και πολυμέσα ως συνημμένα: εικόνες, βίντεο, ήχος και αρχεία.
- Κοινοποιημένη ανάρτηση ή Reel, ως συνημμένο
ig_post,ig_reelή reel. - Απάντηση σε Story του λογαριασμού, με
reply_to.story, και Story που αναφέρει τον λογαριασμό, ως συνημμένοstory_mention. - Ενσωματωμένη απάντηση σε προηγούμενο μήνυμα, με
reply_to.mid, και γρήγορη απάντηση, μεquick_reply.payload. - Μήνυμα που διέγραψε το άτομο (
is_deleted), μη υποστηριζόμενα πολυμέσα (is_unsupported) και μήνυμα από άτομο που πάτησε διαφήμιση Click-to-Direct (referral). - Μήνυμα που έστειλε ο λογαριασμός, το οποίο επιστρέφει με
is_echoίσο με true.
Πώς μοιάζει μια ειδοποίηση μηνυμάτων;
Ένα POST του οποίου το JSON έχει object ίσο με instagram. Σε αντίθεση με το σχόλιο, το μήνυμα βρίσκεται σε πίνακα messaging μέσα στο entry του λογαριασμού, και κάθε στοιχείο περιέχει sender, recipient, timestamp και message. Μια απάντηση σε Story του λογαριασμού μοιάζει ως εξής:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL_FOR_THE_STORY>",
"id": "<STORY_ID>"
}
}
}
}
]
}
]
}Τι σημαίνει κάθε πεδίο;
Τα πεδία που τεκμηριώνει η Meta για συμβάν μηνύματος στο Instagram Login, από έξω προς τα μέσα:
- entry[].id: το ID του επαγγελματικού λογαριασμού. entry[].time: πότε έστειλε η Meta την ειδοποίηση· τα δείγματα μηνυμάτων της Meta το δίνουν σε χιλιοστά του δευτερολέπτου.
- sender.id και recipient.id: σε εισερχόμενο DM, το Instagram-scoped ID του ατόμου και το ID του λογαριασμού· σε echo, τα ίδια δύο αντίστροφα.
- timestamp: πότε στάλθηκε το μήνυμα, σε χιλιοστά στα δείγματα της Meta. Ταξινομήστε τα μηνύματα με αυτό, όχι με τη σειρά άφιξης.
- message.mid: το ID του μηνύματος, για αποδιπλασιασμό, αντίδραση και απάντηση σε αυτό το μήνυμα με
reply_to.mid. - message.text: περιλαμβάνεται όταν το μήνυμα έχει κείμενο.
- message.attachments[]: καθένα με type και payload, συνήθως url. Το payload ενός
ig_postπροσθέτειig_post_media_idκαι title, δηλαδή τη λεζάντα της ανάρτησης. - message.
reply_to: mid για ενσωματωμένη απάντηση, ή story με το url και το id του Story για απάντηση σε Story. - message.
quick_reply.payload και message.referral: η επιλεγμένη γρήγορη απάντηση, και το ref,ad_id, source, type καιads_context_dataτης διαφήμισης Click-to-Direct. - message.
is_deleted,is_echo,is_selfκαιis_unsupported: περιλαμβάνονται μόνο όταν είναι true. - message.
admin_textκαιhandoff_reason: σε επιλέξιμες εφαρμογές, ειδοποίηση ότι μια εφαρμογή της Meta, όπως το Meta Business Agent, μεταβίβασε τη συνομιλία· μπορεί να έρθει χωρίς mid ή text.
Πώς λειτουργούν τα echoes;
Όταν ο λογαριασμός στέλνει μήνυμα, η Meta στέλνει και για αυτό συμβάν messages, με is_echo ίσο με true. Τότε το sender.id είναι ο λογαριασμός και το recipient.id το Instagram-scoped ID του ατόμου, ενώ ένα δοκιμαστικό μήνυμα που στέλνει ο λογαριασμός στον εαυτό του φέρει και is_self. Τα echoes καταγράφουν τι είπε ο λογαριασμός, κάτι που χρειάζεται ένα αρχείο συνομιλιών, όμως ο χειριστής που αποφασίζει αν θα απαντήσει πρέπει να τα παραλείπει. Η Meta δεν στέλνει echo όταν ο λογαριασμός αντιδρά σε μήνυμα ή αφαιρεί αντίδραση.
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448061203,
"messaging": [
{
"sender": { "id": "<IG_ID>" },
"recipient": { "id": "<IGSID>" },
"timestamp": 1793448060950,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<REPLY_TEXT>",
"is_echo": true
}
}
]
}
]
}Σε ποιο ID απαντάτε;
Στο sender.id, το Instagram-scoped ID του ατόμου. Η Meta το δημιουργεί όταν κάποιος στέλνει μήνυμα στον λογαριασμό ή σχολιάζει το περιεχόμενό του, και είναι συγκεκριμένο για αυτό το άτομο και αυτόν τον λογαριασμό. Το POST /<IG_ID>/messages με recipient.id ίσο με αυτό στέλνει την απάντηση. Το συμβάν δεν φέρει όνομα ή username· το GET /<IGSID> με πεδία όπως name και username τα επιστρέφει, επειδή όποιος έχει στείλει μήνυμα στον λογαριασμό έχει δώσει τη συγκατάθεση που χρειάζεται αυτή η αναζήτηση.
Πώς ένα μήνυμα ανοίγει το παράθυρο 24 ωρών;
Μια εφαρμογή μπορεί να στείλει μήνυμα σε άτομο μόνο αφού εκείνο έχει στείλει μήνυμα στον λογαριασμό, και μόνο εντός του τυπικού παραθύρου μηνυμάτων που ανοίγει η ενέργειά του. Για τις περισσότερες ενέργειες διαρκεί 24 ώρες, και έως 7 ημέρες από ένα πρώτο μήνυμα που στέλνεται μετά από κλικ σε διαφήμιση Click-to-Direct. Ένα νέο μήνυμα του ατόμου ανοίγει νέο παράθυρο, γι' αυτό πρέπει να παρακολουθείτε το τελευταίο timestamp· ένα echo είναι μήνυμα του ίδιου του λογαριασμού και δεν επεκτείνει τίποτα. Απαντήσεις που γράφει άνθρωπος μπορούν να χρησιμοποιήσουν το ξεχωριστό παράθυρο 7 ημερών Human Agent της Meta, με ετικέτα human_agent.
Τι δεν περιλαμβάνει ένα συμβάν μηνυμάτων;
Ορισμένα στοιχεία που θα αναζητούσε ο χειριστής λείπουν, σύμφωνα με τις αναφορές μηνυμάτων της Meta:
- Το όνομα ή το username του ατόμου: μόνο το Instagram-scoped ID, το οποίο λύνει το GET /<IGSID>.
- Πολυμέσα μίας προβολής: φτάνουν ως εφήμερο συνημμένο χωρίς URL.
- Η ακριβής εικόνα του carousel: η αντίδραση ή η προώθηση μιας εικόνας σε ανάρτηση carousel αναφέρει την πρώτη εικόνα.
- Αντιδράσεις, επεξεργασίες και αποδείξεις ανάγνωσης, που έρχονται σε δικά τους πεδία.
- Σήμανση ανάγνωσης: μήνυμα που παραδόθηκε με webhook παραμένει αδιάβαστο στα εισερχόμενα του Instagram έως ότου σταλεί απάντηση.
Ποια άλλα πεδία μηνυμάτων αναφέρει η Meta;
Η λίστα πεδίων της Meta και τα παραδείγματα για το Instagram Login αναφέρουν και αυτά εκτός από τα messages, το καθένα ως δικό του συμβάν messaging. Το easyCoexistence εγγράφει κάθε λογαριασμό μόνο σε messages, comments και mentions, οπότε κανένα από αυτά δεν περιλαμβάνεται σε όσα προωθεί:
message_reactions: το άτομο αντιδρά σε μήνυμα ή αφαιρεί την αντίδραση, με reaction.mid, action ίσο με react ή unreact, και το reaction και το emoji.message_edit: το άτομο επεξεργάζεται μήνυμα, μεmessage_edit.mid, το νέο κείμενο καιnum_edit.messaging_postbacks: το άτομο πατά icebreaker ή κουμπί προτύπου, με postback.mid, title και payload.messaging_referral: άτομο που ήδη είναι σε συνομιλία ανοίγει σύνδεσμο ig.me με παράμετρο ref.messaging_seen: το άτομο διαβάζει ένα μήνυμα, με read.mid.messaging_optins,messaging_handoverκαι standby: τα δύο τελευταία για εφαρμογές που μοιράζονται μια συνομιλία βάσει του πρωτοκόλλου μεταβίβασης της Meta.
Τι πρέπει να ενεργοποιήσει ο λογαριασμός;
Να επιτρέπεται η πρόσβαση στα μηνύματα («Allow access to messages»). Η Meta απαιτεί από τον επαγγελματικό λογαριασμό να την ενεργοποιήσει πριν διαχειριστεί τα μηνύματά του μέσω του API, στην εφαρμογή Instagram στις Ρυθμίσεις, Μηνύματα και απαντήσεις σε Story, Έλεγχοι μηνυμάτων, Συνδεδεμένα εργαλεία. Όσο είναι απενεργοποιημένη, τα αιτήματα αποστολής αποτυγχάνουν με κωδικό 200, υποκωδικό 2534041. Η εφαρμογή χρειάζεται επίσης τα instagram_business_basic και instagram_business_manage_messages, και Advanced Access για να εξυπηρετεί λογαριασμούς που δεν κατέχει ή δεν διαχειρίζεται.
Πώς προωθεί το easyCoexistence ένα DM;
Όπως ένα σχόλιο: κάθε εγγραφή που στέλνει η Meta για τον λογαριασμό αποστέλλεται με POST στο HTTPS endpoint σας, μέσα σε φάκελο με platform, account_id, external_id και entry, υπογεγραμμένο στο X-EC-Signature με το μυστικό του λογαριασμού, μία φορά και χωρίς να κρατείται αντίγραφο. Τα echoes προωθούνται μαζί με τα υπόλοιπα, οπότε ελέγξτε το is_echo πριν απαντήσετε. Για να απαντήσετε, καλέστε το send_social_dm με το account_id και το sender.id του συμβάντος ως recipient_id, εντός του παραθύρου 24 ωρών. Οι αυτοματισμοί που ξεκινούν από DM τρέχουν στα ίδια συμβάντα.
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "image", "payload": { "url": "<URL_FOR_THE_MEDIA>" } }
]
}
}
]
}
}Συνηθισμένα λάθη
- Απάντηση σε echoes. Συμβάν με ορισμένο is_echo είναι μήνυμα του ίδιου του λογαριασμού, και απάντηση σε αυτό στέλνει τον λογαριασμό σε βρόχο με τον εαυτό του.
- Υπόθεση ότι κάθε μήνυμα έχει κείμενο. Συνημμένα, κοινοποιήσεις, αναφορές σε Story και διαγραφές φτάνουν χωρίς πεδίο text, οπότε διακλαδώστε ανάλογα με το περιεχόμενο του αντικειμένου message.
- Ταξινόμηση μηνυμάτων με βάση τη σειρά άφιξης. Η Meta μπορεί να παραδώσει μηνύματα εκτός σειράς μετά από αποτυχία, οπότε ταξινομήστε τα με βάση το timestamp.
- Ανάλυση του time και του timestamp ως δευτερόλεπτα. Τα δείγματα μηνυμάτων της Meta δίνουν και τα δύο σε χιλιοστά, και αν διαβαστούν ως δευτερόλεπτα γίνονται ημερομηνίες πολύ στο μέλλον.
Το send_social_dm απαντά εντός του παραθύρου 24 ωρών, και οι αυτοματισμοί μπορούν να απαντούν μόνοι τους με σταθερό κείμενο ή με AI. Από US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Είναι τα timestamps των webhook μηνυμάτων του Instagram σε δευτερόλεπτα ή χιλιοστά;
Σε χιλιοστά, στα δείγματα μηνυμάτων της Meta, τόσο για το timestamp όσο και για τον χρόνο της εγγραφής. Αν διαβαστούν ως δευτερόλεπτα, γίνονται ημερομηνίες πολύ στο μέλλον.
Πώς παίρνω το username του αποστολέα από ένα webhook DM του Instagram;
Καλέστε GET /<IGSID> με πεδία όπως name και username. Το συμβάν φέρει μόνο το Instagram-scoped ID του ατόμου.
Γιατί δεν φτάνουν τα webhook DM του Instagram;
Ελέγξτε ότι ο λογαριασμός ενεργοποίησε τη «Να επιτρέπεται η πρόσβαση στα μηνύματα», ότι είναι εγγεγραμμένος στο messages μέσω του /subscribed_apps, και ότι η εφαρμογή είναι Live με Advanced Access για λογαριασμούς που δεν κατέχει.
Προωθεί το easyCoexistence τις αντιδράσεις μηνυμάτων του Instagram;
Όχι. Οι αντιδράσεις έρχονται στο message_reactions, και το easyCoexistence εγγράφει τους λογαριασμούς σε messages, comments και mentions.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις