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

Συνημμένα των 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 ή ο κώδικάς σας να ανακτά τα μέσα που χρειάζεται.

ig_post

Τύπος συνημμένου για κοινοποιημένη ανάρτηση· το payload του προσθέτει τα ig_post_media_id και title, δηλαδή τη λεζάντα της ανάρτησης, δίπλα στο url.

1 Feb 2026

Πότε σταμάτησε να υποστηρίζεται για τις κοινοποιήσεις αναρτήσεων στο Instagram ο παλιός τύπος συνημμένου share.

ephemeral

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

is_unsupported

Ορίζεται σε true σε ένα event μηνύματος όταν το μήνυμα περιέχει μέσα που δεν υποστηρίζονται.

First image

Τι αναφέρει μια ειδοποίηση όταν κάποιος αντιδρά ή προωθεί μία εικόνα από ανάρτηση carousel.

Ποιους τύπους συνημμένων μπορεί να έχει ένα event DM;

Τα παραδείγματα της Meta για το Instagram Login απαριθμούν αυτές τις τιμές για το message.attachments[].type, καθεμία με ένα αντικείμενο payload. Τα περισσότερα payloads περιέχουν ένα url προς το μέσο στο CDN της Meta, και η Meta τεκμηριώνει επιπλέον πεδία payload μόνο για το ig_post, οπότε διαβάστε πρώτα τον τύπο και μετά το payload.

imageA photo. Meta's Instagram Login list also puts GIFs and stickers under this type.
videoA video, at payload.url.
audioAudio, at payload.url.
fileA file, at payload.url.
ig_postA shared post: url, ig_post_media_id and title, its caption.
ig_reel and reelA shared Reel; Meta lists both names, each with a url.
story_mentionA Story that mentions the account, at its CDN URL.
shareThe legacy post share, supported until 1 February 2026.
media, story, ig_storyAlso in Meta's list, with no payload described.
ephemeralView-once media, sent with no URL.

Πώς μοιάζει ένα DM με συνημμένα;

Ένα event μηνυμάτων του οποίου το αντικείμενο message περιέχει message.attachments αντί για κείμενο ή μαζί με αυτό. Το δείγμα της Meta στέλνει δύο αρχεία μέσων σε ένα μήνυμα, καθένα με τον δικό του type και payload.url, οπότε ο handler πρέπει να διατρέχει τον πίνακα αντί να διαβάζει μόνο το πρώτο στοιχείο:

A DM with two attachments, as Meta sends it
{
  "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:

The attachment of a shared post
"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.
Κάντε το με EasyCoexistence

Το 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 δείχνει δύο αρχεία μέσων σε ένα μήνυμα.

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

Αναφορές και απαντήσεις σε Story του Instagram στο webhookΠώς φτάνουν οι αναφορές και απαντήσεις σε Story στο πεδίο messages του webhook: story_mention, reply_to.story, το CDN URL και το παράθυρο απάντησης.Το 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 του Instagram: η πλήρης λίσταΤα πεδία webhook της Meta για το Instagram API με Instagram Login: τι ενεργοποιεί το καθένα, τι δικαίωμα χρειάζεται και ποια ανήκουν στο Facebook Login.Τα Instagram DM μέσω του API και το παράθυρο 24 ωρώνΤα DM του Instagram μέσω του API: σε ποιον μπορεί να απαντήσει ο λογαριασμός, το παράθυρο 24 ωρών, οι ιδιωτικές απαντήσεις και η ρύθμιση πρόσβασης.

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

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

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

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