Πεδία webhook του WhatsApp και η δρομολόγησή τους

Τι μεταφέρει κάθε πεδίο;

Το messages μεταφέρει ό,τι στέλνει ένας πελάτης στον αριθμό: κείμενο, αναφορές σε media, απαντήσεις και reactions. Το smb_message_echoes μεταφέρει ό,τι στέλνει η ομάδα σας από την εφαρμογή WhatsApp Business. Υπάρχει μόνο σε αριθμό Coexistence και επιτρέπει στο λογισμικό να βλέπει τις απαντήσεις ανθρώπων.

Το account_update μεταφέρει την κατάσταση της σύνδεσης: PARTNER_REMOVED όταν η εφαρμογή απεγκαθίσταται από τον λογαριασμό, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED και events περιορισμού ή παραβίασης. Το phone_number_quality_update μεταφέρει αλλαγές στην αξιολόγηση ποιότητας και στη χωρητικότητα αποστολής. Το account_alerts μεταφέρει ειδοποιήσεις που δημιουργεί η Meta για τον λογαριασμό, ενώ το account_review_update μεταφέρει το αποτέλεσμα ενός ελέγχου.

Το business_capability_update μεταφέρει αλλαγές στα όρια και στις δυνατότητες ανταλλαγής μηνυμάτων, ενώ το phone_number_name_update μεταφέρει εγκρίσεις και απορρίψεις του εμφανιζόμενου ονόματος.

Γιατί έχει αρχιτεκτονική σημασία ο διαχωρισμός;

Επειδή καθορίζει αν το περιεχόμενο των συνομιλιών θα φτάσει ποτέ σε πάροχο.

Η παράκαμψη στέλνει τα δύο πεδία μηνυμάτων απευθείας από τη Meta στο endpoint σας. Τα έξι επιχειρησιακά πεδία συνεχίζουν προς τον πάροχο, κάτι που επιτρέπει τη λειτουργία dashboard και ειδοποιήσεων χωρίς κανείς να έχει στην κατοχή του μήνυμα.

Γι’ αυτό και η δήλωση ότι δεν αποθηκεύουμε μηνύματα μπορεί να είναι δομική και όχι απλώς πολιτική. Αν τα πεδία μηνυμάτων παραδίδονται αλλού, δεν υπάρχει διαδρομή κώδικα στην οποία θα μπορούσαν να αποθηκευτούν. Στην περίπτωσή μας, ένας λογαριασμός χωρίς παράκαμψη επιστρέφει στο προεπιλεγμένο callback, όπου ο handler απορρίπτει αυτά τα events χωρίς να τα αποθηκεύει.

Ποια πεδία πρέπει να περιμένει ο handler σας;

Μόνο τα δύο πεδία μηνυμάτων, αν έχει οριστεί η παράκαμψη. Αξίζει ο handler να αγνοεί οτιδήποτε άλλο αντί να αποτυγχάνει.

Η Meta προσθέτει πεδία με την πάροδο του χρόνου και το σχήμα ενός payload μπορεί να αποκτήσει νέα keys χωρίς προειδοποίηση. Ένας handler που ελέγχει το όνομα του πεδίου και αγνοεί όσα δεν αναγνωρίζει συνεχίζει να λειτουργεί. Εκείνος που υποθέτει συγκεκριμένο σχήμα αποτυγχάνει στο πρώτο άγνωστο event.

Αξίζει επίσης να διαχειρίζεστε ρητά το smb_message_echoes αντί να το θεωρείτε θόρυβο. Χωρίς αυτό, το λογισμικό δεν γνωρίζει ότι ένας άνθρωπος έχει ήδη απαντήσει, με αποτέλεσμα ένας πελάτης να λαμβάνει δύο απαντήσεις στην ίδια ερώτηση.

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

• Να θεωρείτε ότι υπάρχει ένα γενικό payload. Κάθε event δηλώνει το πεδίο του και ο handler πρέπει να κάνει έλεγχο βάσει αυτού.
• Να αγνοείτε το smb_message_echoes. Χωρίς αυτό, το λογισμικό απαντά πάνω από έναν άνθρωπο που έχει ήδη απαντήσει.
• Να αποτυγχάνετε σε άγνωστα πεδία αντί να τα παρακάμπτετε. Η Meta προσθέτει πεδία χωρίς προειδοποίηση.

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

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