Αναφορές και απαντήσεις σε 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 του, όπως φτάνουν, υπογεγραμμένα με το μυστικό του λογαριασμού και χωρίς να κρατείται αντίγραφο.
Τύπος συνημμένου του συμβάντος messages που στέλνει η Meta όταν κάποιος αναφέρει τον λογαριασμό στο Story του.
Πεδίο που η Meta πρόσθεσε στο reply_to.story στις 12 Δεκεμβρίου 2025, με το URL του αυτοκόλλητου συνδέσμου του Story που απαντήθηκε.
Πόσο διαρκεί ένα Story· μόλις λήξει ή διαγραφεί, το URL της αναφοράς σταματά να εμφανίζεται.
Λογαριασμοί των οποίων φτάνουν οι αναφορές σε Story· η αναφορά ιδιωτικού λογαριασμού φτάνει μόνο αν ακολουθεί τον επαγγελματικό λογαριασμό.
Απαντήσεις σε 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 δεν έχουν κείμενο, γι' αυτό διαβάστε το συνημμένο:
{
"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.
"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 ωρών.
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.
Το 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 οι ιδιωτικοί λογαριασμοί;
Μόνο όταν ο ιδιωτικός λογαριασμός ακολουθεί τον επαγγελματικό λογαριασμό. Οι αναφορές από δημόσιους λογαριασμούς φτάνουν καθώς συμβαίνουν.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις