WhatsApp webhooks: δρομολόγηση μηνυμάτων απευθείας στον server σας
Ένα WhatsApp webhook είναι ένα HTTPS endpoint που ορίζετε, και η Meta δημοσιεύει σε αυτό συμβάντα: εισερχόμενα μηνύματα, καταστάσεις παράδοσης, αλλαγές ποιότητας και ενημερώσεις λογαριασμού. Σε έναν αριθμό Coexistence, ο προορισμός μπορεί να οριστεί στον δικό σας server, ώστε οι συνομιλίες να μην περνούν ποτέ από πάροχο.
- Η Meta δημοσιεύει τα συμβάντα απευθείας στο URL σας
- Το δικό σας endpoint, όχι η πλατφόρμα παρόχου
- Μία παράκαμψη ανά WhatsApp Business Account
Καμία χρέωση για 7 ημέρες. Ακυρώστε οποιαδήποτε στιγμή.
Τι είναι συνολικά η ενσωμάτωση: ένας προορισμός HTTPS ανά λογαριασμό.
messages και smb_message_echoes, τα συμβάντα της διαδρομής μηνυμάτων που δρομολογούνται σε εσάς.
Η τιμή που στέλνει η Meta στη χειραψία GET και πρέπει να επιστρέψει το endpoint σας.
Τι στέλνει πραγματικά η Meta σε ένα webhook;
Συμβάντα, οργανωμένα σε κατηγορίες, και η διάκρισή τους καθορίζει την αρχιτεκτονική σας.
Η διαδρομή μηνυμάτων μεταφέρει όσα στέλνουν οι πελάτες και, σε έναν αριθμό Coexistence, αντίγραφα όσων στέλνει η ομάδα σας από την εφαρμογή WhatsApp Business. Αυτά είναι τα πεδία messages και smb_message_echoes και περιέχουν το περιεχόμενο των συνομιλιών.
Η λειτουργική διαδρομή μεταφέρει όλα τα υπόλοιπα: account_update όταν αλλάζει η κατάσταση σύνδεσης, phone_number_quality_update όταν αλλάζει η ποιότητα ή η απόδοση, account_alerts, account_review_update, business_capability_update και phone_number_name_update. Αυτά δεν περιέχουν περιεχόμενο συνομιλιών και αποτελούν τη βάση της παρακολούθησης.
Ένας πάροχος που τοποθετείται στη διαδρομή μηνυμάτων λαμβάνει την πρώτη ομάδα. Όποιος δεν το κάνει, δεν τη λαμβάνει.
Πώς επαληθεύει η Meta ένα endpoint;
Με ένα αίτημα GET πριν παραδώσει οτιδήποτε. Η αποτυχία σε αυτό είναι ο συχνότερος λόγος για τον οποίο μια ρύθμιση που φαίνεται ολοκληρωμένη δεν λαμβάνει ποτέ μήνυμα.
Η Meta καλεί το URL σας με το hub.mode ορισμένο σε subscribe, το hub.verify_token σας και μια τιμή hub.challenge. Το endpoint σας πρέπει να επιστρέψει αυτή την τιμή challenge ως ακατέργαστο σώμα απόκρισης, όχι μέσα σε JSON και χωρίς καμία προσθήκη. Αν δεν το κάνει, η Meta δεν αρχίζει ποτέ την παράδοση και κανένα dashboard δεν θα το αναφέρει.
Το endpoint πρέπει επίσης να είναι HTTPS. Ένα endpoint που επιστρέφει σιωπηλό 404 ή βρίσκεται πίσω από επίπεδο επαλήθευσης που απορρίπτει τη Meta φαίνεται ίδιο με μια λειτουργική ρύθμιση, μέχρι να μην φτάσει ποτέ το πρώτο μήνυμα.
Μπορεί ο προορισμός να δείχνει στον δικό σας server;
Ναι, και εδώ διαφέρουν οι πάροχοι.
Η Meta επιτρέπει σε μια εφαρμογή να παρακάμπτει το σημείο όπου παραδίδει τα webhooks ενός συγκεκριμένου WhatsApp Business Account. Ορίζουμε αυτή την παράκαμψη στο URL σας, μεταφέροντας τα συμβάντα της διαδρομής μηνυμάτων από το callback μας σε εσάς. Κρατάμε τα λειτουργικά συμβάντα, επειδή από αυτά αποτελούνται το dashboard και οι ειδοποιήσεις.
Η συνέπεια αφορά την αρχιτεκτονική και όχι κάποια πολιτική που δημοσιεύουμε. Το περιεχόμενο των συνομιλιών δεν μπορεί να αποθηκευτεί από εμάς, επειδή δεν μας παραδίδεται ποτέ. Ένας λογαριασμός χωρίς ενεργή παράκαμψη επιστρέφει στο προεπιλεγμένο callback μας, όπου ο handler απορρίπτει αυτά τα συμβάντα χωρίς να τα αποθηκεύει.
Τι συμβαίνει στον προορισμό όταν ένας αριθμός επανασυνδέεται;
Αφαιρείται, και αυτή είναι η αστοχία που σχεδόν κανείς δεν προβλέπει.
Ο προορισμός δεν αποτελεί ιδιότητα του αριθμού τηλεφώνου. Είναι παράκαμψη στη συνδρομή της εφαρμογής μας στο WhatsApp Business Account. Όταν αφαιρείται μια σύνδεση, είτε λόγω του κανόνα αδράνειας των δεκατεσσάρων ημερών της Meta είτε για άλλο λόγο, η εφαρμογή απεγκαθίσταται από τον λογαριασμό και μαζί της αφαιρείται η παράκαμψη.
Η επανασύνδεση αποκαθιστά την αποστολή και την παρακολούθηση. Δεν αποκαθιστά την παράδοση στον server σας και κανένα σύστημα δεν αναφέρει σφάλμα, οπότε η πρώτη ένδειξη είναι ένας πελάτης που λέει ότι κανείς δεν απάντησε. Εφαρμόζουμε ξανά την παράκαμψη σε κάθε επανασύνδεση, επειδή αυτό συνέβη σε πραγματικό αριθμό που επανασυνδέθηκε κανονικά και έμεινε σιωπηλός.
Συνηθισμένα λάθη
- Επιστροφή JSON από το GET επαλήθευσης. Η Meta θέλει την ακατέργαστη τιμή hub.challenge και τίποτε άλλο.
- Χρήση προσωρινού ή δοκιμαστικού URL. Η Meta συνεχίζει να παραδίδει σε αυτό αφού το εργαλείο που το δημιούργησε σταματήσει να ακούει.
- Υπόθεση ότι ο προορισμός διατηρείται μετά την επανασύνδεση. Ανήκει σε συνδρομή εφαρμογής και απεγκαθίσταται μαζί της.
- Τοποθέτηση του endpoint πίσω από επαλήθευση που απορρίπτει το αίτημα της Meta.
Το EasyCoexistence ορίζει την παράκαμψη webhook στο endpoint σας, το επαληθεύει πριν από την κλήση και την εφαρμόζει ξανά αυτόματα μετά από κάθε επανασύνδεση. Από US$ 9 ανά αριθμό τον μήνα, έως US$ 2 σε μεγάλο όγκο, με τις πρώτες 7 ημέρες δωρεάν.
Συχνές ερωτήσεις
Περνούν τα μηνύματά μου από το EasyCoexistence;
Όχι. Η παράκαμψη στέλνει τα συμβάντα της διαδρομής μηνυμάτων από τη Meta απευθείας στο endpoint σας. Τα συμβάντα λογαριασμού χωρίς παράκαμψη επιστρέφουν στο callback μας και απορρίπτονται χωρίς αποθήκευση.
Μπορώ να αλλάξω αργότερα τον προορισμό;
Ναι, οποιαδήποτε στιγμή, από το dashboard ή μέσω του MCP connector. Η μεταβίβαση null τον επαναφέρει στον προεπιλεγμένο προορισμό μας.
Τι γίνεται αν ο server μου είναι εκτός λειτουργίας όταν παραδίδει η Meta;
Η Meta επαναλαμβάνει την παράδοση για ένα διάστημα και μετά σταματά. Τα μηνύματα συνεχίζουν να φτάνουν στην εφαρμογή WhatsApp Business του τηλεφώνου, οπότε η επιχείρηση δεν χάνει τίποτα, ακόμη κι αν αποτύχει η ενσωμάτωση.
Αρκεί ένα webhook για πολλούς αριθμούς;
Ναι. Κατευθύνετε κάθε αριθμό στο ίδιο endpoint και διακρίνετε τα αιτήματα με βάση το phone number id που λαμβάνετε στο payload.
Συνεχίστε την ανάγνωση
Έτοιμοι να ξεκινήσετε;
Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.
Ξεκινήστε δωρεάν δοκιμήΚαμία χρέωση για 7 ημέρες. Ακυρώστε οποιαδήποτε στιγμή.Επαληθεύτηκε στις