Το webhook history
Το history μεταφέρει τις υπάρχουσες συνομιλίες ενός αριθμού Coexistence στο API. Φτάνει μετά το onboarding, όταν έχει γίνει αποδεκτή η κοινοποίηση ιστορικού, και είναι το μόνο σήμα που λαμβάνει μια integration ότι η μεταφορά ολοκληρώθηκε.
Το χρονικό παράθυρο μετά το onboarding μέσα στο οποίο πρέπει να ξεκινήσει ο συγχρονισμός.
Το σφάλμα που επιστρέφεται όταν ο συγχρονισμός έχει ήδη χρησιμοποιηθεί.
Το σφάλμα που επιστρέφεται όταν επιχειρείται εκτός του χρονικού παραθύρου.
Τι παραδίδει
Το ιστορικό one to one μηνυμάτων που υπήρχε ήδη στην εφαρμογή WhatsApp Business ενός αριθμού μεταφέρεται, ώστε το software να μη ξεκινά χωρίς πλαίσιο σε μια γραμμή που η επιχείρηση χρησιμοποιεί εδώ και χρόνια.
Δεν μεταφέρονται οι ομαδικές συνομιλίες, οι οποίες εξαιρούνται πλήρως από το API σε αριθμό Coexistence, ούτε τα εργαλεία της εφαρμογής: οι ετικέτες, οι γρήγορες απαντήσεις και τα μηνύματα χαιρετισμού και απουσίας δεν έχουν αντίστοιχο στο API και παραμένουν στη συσκευή.
Αυτό το πεδίο υπάρχει μόνο σε αριθμούς Coexistence. Ένας αριθμός που εντάχθηκε με τον συνηθισμένο τρόπο δεν έχει προηγούμενο ιστορικό εφαρμογής για μεταφορά, επομένως δεν υπάρχει κάτι να παραδώσει.
Γιατί ενεργοποιείται μία φορά
Επειδή η μεταφορά αποτελεί μέρος του onboarding και όχι διαρκή δυνατότητα.
Κατά το Embedded Signup, ο ιδιοκτήτης της επιχείρησης ερωτάται αν θέλει να κοινοποιήσει τις υπάρχουσες συνομιλίες. Η καταφατική απάντηση επιτρέπει την εκτέλεση του συγχρονισμού, χωρίς ρύθμιση που να τον ενεργοποιεί ξανά και χωρίς endpoint που να τον επαναλαμβάνει. Μια δεύτερη προσπάθεια επιστρέφει το 2593107 και όχι ένα προσωρινό rate limit.
Υπάρχει επίσης προθεσμία. Ο συγχρονισμός πρέπει να ξεκινήσει εντός 24 ωρών από το onboarding και μια μεταγενέστερη προσπάθεια επιστρέφει το 2593108. Αν χαθεί οποιοδήποτε από τα δύο, χρειάζεται αποσύνδεση του αριθμού και επανάληψη ολόκληρης της διαδικασίας.
Τι πρέπει να κάνει ένας handler με αυτό
Αντιμετωπίστε το ως batch που φτάνει μία φορά και μπορεί να είναι μεγάλο, όχι ως επιπλέον κίνηση στη ροή μηνυμάτων.
- Επιβεβαιώστε γρήγορα τη λήψη και επεξεργαστείτε το ασύγχρονα, όπως κάθε άλλη παράδοση.
- Κάντε deduplicate με βάση το message id: τα history και live messages μπορεί να επικαλύπτονται γύρω από τη στιγμή του onboarding.
- Αναμένετε να απουσιάζει. Ένας αριθμός του οποίου ο ιδιοκτήτης αρνήθηκε το ιστορικό δεν στέλνει τίποτα εδώ και η integration πρέπει να λειτουργεί σε κάθε περίπτωση.
- Μην μπλοκάρετε το onboarding εξαιτίας του. Η σύνδεση μπορεί να χρησιμοποιηθεί πριν ολοκληρωθεί η μεταφορά.
Συνηθισμένα λάθη
- Δημιουργία integration που απαιτεί να υπάρχει history. Πολλοί αριθμοί συνδέονται χωρίς αυτό.
- Επανάληψη του συγχρονισμού μετά το 2593107. Είναι εφάπαξ συμβάν, επομένως η προσπάθεια επιστρέφει το ίδιο σφάλμα.
- Αναβολή της απόφασης για το ιστορικό μέχρι να ξεκινήσει η εργασία στην integration, συνήθως αφού έχει κλείσει το παράθυρο των 24 ωρών.
Το EasyCoexistence καταγράφει το onboarding και την επιλογή ιστορικού στη χρονογραμμή της σύνδεσης, ώστε το αν συγχρονίστηκε ένας αριθμός και ποια ημέρα να είναι καταγεγραμμένο γεγονός.
Συχνές ερωτήσεις
Πόσο ιστορικό φτάνει;
Ένα πρόσφατο χρονικό παράθυρο συνομιλιών one to one, το οποίο καθορίζει η Meta και όχι ένας provider.
Μεταφέρονται οι ομαδικές συνομιλίες;
Όχι. Οι ομάδες εξαιρούνται πλήρως από το API σε αριθμό Coexistence.
Μπορώ να το ζητήσω ξανά αργότερα;
Όχι. Εκτελείται μία φορά ανά onboarding και η επανάληψη απαιτεί αποσύνδεση και επανασύνδεση του αριθμού.
Τι γίνεται αν ο ιδιοκτήτης αρνήθηκε το ιστορικό;
Δεν φτάνει τίποτα σε αυτό το πεδίο και το API βλέπει μόνο μηνύματα από τη στιγμή που συνδέθηκε ο αριθμός.
Συνεχίστε την ανάγνωση
Έτοιμοι να ξεκινήσετε;
Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.
Ξεκινήστε δωρεάν δοκιμήΕπαληθεύτηκε στις