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

Το 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 δεν αποθηκεύονται από προεπιλογή.

is_echo

Ορίζεται σε true σε συμβάν μηνύματος για μήνυμα που έστειλε ο ίδιος ο λογαριασμός.

24 hours

Τυπικό παράθυρο μηνυμάτων για τις περισσότερες ενέργειες χρήστη, εντός του οποίου η εφαρμογή μπορεί να απαντήσει στο άτομο.

ig_post

Τύπος συνημμένου για κοινοποιημένη ανάρτηση· ο παλιός τύπος share υποστηριζόταν μόνο έως 1 Φεβρουαρίου 2026.

story_mention

Τύπος συνημμένου του συμβάντος DM που στέλνει η Meta όταν κάποιος αναφέρει τον λογαριασμό στο Story του.

2534041

Υποκωδικός σφάλματος, κάτω από τον κωδικό 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 του λογαριασμού μοιάζει ως εξής:

A messages notification, 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>",
            "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 όταν ο λογαριασμός αντιδρά σε μήνυμα ή αφαιρεί αντίδραση.

An echo of a message the account sent
{
  "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 τρέχουν στα ίδια συμβάντα.

A forwarded DM with an image
{
  "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 δίνουν και τα δύο σε χιλιοστά, και αν διαβαστούν ως δευτερόλεπτα γίνονται ημερομηνίες πολύ στο μέλλον.
Κάντε το με EasyCoexistence

Το 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.

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

Το webhook σχολίων του Instagram: το payload, πεδίο προς πεδίοΤι στέλνει το webhook σχολίων του Instagram όταν κάποιος σχολιάζει posts και Reels: το payload πεδίο προς πεδίο, τι παραλείπει και οι παγίδες.Επαλήθευση webhook του Instagram: hub.challenge και X-Hub-Signature-256Πώς ρυθμίζετε τα webhooks του Instagram: απάντηση στο hub.challenge της Meta, έλεγχος του X-Hub-Signature-256 και εγγραφή κάθε λογαριασμού.Συμβάντα webhook του Instagram: σχόλια, αναφορές και DMsΠώς φτάνουν στο endpoint σας τα σχόλια, οι αναφορές και τα DMs του Instagram ως συμβάντα webhook, πώς υπογράφονται και τι να ελέγξετε.Τα Instagram DM μέσω του API και το παράθυρο 24 ωρώνΤα DM του Instagram μέσω του API: σε ποιον μπορεί να απαντήσει ο λογαριασμός, το παράθυρο 24 ωρών, οι ιδιωτικές απαντήσεις και η ρύθμιση πρόσβασης.API ιδιωτικών απαντήσεων του Instagram: απάντηση σε σχόλιο με DMΣτείλτε ιδιωτική απάντηση στο Instagram με POST /<IG_ID>/messages, με το ID του σχολίου, μία ανά σχόλιο μέσα σε 7 ημέρες και σφάλμα 2534025.Mentions στο Instagram μέσω του API: εύρεση και απάντηση σε @mentionsΠώς φτάνουν τα @mentions του Instagram μέσω του API, στο webhook των σχολίων με Instagram Login, και πώς απαντάτε σε σχόλια και λεζάντες.

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

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

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

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