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

Αναφορές και απαντήσεις σε Story του Instagram στο webhook

Το Instagram στέλνει τις αναφορές σε Story και τις απαντήσεις σε Story ως DM στο πεδίο messages του webhook. Μια αναφορά φτάνει ως μήνυμα του οποίου τα attachments περιέχουν ένα στοιχείο τύπου story_mention, με το CDN URL του Story στο payload.url. Μια απάντηση φέρει το κείμενο του χρήστη και το reply_to.story με το url και το id του Story και, για Story με αυτοκόλλητο συνδέσμου, το link_sticker_url.

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

story_mention

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

link_sticker_url

Πεδίο που η Meta πρόσθεσε στο reply_to.story στις 12 Δεκεμβρίου 2025, με το URL του αυτοκόλλητου συνδέσμου του Story που απαντήθηκε.

24 hours

Πόσο διαρκεί ένα Story· μόλις λήξει ή διαγραφεί, το URL της αναφοράς σταματά να εμφανίζεται.

Public

Λογαριασμοί των οποίων φτάνουν οι αναφορές σε Story· η αναφορά ιδιωτικού λογαριασμού φτάνει μόνο αν ακολουθεί τον επαγγελματικό λογαριασμό.

GIF, sticker

Απαντήσεις σε Story που το webhook δεν υποστηρίζει, σύμφωνα με τον οδηγό Instagram Messaging της Meta.

Πώς φτάνει μια αναφορά σε Story;

Ως DM. Όταν ένα άτομο αναφέρει τον επαγγελματικό λογαριασμό στο Story του, το Instagram τοποθετεί στα εισερχόμενα του λογαριασμού ένα μήνυμα που παραπέμπει σε εκείνο το Story, και η Meta στέλνει γι' αυτό ένα συμβάν messages. Το sender.id είναι το ID του ατόμου στο Instagram, και το message.attachments περιέχει ένα στοιχείο τύπου story_mention, με το payload.url να είναι το CDN URL του Story. Τα δείγματα της Meta δεν έχουν κείμενο, γι' αυτό διαβάστε το συνημμένο:

A Story mention, 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": "story_mention",
                "payload": { "url": "<CDN_URL>" }
              }
            ]
          }
        }
      ]
    }
  ]
}

Πώς φτάνει μια απάντηση σε Story;

Επίσης ως DM, με το μήνυμα του ατόμου και ένα αντικείμενο reply_to που δείχνει στο Story του λογαριασμού. Το reply_to.story περιέχει το CDN url του Story και το id του. Η αναφορά webhook της Meta καταγράφει επίσης εκεί το link_sticker_url, που προστέθηκε τον Δεκέμβριο του 2025 για απαντήσεις σε Story με αυτοκόλλητο συνδέσμου, και η Meta προτείνει να χρησιμοποιείται για δρομολόγηση αυτοματισμών ανά σύνδεσμο. Μια ενσωματωμένη απάντηση σε προηγούμενο μήνυμα χρησιμοποιεί αντί γι' αυτό το reply_to.mid.

The message object of a Story reply
"message": {
  "mid": "<MESSAGE_ID>",
  "text": "<MESSAGE_TEXT>",
  "reply_to": {
    "story": {
      "url": "<CDN_URL>",
      "id": "<STORY_ID>"
    }
  }
}

Τι σημαίνει κάθε πεδίο;

Τα πεδία που τεκμηριώνει η Meta για αυτά τα δύο συμβάντα, από έξω προς τα μέσα:

  • entry[].id και recipient.id: ο επαγγελματικός λογαριασμός. sender.id: το ID του ατόμου στο Instagram, εκείνο στο οποίο πηγαίνει μια απάντηση.
  • timestamp: πότε στάλθηκε το μήνυμα, σε χιλιοστά του δευτερολέπτου στα δείγματα της Meta· το entry[].time είναι πότε έστειλε η Meta την ειδοποίηση.
  • message.mid: το ID του μηνύματος, για αφαίρεση διπλών επαναλήψεων και για απάντηση με reply_to.mid.
  • attachments[].type story_mention και payload.url: μια αναφορά και το CDN URL του Story που την προκάλεσε.
  • reply_to.story.url και reply_to.story.id: το Story του λογαριασμού στο οποίο απάντησε το άτομο.
  • reply_to.story.link_sticker_url: το URL στο αυτοκόλλητο συνδέσμου εκείνου του Story.
  • message.text: τα λόγια της απάντησης, όταν το μήνυμα περιέχει κείμενο.

Πόσο διαρκεί το URL του Story;

Όσο και το ίδιο το Story. Ένα Story εξαφανίζεται μετά από 24 ώρες ή όταν ο δημιουργός του το διαγράψει, και ο οδηγός αναφορών Story της Meta λέει ότι τότε το URL σταματά να εμφανίζεται· η επισκόπηση του προσθέτει ότι τα CDN URL του Instagram λαμβάνουν υπόψη την ιδιωτικότητα και δεν επιστρέφουν τίποτα για διαγραμμένο ή ληγμένο περιεχόμενο. Ο ίδιος οδηγός επιτρέπει να κρατάτε το CDN URL αλλά όχι το μέσο: μια εφαρμογή δεν πρέπει να αποθηκεύει ούτε να κάνει cache το περιεχόμενο του Story στους διακομιστές της, και πρέπει να δείχνει ένα placeholder μόλις το Story χαθεί.

Πότε δεν ενεργοποιείται κανένα από τα δύο συμβάντα;

Οι οδηγοί της Meta αναφέρουν αυτές τις περιπτώσεις, όπου ένας χειριστής που περιμένει συμβάν Story δεν λαμβάνει τίποτα:

  • Αναφορά σε Story από ιδιωτικό λογαριασμό που δεν ακολουθεί τον επαγγελματικό λογαριασμό.
  • Σήμανση σε κανονική ανάρτηση: η Meta λέει ότι μόνο οι αναφορές σε Story ενεργοποιούν το webhook messages, όχι η σήμανση σε αναρτήσεις.
  • Απάντηση σε Story με GIF ή αυτοκόλλητο, που το webhook δεν υποστηρίζει.
  • Τα Story μέσω του API αναφορών: τα GET /<IG_ID>/tags και POST /<IG_ID>/mentions δεν τα υποστηρίζουν, γι' αυτό το DM είναι ο τρόπος με τον οποίο φτάνει μια αναφορά σε Story.

Ανοίγουν οι αναφορές και οι απαντήσεις σε Story το παράθυρο μηνυμάτων;

Μια απάντηση είναι μήνυμα του ατόμου, και η Meta κατατάσσει τις αναφορές σε Story ανάμεσα στα κανάλια μέσω των οποίων ένα άτομο ξεκινά μια συνομιλία. Το παράθυρο που ανοίγει η ενέργειά του διαρκεί 24 ώρες για τις περισσότερες ενέργειες, οπότε ο λογαριασμός μπορεί να απαντήσει με POST /<IG_ID>/messages και recipient.id ίσο με το sender.id του συμβάντος όσο είναι ανοιχτό. Η απάντηση του λογαριασμού επιστρέφει στο messages ως echo, με is_echo ίσο με true.

Πώς το easyCoexistence τα προωθεί;

Στο πεδίο messages, στο οποίο είναι εγγεγραμμένος κάθε συνδεδεμένος λογαριασμός, έτσι ώστε οι αναφορές και οι απαντήσεις σε Story να φτάνουν στο endpoint σας μαζί με τα υπόλοιπα DM του λογαριασμού: κάθε στοιχείο μέσα σε φάκελο με platform, account_id, external_id και entry, υπογεγραμμένο στο X-EC-Signature με το μυστικό του λογαριασμού, σταλμένο μία φορά και χωρίς να κρατείται αντίγραφο. Το send_social_dm απαντά στο άτομο με το sender.id του συμβάντος ως recipient_id, εντός του παραθύρου 24 ωρών.

A forwarded Story mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>

{
  "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": "story_mention", "payload": { "url": "<CDN_URL>" } }
          ]
        }
      }
    ]
  }
}

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

  • Αποθήκευση των μέσων του Story. Ο οδηγός αναφορών Story της Meta επιτρέπει να κρατάτε το CDN URL, όχι το περιεχόμενο, το οποίο δεν πρέπει να αποθηκεύεται ούτε να γίνεται cache στους διακομιστές σας.
  • Ανάγνωση μόνο του message.text. Μια αναφορά σε Story φέρει συνημμένο τύπου story_mention και, στα δείγματα της Meta, κανένα κείμενο, οπότε ένας χειριστής που διαβάζει μόνο κείμενο βλέπει κενό μήνυμα.
  • Εμφάνιση του URL του Story μέρες αργότερα. Παύει να λειτουργεί μόλις το Story λήξει μετά από 24 ώρες ή διαγραφεί, οπότε από τότε δείξτε ένα placeholder.
  • Αναζήτηση αναφορών σε Story στο πεδίο comments ή στο API αναφορών. Η Meta τις στέλνει ως DM στο messages.
Κάντε το με EasyCoexistence

Το send_social_dm απαντά στο άτομο εντός του παραθύρου 24 ωρών, από το Claude, το ChatGPT ή τον δικό σας κώδικα. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με πτώση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.

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

Περιέχει κείμενο ένα συμβάν αναφοράς σε Story του Instagram;

Όχι στα δείγματα της Meta. Μια αναφορά σε Story φέρει συνημμένο τύπου story_mention με το CDN URL του Story, οπότε ένας χειριστής που διαβάζει μόνο το message.text βλέπει κενό μήνυμα.

Τι είναι το link_sticker_url σε μια απάντηση σε Story του Instagram;

Είναι το URL του αυτοκόλλητου συνδέσμου του Story στο οποίο απάντησε το άτομο, στο reply_to.story.link_sticker_url. Η Meta το πρόσθεσε στις 12 Δεκεμβρίου 2025 και το προτείνει για δρομολόγηση αυτοματισμών ανά σύνδεσμο.

Ενεργοποιούν το webhook οι απαντήσεις σε Story με GIF ή αυτοκόλλητο;

Όχι. Ο οδηγός Instagram Messaging της Meta λέει ότι το webhook δεν υποστηρίζει απαντήσεις σε Story που γίνονται με GIF ή αυτοκόλλητο.

Ενεργοποιούν τα webhook αναφοράς σε Story οι ιδιωτικοί λογαριασμοί;

Μόνο όταν ο ιδιωτικός λογαριασμός ακολουθεί τον επαγγελματικό λογαριασμό. Οι αναφορές από δημόσιους λογαριασμούς φτάνουν καθώς συμβαίνουν.

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

Συνημμένα των DM του Instagram στο webhook μηνυμάτωνΤύποι συνημμένων σε DM του Instagram: εικόνα, βίντεο, ήχος, ig_post, ig_reel και story_mention, με payloads, URLs και κενά.Το webhook μηνυμάτων του Instagram: το payload των DM, τα echoes και τα πεδίαΤι στέλνει το webhook μηνυμάτων του Instagram για DM: το Instagram-scoped ID του αποστολέα, κείμενο, συνημμένα, απαντήσεις σε Story, echoes και το παράθυρο 24 ωρών.Τα insights των Stories στο Instagram μέσω του APIΟι μετρήσεις Story που επιστρέφει το API του Instagram, από προσέγγιση, προβολές και απαντήσεις έως πλοήγηση, διάρκεια και σφάλμα 10.Mentions στο Instagram μέσω του API: εύρεση και απάντηση σε @mentionsΠώς φτάνουν τα @mentions του Instagram μέσω του API, στο webhook των σχολίων με Instagram Login, και πώς απαντάτε σε σχόλια και λεζάντες.Τα Instagram DM μέσω του API και το παράθυρο 24 ωρώνΤα DM του Instagram μέσω του API: σε ποιον μπορεί να απαντήσει ο λογαριασμός, το παράθυρο 24 ωρών, οι ιδιωτικές απαντήσεις και η ρύθμιση πρόσβασης.Πεδία webhook του Instagram: η πλήρης λίσταΤα πεδία webhook της Meta για το Instagram API με Instagram Login: τι ενεργοποιεί το καθένα, τι δικαίωμα χρειάζεται και ποια ανήκουν στο Facebook Login.

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

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

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

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