Σύνδεση ενός bot Botpress με το WhatsApp μέσω Coexistence

Ποια ρύθμιση του Botpress λειτουργεί με έναν αριθμό Coexistence;

Η Manual Configuration. Οι άλλες επιλογές συνδέουν έναν αριθμό μέσω της δικής του εφαρμογής Meta του Botpress, κάτι που είναι ξεχωριστή ένταξη του αριθμού και όχι τρόπος να χρησιμοποιήσετε έναν ήδη συνδεδεμένο.

Στην ενσωμάτωση WhatsApp, ανοίξτε το αναπτυσσόμενο μενού Configuration και επιλέξτε Manual Configuration. Ζητά ένα Verify Token, ένα Access Token, ένα Default Bot Phone Number ID και προαιρετικά ένα App ID, ένα Client Secret και ένα WABA ID.

Το access token, το phone number id και το WABA id προέρχονται από τη σύνδεση: το dashboard τα εμφανίζει και το get_api_credentials τα επιστρέφει σε έναν βοηθό. Το verify token είναι οποιαδήποτε συμβολοσειρά επιλέξετε. Τα App ID και Client Secret μένουν κενά. Ο οδηγός του Botpress παρουσιάζει το secret ως πεδίο προς συμπλήρωση, όμως ο ορισμός της ενσωμάτωσης το χαρακτηρίζει προαιρετικό και αναφέρει ότι χωρίς αυτό παραλείπεται η επαλήθευση της υπογραφής. Αυτό έχει σημασία, γιατί η Meta υπογράφει κάθε παράδοση με το app secret του Tech Provider, το οποίο δεν το κατέχει κανένας πελάτης.

Πώς λαμβάνει το webhook του Botpress τα μηνύματα της Meta;

Μέσω του προορισμού webhook του αριθμού. Ο οδηγός του Botpress σας ζητά να επικολλήσετε το webhook URL του και το verify token σας στη ρύθμιση WhatsApp μιας εφαρμογής Meta. Εδώ δεν υπάρχει δική σας εφαρμογή Meta: η Meta δρομολογεί τα γεγονότα του αριθμού στον προορισμό που ορίζει η σύνδεση. Αντιγράψτε λοιπόν το webhook URL που εμφανίζει το Botpress για την ενσωμάτωση και ορίστε το, μαζί με το ίδιο verify token, ως προορισμό στο dashboard ή με το set_webhook_destination.

Η Meta στέλνει ένα GET επαλήθευσης, το Botpress το απαντά και ξεκινά η παράδοση. Όταν το Botpress αποθηκεύει μια χειροκίνητη ρύθμιση, ελέγχει επίσης το token ρωτώντας το Graph ποια εφαρμογή το εξέδωσε, οπότε ένα άκυρο ή ανακληθέν token αποτυγχάνει κατά την αποθήκευση και όχι στο πρώτο μήνυμα.

Ο handler του Botpress επεξεργάζεται επίσης το smb_message_echoes, το γεγονός που στέλνει η Meta όταν κάποιος απαντά από την εφαρμογή WhatsApp Business. Έτσι, μια απάντηση από το κινητό είναι ορατή στο bot και δεν του μένει αόρατη.

Τι πρέπει να γνωρίζει το bot για το Coexistence;

Ότι μπορεί ήδη να μιλά κάποιος άνθρωπος. Η εφαρμογή WhatsApp Business συνεχίζει να λειτουργεί στον αριθμό, οπότε ένας πελάτης μπορεί να λάβει απάντηση από το κινητό και από το bot μέσα στο ίδιο λεπτό. Αποφασίστε στη ροή τι θα γίνεται όταν φτάνει ένα echo: οι περισσότερες ομάδες θέτουν το bot σε παύση για αυτή την επαφή για λίγη ώρα, ώστε να μη μιλά πάνω στον άνθρωπο που παρενέβη.

Το δεύτερο ζήτημα είναι ο χρόνος. Ένα bot που απαντά σε εισερχόμενα μηνύματα λειτουργεί μέσα στο παράθυρο εξυπηρέτησης πελατών των 24 ωρών, όπου επιτρέπεται το ελεύθερο κείμενο. Μια ροή που στέλνει κάτι μία μέρα αργότερα, όπως υπενθύμιση ή επανάληψη επαφής, χρειάζεται εγκεκριμένο template, και το ελεύθερο κείμενο εκεί επιστρέφει το σφάλμα 131047. Ο οδηγός του Botpress κάνει εγγραφή στα πεδία κατάστασης των template ακριβώς για αυτό το είδος προληπτικού μηνύματος.

Τέλος, η ταχύτητα διακίνησης είναι σταθερή στα 20 μηνύματα ανά δευτερόλεπτο για έναν αριθμό Coexistence, πολύ πάνω από όσα στέλνει ένα συνομιλιακό bot.

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

• Συμπλήρωση του Client Secret με το secret της δικής σας εφαρμογής Meta. Η υπογραφή δεν ταιριάζει ποτέ και το Botpress απαντά σε κάθε παράδοση με 401.
• Επιλογή του OAuth ή του sandbox αντί για Manual Configuration. Αυτές συνδέουν έναν αριθμό μέσω της δικής του εφαρμογής του Botpress και όχι αυτού που είναι ήδη συνδεδεμένος.
• Αγνόηση των echoes. Χωρίς κανόνα για τις απαντήσεις που στέλνονται από το κινητό, το bot απαντά πάνω σε έναν άνθρωπο που έχει ήδη παρέμβει.

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

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