Ανάγνωση ιστορικού DM στο Instagram: το Conversations API
Το Conversations API του Instagram διαβάζει το ιστορικό DM ενός επαγγελματικού λογαριασμού στο graph.instagram.com. Το GET /me/conversations?platform=instagram εμφανίζει τις συνομιλίες με το updated_time τους, το GET /<CONVERSATION_ID>?fields=messages εμφανίζει τα μηνύματα μιας συνομιλίας ανά ID και χρόνο, και το GET /<MESSAGE_ID>?fields=id,created_time,from,to,message επιστρέφει ένα μήνυμα. Οι λεπτομέρειες είναι διαθέσιμες για τα 20 πιο πρόσφατα μηνύματα κάθε συνομιλίας.
Το easyCoexistence προωθεί τα νέα DM του Instagram στο endpoint σας καθώς έρχονται και απαντά με το send_social_dm μέσα στο παράθυρο των 24 ωρών, από το Claude, το ChatGPT ή τον δικό σας κώδικα, με το επίσημο API της Meta· δεν έχει εργαλείο για το ιστορικό του Conversations API.
Τα πιο πρόσφατα μηνύματα κάθε συνομιλίας για τα οποία το API επιστρέφει λεπτομέρειες· τα παλαιότερα απαντούν με σφάλμα ότι έχουν διαγραφεί.
Η αδράνεια μετά την οποία συνομιλίες του φακέλου «Αιτήματα» δεν επιστρέφονται πλέον.
Οι κλήσεις του Conversations API που μπορεί να κάνει μια εφαρμογή ανά δευτερόλεπτο για κάθε επαγγελματικό λογαριασμό Instagram.
instagram_business_basic και instagram_business_manage_messages, σε ένα token από κάποιον που μπορεί να διαχειρίζεται τα μηνύματα του λογαριασμού.
Πώς εμφανίζετε τις συνομιλίες ενός λογαριασμού;
Με GET /me/conversations, ή /<IG_ID>/conversations, και platform=instagram, χρησιμοποιώντας ένα Instagram User access token από κάποιον που μπορεί να διαχειρίζεται τα μηνύματα του λογαριασμού. Κάθε εγγραφή στο array data είναι μία συνομιλία, με το id και το updated_time της.
GET https://graph.instagram.com/me/conversations
?platform=instagram
&access_token=<ACCESS_TOKEN>
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
]
}Πώς βρίσκετε τη συνομιλία με ένα άτομο;
Προσθέστε το user_id με το Instagram-scoped ID του ατόμου, δηλαδή το IGSID που έρχεται ως sender.id όταν στέλνει μήνυμα στον λογαριασμό, και η απάντηση επιστρέφει το id της συνομιλίας. Έτσι ένα γεγονός webhook μετατρέπεται στο νήμα του, χωρίς να ξεφυλλίζετε ολόκληρη τη λίστα.
GET https://graph.instagram.com/me/conversations
?user_id=<IGSID>
&access_token=<ACCESS_TOKEN>Πώς διαβάζετε τα μηνύματα;
Σε δύο βήματα. Το GET /<CONVERSATION_ID>?fields=messages εμφανίζει τα μηνύματα της συνομιλίας με id και created_time, που είναι τα προεπιλεγμένα πεδία. Το GET /<MESSAGE_ID> με fields=id,created_time,from,to,message επιστρέφει έπειτα ένα μήνυμα: ποιος το έστειλε και σε ποιον, το καθένα με username και ID, και το κείμενό του.
GET https://graph.instagram.com/<CONVERSATION_ID>
?fields=messages
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<MESSAGE_ID>
?fields=id,created_time,from,to,message
&access_token=<ACCESS_TOKEN>Μέχρι πού μπορείτε να διαβάσετε πίσω;
Ο οδηγός και η επισκόπηση της Meta ορίζουν τέσσερα όρια σε όσα επιστρέφονται:
- Λεπτομέρειες μηνυμάτων: τα 20 πιο πρόσφατα μηνύματα κάθε συνομιλίας· αν ζητήσετε παλαιότερο, το API επιστρέφει σφάλμα ότι έχει διαγραφεί.
- Αιτήματα: συνομιλίες του φακέλου «Αιτήματα» χωρίς δραστηριότητα για 30 ημέρες δεν επιστρέφονται.
- Κοινοποιήσεις: μια κοινοποιημένη ανάρτηση ή Reel επιστρέφει μόνο ως URL της εικόνας ή του βίντεό της.
- Ρυθμός: 2 κλήσεις ανά δευτερόλεπτο για κάθε επαγγελματικό λογαριασμό Instagram.
Τι χρειάζεται;
Με το Instagram Login, τις άδειες instagram_business_basic και instagram_business_manage_messages και ένα token από κάποιον που μπορεί να διαχειρίζεται τα μηνύματα του λογαριασμού. Το Standard Access αρκεί για λογαριασμούς που κατέχετε ή διαχειρίζεστε και έχετε προσθέσει στην εφαρμογή· η εξυπηρέτηση άλλων λογαριασμών θέλει Advanced Access. Ο λογαριασμός πρέπει επίσης να έχει ενεργοποιημένη την επιλογή Allow access to messages στις ρυθμίσεις της εφαρμογής Instagram.
Γιατί να κρατάτε αρχείο από τα webhooks;
Επειδή το API επιστρέφει λεπτομέρειες μόνο για τα 20 τελευταία μηνύματα κάθε συνομιλίας, το πλήρες ιστορικό πρέπει να αποθηκεύεται καθώς γίνεται. Το webhook messages στέλνει τα DM καθώς φτάνουν, με το IGSID του ατόμου ως sender.id, και στέλνει επίσης τα μηνύματα που στέλνει ο λογαριασμός, με τα ID αντεστραμμένα, ώστε να καταγράφονται και οι δύο πλευρές της συνομιλίας.
Πώς διαβάζετε το ιστορικό DM μέσω του easyCoexistence;
Προωθεί τα DM αντί να διαβάζει ιστορικό. Τα νέα DM φτάνουν στο endpoint σας καθώς έρχονται, αφού το ορίσετε με το set_social_webhook_destination, και προωθούνται χωρίς να κρατείται αντίγραφο. Το send_social_dm απαντά μέσα στο παράθυρο των 24 ωρών, από το Claude, το ChatGPT ή τον δικό σας κώδικα. Κανένα εργαλείο δεν καλεί το me/conversations, οπότε τα προηγούμενα μηνύματα διαβάζονται στην εφαρμογή Instagram ή τα κρατά το δικό σας σύστημα καθώς φτάνουν.
Συνηθισμένα λάθη
- Η προσδοκία ότι το API θα δώσει ολόκληρο το νήμα. Οι λεπτομέρειες σταματούν στα 20 πιο πρόσφατα μηνύματα, γι' αυτό αποθηκεύστε τα DM από το webhook messages καθώς έρχονται.
- Ο έλεγχος των συνομιλιών για νέα DM με polling. Το API επιτρέπει 2 κλήσεις ανά δευτερόλεπτο ανά λογαριασμό, ενώ το webhook messages στέλνει κάθε DM όταν φτάνει.
- Η αναζήτηση παλιού αιτήματος μηνύματος. Οι συνομιλίες του φακέλου «Αιτήματα» με 30 ημέρες αδράνειας δεν επιστρέφονται πια.
- Η ερμηνεία του σφάλματος «deleted» ως διαγραφής από το άτομο. Η Meta απαντά έτσι για κάθε μήνυμα παλαιότερο από τα 20 τελευταία.
US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι 3 πρώτες ημέρες στη δωρεάν δοκιμή.
Συχνές ερωτήσεις
Μπορώ να εξαγάγω το πλήρες ιστορικό DM ενός λογαριασμού Instagram;
Όχι πλήρως μέσω του API: εμφανίζει τις συνομιλίες, αλλά επιστρέφει λεπτομέρειες μόνο για τα 20 πιο πρόσφατα μηνύματα κάθε μίας. Ένα πλήρες αρχείο προκύπτει από την αποθήκευση των DM καθώς τα στέλνει το webhook.
Η ανάγνωση μηνυμάτων μέσω του API τα σημειώνει ως διαβασμένα;
Όχι. Η Meta δηλώνει ότι τα μηνύματα που παραδίδονται μέσω του API δεν σημειώνονται ως διαβασμένα στην εφαρμογή Instagram μέχρι να σταλεί απάντηση.
Λειτουργεί το Conversations API με το Instagram Login;
Ναι. Ο οδηγός της Meta για αυτό είναι γραμμένος για το Instagram Login, με κλήσεις στο graph.instagram.com και τις άδειες instagram_business_*.
Πώς παίρνω το username ενός ατόμου από μια συνομιλία;
Ζητήστε το from πάνω σε ένα μήνυμα, που επιστρέφει το username και το ID του αποστολέα. Το User Profile API επιστρέφει περισσότερα, όπως το όνομα, από το IGSID του ατόμου αφού στείλει μήνυμα στον λογαριασμό.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις