Χρησιμοποιήστε έναν αριθμό Coexistence ως inbox WhatsApp Cloud στο Chatwoot

Πώς συνδέετε έναν αριθμό Coexistence στο Chatwoot;

Σε δύο σημεία, με αυτή τη σειρά.

Στο Chatwoot, προσθέστε ένα inbox, επιλέξτε WhatsApp και διαλέξτε τον πάροχο WhatsApp Cloud με τη χειροκίνητη ρύθμιση. Συμπληρώστε τον αριθμό, το phone number id, το id του WhatsApp Business Account και το access token. Όλα αυτά τα εμφανίζει το dashboard του EasyCoexistence για τη σύνδεση, ή τα επιστρέφει το get_api_credentials σε έναν βοηθό. Στη συνέχεια το Chatwoot δείχνει ένα webhook URL και ένα webhook verify token για το inbox.

Στο EasyCoexistence, ορίστε ως προορισμό webhook του αριθμού αυτό το URL και συμπληρώστε το ίδιο verify token. Η Meta στέλνει το αίτημα επαλήθευσης στο Chatwoot, το Chatwoot το απαντά, και από εκείνη τη στιγμή κάθε μήνυμα προς τον αριθμό φτάνει στο inbox. Τίποτα δεν τρέχει ενδιάμεσα, άρα δεν υπάρχει workflow που πρέπει να διατηρείτε ενεργό.

Εμφανίζονται στο Chatwoot οι απαντήσεις που στέλνονται από το κινητό;

Ναι. Σε έναν αριθμό Coexistence, μια απάντηση που πληκτρολογείται στην εφαρμογή WhatsApp Business αναφέρεται από τη Meta ως συμβάν smb_message_echoes, και η εργασία webhook του Chatwoot αναγνωρίζει αυτό το πεδίο και καταγράφει το μήνυμα ως εξερχόμενο στη σωστή συνομιλία. Ο πηγαίος κώδικάς του περιγράφει άμεσα την περίπτωση: επιχειρήσεις που απαντούν και από το Chatwoot και από την εφαρμογή, με τα μηνύματα να συγχρονίζονται στο Chatwoot.

Έτσι ο καταμερισμός δουλεύει στην πράξη. Ο ιδιοκτήτης μπορεί να συνεχίσει να απαντά στους τακτικούς πελάτες από το κινητό, η ομάδα να δουλεύει το κοινό inbox από το γραφείο, και ο καθένας βλέπει τι έστειλε ο άλλος χωρίς να χρειάζεται κανείς να προωθεί στιγμιότυπα οθόνης.

Τα μηνύματα που στέλνονται από το Chatwoot φεύγουν μέσω του Cloud API στον ίδιο αριθμό, οπότε εμφανίζονται και στο κινητό.

Γιατί το inbox του Chatwoot δεν πρέπει να έχει app secret;

Επειδή οι παραδόσεις υπογράφονται με ένα secret που δεν έχετε. Η Meta υπογράφει κάθε webhook με το app secret της εφαρμογής που κατέχει τη συνδρομή, δηλαδή της εφαρμογής του EasyCoexistence, και αυτό το secret δεν κοινοποιείται ποτέ.

Στον τρέχοντα κώδικα του Chatwoot, η κεφαλίδα X-Hub-Signature-256 ελέγχεται σε χειροκίνητα ρυθμισμένο κανάλι WhatsApp Cloud μόνο όταν έχει αποθηκευτεί σε αυτό app secret, ή όταν το κανάλι δημιουργήθηκε μέσω του δικού του embedded signup του Chatwoot. Ένα χειροκίνητο inbox χωρίς app secret δέχεται τις παραδόσεις· ένα με οποιοδήποτε app secret τις απορρίπτει όλες ως μη εξουσιοδοτημένες.

Η προστασία που ισχύει εδώ είναι το verify token. Διαλέξτε μια μεγάλη τυχαία τιμή, γιατί είναι αυτή που επιτρέπει στο Chatwoot να ξεχωρίζει το αίτημα επαλήθευσης της Meta από οποιοδήποτε άλλο.

Τι δεν μπορεί να κάνει το Chatwoot σε αυτόν τον αριθμό;

Να λαμβάνει webhooks ταυτόχρονα και σε δεύτερο σημείο. Η Meta δρομολογεί τα webhooks ενός αριθμού σε έναν μόνο προορισμό, οπότε όσο τον κατέχει το Chatwoot, ένα workflow του n8n δεν θα λαμβάνει τα ίδια συμβάντα. Αν χρειάζεστε και τα δύο, στρέψτε τον προορισμό σε έναν μικρό δικό σας relay που προωθεί κάθε παράδοση στο Chatwoot και στο workflow.

Οι περιορισμοί του Coexistence ισχύουν όπως παντού: το API στέλνει έως και 20 μηνύματα ανά δευτερόλεπτο, το ελεύθερο κείμενο φεύγει μόνο εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη, και μετά από αυτό τα templates καλύπτουν τα υπόλοιπα.

Η εφαρμογή WhatsApp Business χρειάζεται και πάλι να ανοίγει τουλάχιστον μία φορά κάθε 14 ημέρες, κάτι που το EasyCoexistence παρακολουθεί.

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

• Συμπλήρωση app secret στο inbox του Chatwoot. Οι παραδόσεις υπογράφονται με το secret της εφαρμογής του EasyCoexistence, γι' αυτό το Chatwoot τις απορρίπτει όλες ως μη εξουσιοδοτημένες.
• Χρήση διαφορετικού verify token στο EasyCoexistence από αυτό που δείχνει το Chatwoot. Η επαλήθευση της Meta αποτυγχάνει και το inbox δεν λαμβάνει ποτέ κανένα μήνυμα.
• Επιλογή του embedded signup του Chatwoot αντί για τη χειροκίνητη ροή. Αυτό συνδέει τον αριθμό μέσω της δικής του εφαρμογής Meta του Chatwoot, δηλαδή μιας ξεχωριστής σύνδεσης.

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

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