Συνημμένα των DM του Instagram στο webhook μηνυμάτων
Το webhook μηνυμάτων του Instagram μεταφέρει τα μέσα των DM στο message.attachments: έναν πίνακα αντικειμένων, καθένα με έναν τύπο και ένα payload που συνήθως περιέχει ένα URL CDN. Η λίστα της Meta για το Instagram Login ονομάζει image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story και το παλιό share, ενώ τα μέσα μίας προβολής φτάνουν ως εφήμερο συνημμένο χωρίς URL.
Το easyCoexistence εγγράφει κάθε συνδεδεμένο λογαριασμό Instagram στα messages και προωθεί τα DM με τα συνημμένα τους στο HTTPS endpoint σας όπως τα στέλνει η Meta, υπογεγραμμένα με το μυστικό του λογαριασμού και χωρίς αντίγραφο, ώστε ο agent ή ο κώδικάς σας να ανακτά τα μέσα που χρειάζεται.
Τύπος συνημμένου για κοινοποιημένη ανάρτηση· το payload του προσθέτει τα ig_post_media_id και title, δηλαδή τη λεζάντα της ανάρτησης, δίπλα στο url.
Πότε σταμάτησε να υποστηρίζεται για τις κοινοποιήσεις αναρτήσεων στο Instagram ο παλιός τύπος συνημμένου share.
Τύπος συνημμένου για εξαφανιζόμενα μέσα μίας προβολής, που φτάνει χωρίς URL.
Ορίζεται σε true σε ένα event μηνύματος όταν το μήνυμα περιέχει μέσα που δεν υποστηρίζονται.
Τι αναφέρει μια ειδοποίηση όταν κάποιος αντιδρά ή προωθεί μία εικόνα από ανάρτηση carousel.
Ποιους τύπους συνημμένων μπορεί να έχει ένα event DM;
Τα παραδείγματα της Meta για το Instagram Login απαριθμούν αυτές τις τιμές για το message.attachments[].type, καθεμία με ένα αντικείμενο payload. Τα περισσότερα payloads περιέχουν ένα url προς το μέσο στο CDN της Meta, και η Meta τεκμηριώνει επιπλέον πεδία payload μόνο για το ig_post, οπότε διαβάστε πρώτα τον τύπο και μετά το payload.
Πώς μοιάζει ένα DM με συνημμένα;
Ένα event μηνυμάτων του οποίου το αντικείμενο message περιέχει message.attachments αντί για κείμενο ή μαζί με αυτό. Το δείγμα της Meta στέλνει δύο αρχεία μέσων σε ένα μήνυμα, καθένα με τον δικό του type και payload.url, οπότε ο handler πρέπει να διατρέχει τον πίνακα αντί να διαβάζει μόνο το πρώτο στοιχείο:
{
"object": "instagram",
"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": "<CDN_URL>" } },
{ "type": "video", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
]
}Πώς μοιάζει μια κοινοποιημένη ανάρτηση;
Ένα συνημμένο ig_post. Από τις 3 Νοεμβρίου 2025 η Meta έστελνε κοινοποιήσεις αναρτήσεων με συνημμένα share και ig_post· το share υποστηριζόταν για αναρτήσεις έως την 1η Φεβρουαρίου 2026, και η Meta λέει ότι οι νέες ενσωματώσεις πρέπει να υποστηρίζουν το ig_post. Το payload του προσθέτει το ID μέσου της ανάρτησης και τη λεζάντα της ως title:
"attachments": [
{
"type": "ig_post",
"payload": {
"ig_post_media_id": "<MEDIA_ID>",
"title": "<POST_CAPTION>",
"url": "<CDN_URL>"
}
}
]Τι σημαίνει κάθε πεδίο;
Τα πεδία συνημμένων που τεκμηριώνει η Meta για ένα event DM, από τον πίνακα προς τα κάτω:
- message.attachments[]: ένα αντικείμενο για κάθε αρχείο μέσου· το δείγμα της Meta φέρνει δύο σε ένα μήνυμα.
- type: τι είναι το στοιχείο, από τη λίστα παραπάνω. Ελέγξτε τον τύπο πριν διαβάσετε το payload.
- payload.url: ένα URL CDN για το μέσο. Η επισκόπηση της Meta χαρακτηρίζει αυτά τα URL φιλικά προς το απόρρητο: δεν επιστρέφουν τίποτα μόλις το περιεχόμενο διαγραφεί ή λήξει.
- payload.
ig_post_media_idκαι payload.title: μόνο στοig_post, το ID μέσου της κοινοποιημένης ανάρτησης και η λεζάντα της. - message.text: υπάρχει μόνο όταν το μήνυμα περιέχει και κείμενο.
- message.
is_unsupported: true όταν το μήνυμα περιέχει μέσο που δεν υποστηρίζει το webhook.
Πόσο διαρκούν τα URL συνημμένων;
Η Meta τα συνδέει με το περιεχόμενο. Η επισκόπηση λέει ότι τα URL του CDN του Instagram είναι φιλικά προς το απόρρητο και σταματούν να επιστρέφουν μέσα μόλις το περιεχόμενο διαγραφεί ή λήξει, και ο οδηγός για τις αναφορές σε Stories λέει ότι το URL ενός Story παύει να αποδίδεται όταν λήξει ή διαγραφεί. Μια εφαρμογή που χρειάζεται ένα αρχείο πρέπει να το ανακτήσει όταν φτάσει το event, εντός των κανόνων της Meta: τα μέσα Story, για παράδειγμα, δεν πρέπει να αποθηκεύονται ή να προσωρινά αποθηκεύονται.
Ποια μέσα αφήνει εκτός το webhook;
Ο οδηγός των μηνυμάτων του Instagram της Meta ονομάζει αυτά τα κενά, τα οποία ένας handler πρέπει να περιμένει και όχι να αντιμετωπίζει ως σφάλματα:
- Εξαφανιζόμενα μέσα, μίας προβολής ή με δυνατότητα επανάληψης: ένα συνημμένο τύπου ephemeral, χωρίς URL.
- Μη υποστηριζόμενα μέσα: το μήνυμα φτάνει με το
is_unsupportedορισμένο σε true. - GIF και αυτοκόλλητα: ο οδηγός λέει ότι δεν ενεργοποιούν το webhook, ενώ τα παραδείγματα του Instagram Login της Meta τα κατατάσσουν στο image.
- Η επιλεγμένη εικόνα του carousel: μια αντίδραση ή προώθηση μιας εικόνας σε ανάρτηση carousel αναφέρει την πρώτη εικόνα.
- Κοινοποιήσεις γενικά: οι οδηγοί μηνυμάτων της Meta εξακολουθούν να λένε ότι περιλαμβάνεται μόνο το URL των κοινοποιημένων μέσων, αν και το
ig_postπροσθέτει πλέον το ID μέσου και τη λεζάντα.
Πώς προωθεί το easyCoexistence τα συνημμένα;
Αμετάβλητο, μέσα στο entry: ένα DM με μέσα φτάνει στο endpoint σας με τον πίνακα attachments της Meta όπως τον έστειλε η Meta, σε ένα envelope με platform, account_id, external_id και entry, υπογεγραμμένο με X-EC-Signature. Τα συνημμένα δεν κατεβάζονται, και τα γεγονότα δεν αποθηκεύονται από προεπιλογή· ένας λογαριασμός με ενεργό αυτοματισμό κρατά το κείμενο ενός DM, όχι τα μέσα του, για 7 ημέρες. Ανακτήστε από το payload.url τα μέσα που χρειάζεστε όταν φτάσει το event, και μην αποθηκεύετε μέσα Story.
Συνηθισμένα λάθη
- Ανάγνωση μόνο του πρώτου συνημμένου. Το message.attachments είναι πίνακας, και το δείγμα της Meta φέρνει δύο στοιχεία σε ένα μήνυμα, οπότε διατρέξτε όλο τον πίνακα.
- Εξακολουθείτε να αντιστοιχίζετε με τον τύπο share για κοινοποιημένες αναρτήσεις. Η Meta το υποστήριζε για αναρτήσεις έως την 1η Φεβρουαρίου 2026· διαβάστε το ig_post, με το ID μέσου και τη λεζάντα στο payload του.
- Αποθήκευση του payload.url για μεταγενέστερη ανάκτηση. Σταματά να επιστρέφει μέσα μόλις το περιεχόμενο διαγραφεί ή λήξει, οπότε κατεβάστε όσα χρειάζεστε κατά την άφιξη, εκτός από τα μέσα Story.
- Ανάγνωση του payload.url χωρίς έλεγχο του τύπου. Τα μέσα μίας προβολής φτάνουν ως ephemeral χωρίς URL, ενώ τα μη υποστηριζόμενα ορίζουν το is_unsupported.
Το send_social_dm απαντά μέσα στο παράθυρο 24 ωρών. Από US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με πτώση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Μπορώ να αποθηκεύσω μέσα από συνημμένο DM στο Instagram;
Κατεβάστε όσα χρειάζεστε όταν φτάσει το event, αφού το payload.url σταματά να επιστρέφει μέσα μόλις το περιεχόμενο διαγραφεί ή λήξει. Εξαίρεση αποτελούν τα μέσα Story: οι κανόνες της Meta λένε ότι δεν πρέπει να αποθηκεύονται ή να προσωρινά αποθηκεύονται.
Γιατί ένα webhook DM του Instagram δεν έχει URL μέσου;
Συνήθως επειδή το μέσο είναι μίας προβολής, που φτάνει ως εφήμερο συνημμένο χωρίς URL, ή μη υποστηριζόμενο, που ορίζει το is_unsupported σε true.
Τα GIF και τα αυτοκόλλητα του Instagram ενεργοποιούν το webhook μηνυμάτων;
Οι τεκμηριώσεις της Meta διαφωνούν: τα παραδείγματα του Instagram Login τα κατατάσσουν στο image, ενώ ο οδηγός μηνυμάτων του Instagram λέει ότι δεν ενεργοποιούν το webhook. Δοκιμάστε με πραγματικό λογαριασμό.
Μπορεί ένα event DM του Instagram να έχει πολλά συνημμένα;
Ναι. Το message.attachments είναι πίνακας, και το δείγμα της Meta δείχνει δύο αρχεία μέσων σε ένα μήνυμα.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις