Ανάγνωση του ιστορικού συνομιλιών Messenger μέσω του API
Το ιστορικό Messenger μιας Σελίδας Facebook διαβάζεται με GET /{page-id}/conversations?platform=messenger, που επιστρέφει τα αναγνωριστικά συνομιλιών με την ώρα της τελευταίας ενημέρωσής τους. Έπειτα, GET /{conversation-id}?fields=messages δίνει τα αναγνωριστικά μηνυμάτων και GET /{message-id} για κάθε μήνυμα δίνει τον αποστολέα, τον παραλήπτη, το κείμενο και τα συνημμένα. Η Meta επιστρέφει λεπτομέρειες για τα 20 πιο πρόσφατα μηνύματα μιας συνομιλίας, και οι κλήσεις χρειάζονται ένα Page token με pages_messaging.
Το easyCoexistence προωθεί τα νέα μηνύματα Messenger μιας Σελίδας στο endpoint σας καθώς φτάνουν, και το send_social_dm απαντά μέσα στο παράθυρο 24 ωρών, από το Claude, το ChatGPT ή δικό σας κώδικα.
Μόνο τα 20 πιο πρόσφατα μηνύματα μιας συνομιλίας επιστρέφουν λεπτομέρειες. Τα παλαιότερα επιστρέφουν σφάλμα ότι το μήνυμα έχει διαγραφεί.
Τις κλήσεις Conversations API που μπορεί να κάνει μια εφαρμογή ανά Σελίδα Facebook.
Οι συνομιλίες του φακέλου Requests που παραμένουν ανενεργές για τόσο διάστημα δεν περιλαμβάνονται στα αποτελέσματα του API.
Η εργασία Page που πρέπει να μπορεί να εκτελεί το άτομο πίσω από το token για να διαβάζει συνομιλίες.
Σφάλμα για πολλές κλήσεις Messenger API προς έναν λογαριασμό Page. Η Meta προτείνει να περιμένετε λίγο και να δοκιμάσετε ξανά.
Πώς καταγράφετε τις συνομιλίες μιας Σελίδας;
Με GET /{page-id}/conversations, ορίζοντας το platform σε messenger. Το αποτέλεσμα περιέχει έναν πίνακα data με αναγνωριστικά συνομιλιών, καθένα με updated_time, δηλαδή την ώρα που προστέθηκε το τελευταίο μήνυμα, και ένα αντικείμενο paging. Η τεκμηρίωση της Meta σημειώνει ότι η σελιδοποίηση βάσει χρόνου δεν είναι διαθέσιμη σε αυτό το endpoint, οπότε ακολουθήστε το αντικείμενο paging για να προχωρήσετε στη λίστα.
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}Πώς βρίσκετε τη συνομιλία ενός ατόμου;
Προσθέτετε στο ίδιο αίτημα το user_id, με τιμή το Page-scoped ID του ατόμου. Η Meta απαντά με το αναγνωριστικό της συνομιλίας ανάμεσα στη Σελίδα και στο άτομο, που είναι η συντομότερη διαδρομή από ένα webhook μηνυμάτων, όπου το PSID φτάνει ως sender.id, στο ιστορικό πίσω του:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }Πώς διαβάζετε τα μηνύματα μιας συνομιλίας;
Σε δύο βήματα. Η κλήση GET /{conversation-id} με fields=messages επιστρέφει τα αναγνωριστικά μηνυμάτων της συνομιλίας, καθένα με created_time, με το πιο πρόσφατο πρώτο. Έπειτα, η κλήση GET /{message-id} με τα πεδία που χρειάζεστε, όπως id, created_time, from, to, message και reply_to, επιστρέφει το περιεχόμενο ενός μηνύματος. Τα προεπιλεγμένα πεδία είναι τα id και created_time, και ένα πεδίο χωρίς δεδομένα παραλείπεται από την απάντηση.
Ποια πεδία μπορείτε να διαβάσετε;
Μια συνομιλία και ένα μήνυμα εκθέτουν διαφορετικά πεδία. Αυτά είναι όσα αναφέρουν οι αναφορές της Meta για τα μηνύματα Σελίδας:
- Συνομιλία: id,
updated_time, participants με το ID, το όνομα και το email τους, messages, καιis_ownerόταν είναι ενεργοποιημένο το Conversation Routing. - Μήνυμα: id,
created_time, from και to, καθένα με ID, όνομα και email, και message, το κείμενο, κενό όταν δεν υπάρχει. - attachments: αρχεία, εικόνες και βίντεο με τα CDN URL τους, και
is_unsupported, που επιστρέφεται μόνο όταν ένα μήνυμα περιέχει μη υποστηριζόμενο περιεχόμενο. - reactions,
reply_toμε το mid στο οποίο απαντά καιis_self_reply, και shares για κοινοποιημένες αναρτήσεις και reels. - tags: ο φάκελος και η πηγή του μηνύματος, όπως inbox, read ή source:chat.
Μέχρι πού μπορείτε να διαβάσετε;
Όσο πίσω φτάνει η ίδια η συνομιλία για τα αναγνωριστικά, αλλά όχι για το περιεχόμενο. Ο οδηγός της Meta λέει ότι το endpoint της συνομιλίας επιστρέφει όλα τα αναγνωριστικά μηνυμάτων, ενώ λεπτομέρειες επιστρέφουν μόνο για τα 20 πιο πρόσφατα μηνύματα. Αν ζητήσετε παλαιότερο, παίρνετε σφάλμα ότι το μήνυμα διαγράφηκε. Οι συνομιλίες του φακέλου Requests που είναι ανενεργές για 30 ημέρες δεν επιστρέφονται καθόλου.
Ποιες άδειες και εργασίες χρειάζεται;
Ένα Page access token από κάποιον που μπορεί να εκτελέσει την εργασία MESSAGING ή MODERATE στη Σελίδα, με τα δικαιώματα pages_manage_metadata, pages_read_engagement και pages_messaging. Για να διαβάζετε συνομιλίες με άτομα που δεν έχουν ρόλο στην εφαρμογή, στη Σελίδα ή στην επιχείρηση, χρειάζεται Advanced Access, που η Meta χορηγεί μέσω του App Review.
Ποια όρια ισχύουν για τις κλήσεις;
Τα όρια ρυθμού της Meta δίνουν στο Conversations API 2 κλήσεις το δευτερόλεπτο ανά Σελίδα. Οι κλήσεις πέρα από το όριο επιστρέφουν με κωδικό 613 ή 80006, με μήνυμα «Έχουν γίνει πάρα πολλές κλήσεις Messenger API σε αυτόν τον λογαριασμό Page.» Μια Σελίδα που φτάνει το όριο υψηλού όγκου της Meta, όπως η αποστολή πάνω από 40 μηνυμάτων το δευτερόλεπτο, δεν μπορεί να εμφανίσει λίστα με τις συνομιλίες της έως ότου μειωθεί ο όγκος, αν και μια μεμονωμένη συνομιλία μπορεί ακόμη να διαβαστεί για νέα μηνύματα.
Πότε πρέπει να χρησιμοποιείτε το API αντί για webhooks;
Για το παρελθόν. Τα webhooks παραδίδουν νέα μηνύματα όπως φτάνουν, και η Meta σημειώνει ότι οι προηγούμενες ειδοποιήσεις δεν μπορούν να ερωτηθούν αργότερα. Το Conversations API είναι επομένως ο τρόπος με τον οποίο μια ενσωμάτωση διαβάζει όσα προηγήθηκαν από τη στιγμή που άρχισε να ακούει, ή καλύπτει το κενό μετά από διακοπή λειτουργίας. Με ενεργό το Conversation Routing, το πεδίο is_owner περιορίζει τη λίστα στις συνομιλίες που η εφαρμογή είναι υπεύθυνη να απαντά, κάτι που η Meta προτείνει για ανάκαμψη μετά από διακοπή.
Πώς το easyCoexistence διαβάζει το ιστορικό του Messenger;
Δεν διαβάζει ιστορικό. Η Σελίδα συνδέεται με τα δικαιώματα pages_messaging, pages_manage_metadata και pages_read_engagement, αλλά κανένα εργαλείο δεν καλεί το Conversations API, και τα tokens της Σελίδας δεν παραδίδονται. Τα νέα μηνύματα φτάνουν στο endpoint σας μέσω του set_social_webhook_destination καθώς έρχονται, προωθημένα χωρίς αντίγραφο, ώστε το δικό σας σύστημα να κρατά το ιστορικό που χρειάζεται.
Συνηθισμένα λάθη
- Η αναμονή περιεχομένου μηνυμάτων στην κλήση λίστας. Το endpoint συνομιλιών επιστρέφει αναγνωριστικά μηνυμάτων. Διαβάστε τα πεδία κάθε μηνύματος από το /{message-id}.
- Βασίζεστε στο πλήρες ιστορικό. Οι λεπτομέρειες σταματούν στα 20 πιο πρόσφατα μηνύματα, οπότε αποθηκεύστε ό,τι χρειάζεστε από τα webhooks καθώς φτάνουν τα μηνύματα.
- Ο συνεχής έλεγχος για νέα μηνύματα. Με 2 κλήσεις το δευτερόλεπτο ανά Σελίδα, ένας βρόχος ελέγχου σύντομα φτάνει στο όριο ρυθμού, ενώ το webhook μηνυμάτων τα παραδίδει καθώς συμβαίνουν.
- Η σελιδοποίηση συνομιλιών ανά ημερομηνία με since και until. Η σελιδοποίηση βάσει χρόνου δεν είναι διαθέσιμη στο endpoint συνομιλιών. Ακολουθήστε αντί γι' αυτό το αντικείμενο paging.
Δεν έχει εργαλείο για το Conversations API, οπότε το παλαιότερο ιστορικό διαβάζεται στο inbox της Σελίδας. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Περιλαμβάνει το Conversations API και τα μηνύματα της ίδιας της Σελίδας;
Ναι. Τα πεδία from και to δείχνουν το άτομο ή τη Σελίδα, οπότε οι συνομιλίες περιέχουν και τις δύο πλευρές.
Μπορώ να διαβάζω συνομιλίες Messenger χωρίς App Review;
Για άτομα με ρόλο στην εφαρμογή ή στη Σελίδα αρκεί το Standard Access. Για συνομιλίες με οποιονδήποτε άλλον χρειάζεται Advanced Access, που χορηγείται μέσω App Review.
Μπορεί το Conversations API να στέλνει απαντήσεις;
Όχι. Η αναφορά της Meta για το Conversations API λέει ότι το edge δεν μπορεί να δημοσιεύσει. Οι απαντήσεις περνούν από το Send API στο /{page-id}/messages.
Αποθηκεύει το easyCoexistence τις συνομιλίες Messenger;
Όχι από προεπιλογή. Τα προωθούμενα γεγονότα προωθούνται χωρίς να κρατείται αντίγραφο· με ενεργό αυτοματισμό, το κείμενο των μηνυμάτων διατηρείται για 7 ημέρες και τα αρχεία καταγραφής των εκτελέσεων του αυτοματισμού για 30 ημέρες.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις