WhatsApp user_preferences webhook: όταν ένας πελάτης σταματά ή επαναφέρει τα διαφημιστικά μηνύματα
Το webhook user_preferences ενημερώνει μια επιχείρηση ότι ένας χρήστης WhatsApp σταμάτησε ή επανέφερε τα διαφημιστικά του μηνύματα μέσω της ρύθμισης «Προσφορές και ανακοινώσεις». Κάθε συμβάν περιέχει την κατηγορία marketing_messages, την τιμή stop ή resume, μια πρόταση λεπτομερειών, το wa_id και το BSUID του χρήστη, καθώς και μια χρονοσφραγίδα Unix. Τα σχόλια «Ενδιαφέρομαι» και «Δεν με ενδιαφέρει» στην ίδια ρύθμιση δεν το ενεργοποιούν.
Το easyCoexistence συνδέει τον αριθμό της εφαρμογής WhatsApp Business σας με το Cloud API της Meta μέσω του Coexistence, ώστε η τεχνητή νοημοσύνη και οι αυτοματισμοί σας να λειτουργούν στον αριθμό που κρατάτε στην εφαρμογή.
Τιμές που μπορεί να πάρει μια προτίμηση: stop και resume, και τα δύο στην κατηγορία marketing_messages.
Ο κωδικός κατάστασης failed για πρότυπο μάρκετινγκ που στάλθηκε σε χρήστη που σταμάτησε τα διαφημιστικά σας μηνύματα.
Πού στέλνει η Meta το user_preferences: δεν είναι πεδίο που μπορεί να παρακάμψει ένας λογαριασμός WhatsApp Business ή ένας αριθμός.
Η άδεια που χρειάζεται μια εφαρμογή για τα webhooks εκτός των messages και calls, συμπεριλαμβανομένου του user_preferences.
Τι ενεργοποιεί το webhook user_preferences;
Ένας πελάτης που ανοίγει τις «Προσφορές και ανακοινώσεις» στο WhatsApp και επιλέγει να σταματήσει ή αργότερα να επαναφέρει τα διαφημιστικά μηνύματα της επιχείρησής σας. Αυτές οι δύο ενέργειες είναι τα μόνα ενεργοποιητικά. Η ίδια ρύθμιση επιτρέπει στον πελάτη να σημειώσει «Ενδιαφέρομαι» ή «Δεν με ενδιαφέρει». Αυτή η ανατροφοδότηση δεν στέλνει webhook, αν και το «Δεν με ενδιαφέρει» μπορεί να μειώσει το όριο διαφημιστικών μηνυμάτων ανά χρήστη μεταξύ σας και του πελάτη, και ανοίγει δεύτερη οθόνη που προσφέρει διακοπή όλων των διαφημιστικών μηνυμάτων. Μόνο αν πατήσει στη συνέχεια διακοπή, ενεργοποιείται το user_preferences.
Τι περιέχει το payload;
Ένας πίνακας user_preferences δίπλα σε έναν πίνακα contacts, κάτω από το όνομα πεδίου user_preferences. Η χρονοσφραγίδα εδώ είναι ακέραιος αριθμός, ενώ τα webhooks κατάστασης την στέλνουν ως συμβολοσειρά. Το wa_id παραλείπεται όταν ο πελάτης χρησιμοποιεί όνομα χρήστη και ο αριθμός τηλεφώνου του δεν μπορεί να κοινοποιηθεί. Το user_id παραλείπεται όταν τα user IDs περιορισμένα στην επιχείρηση δεν είναι ενεργοποιημένα για την επιχείρησή σας, και το parent_user_id παραλείπεται εκτός αν τα γονικά BSUID είναι ενεργά. Ακολουθεί το παράδειγμα της Meta για επαναφορά:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"contacts": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824"
}
],
"user_preferences": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824",
"detail": "User requested to resume marketing messages",
"category": "marketing_messages",
"value": "resume",
"timestamp": 1731705721
}
]
},
"field": "user_preferences"
}
]
}
]
}Τι πρέπει να κάνει το σύστημά σας με μια διακοπή;
Καταγράψτε τη διακοπή στον πελάτη και κρατήστε τον εκτός κάθε αποστολής διαφημιστικών μέχρι να φτάσει επαναφορά. Το πεδίο detail γράφει είτε «User requested to stop marketing messages» είτε «User requested to resume marketing messages», αλλά η τιμή value είναι αυτή που πρέπει να διαβάζει ο κώδικας.
- Αποθηκεύστε την προτίμηση κατά BSUID και κατά αριθμό τηλεφώνου, αφού ένα από τα δύο μπορεί να λείπει σε κάποιο συμβάν.
- Εξαιρέστε τον πελάτη από τις αποστολές προτύπων μάρκετινγκ. Η Meta θα τις απέρριπτε ούτως ή άλλως με το 131050.
- Εφαρμόστε την προτίμηση μόνο ανά πελάτη: η Meta δεν εφαρμόζει ποτέ προτίμηση σε επίπεδο γονικού BSUID.
- Με την επαναφορά, άρετε τον αποκλεισμό και κρατήστε το δικό σας αρχείο συναίνεσης, όπως απαιτεί η πολιτική συναίνεσης της Meta.
Τι γίνεται αν το user_preferences δεν φτάσει ποτέ στον server σας;
Η Meta εφαρμόζει τη διακοπή ούτως ή άλλως, οπότε ένα χαμένο webhook σας κοστίζει μια αποτυχημένη αποστολή, όχι παραβίαση πολιτικής. Όταν στέλνετε πρότυπο μάρκετινγκ σε κάποιον που σταμάτησε, το API δέχεται το αίτημα, δεν στέλνει το μήνυμα και ενεργοποιεί webhook κατάστασης με status failed, code 131050 και τον τίτλο «Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business». Αντιμετωπίστε αυτή την αποτυχία ακριβώς όπως ένα συμβάν διακοπής: καταγράψτε την και αναστείλτε περαιτέρω αποστολές μάρκετινγκ προς αυτόν τον πελάτη.
Πώς λειτουργεί αυτό σε αριθμό συνδεδεμένο μέσω του easyCoexistence;
Το user_preferences δεν είναι ένα από τα πεδία για τα οποία η Meta επιτρέπει παράκαμψη προορισμού, οπότε η Meta το παραδίδει μόνο στο προεπιλεγμένο callback της εφαρμογής που εγγράφηκε στον λογαριασμό. Για αριθμό συνδεδεμένο μέσω του easyCoexistence, αυτή η εφαρμογή είναι του easyCoexistence, και σήμερα δεν εγγράφεται στο user_preferences. Γι' αυτό το συμβάν δεν φτάνει ούτε σε άμεσο προορισμό ούτε σε Forward URL. Η κατάσταση αποτυχίας 131050 φτάνει, επειδή ταξιδεύει στο πεδίο messages.
Αν η τεχνητή νοημοσύνη σας στέλνει πρότυπα μάρκετινγκ μέσω του send_template, κρατήστε τη λίστα διακοπών στο δικό σας σύστημα και ελέγξτε την πρώτα: το easyCoexistence δεν κρατά τέτοια λίστα.
Συνηθισμένα λάθη
- Η αντιμετώπιση του «Δεν με ενδιαφέρει» ως διακοπής. Δεν στέλνει webhook και δεν σταματά την παράδοση, αν και μπορεί να μειώσει το όριο διαφημιστικών μηνυμάτων ανά χρήστη για τον πελάτη.
- Η αποθήκευση προτιμήσεων μόνο με βάση το wa_id. Παραλείπεται για πελάτες με όνομα χρήστη του οποίου ο αριθμός δεν μπορεί να κοινοποιηθεί. Αποθηκεύστε και το BSUID.
- Η εφαρμογή μιας διακοπής σε όλους τους χρήστες κάτω από ένα γονικό BSUID. Η Meta εφαρμόζει τις προτιμήσεις ανά χρήστη, ποτέ σε γονικό επίπεδο.
- Η επανάληψη μετά το 131050 αντί για καταγραφή ως διακοπής. Κάθε επανάληψη αποτυγχάνει με τον ίδιο τρόπο.
Τα πρότυπα μάρκετινγκ που στέλνονται μέσω αυτού φεύγουν από τον δικό σας λογαριασμό WhatsApp Business, και οι αποτυχημένες καταστάσεις που αναφέρουν πελάτη που σταμάτησε φτάνουν στον server σας είτε απευθείας είτε ως υπογεγραμμένες προωθήσεις. US$ 9 έως US$ 0.75 ανά αριθμό τον μήνα, με τη μείωση να έρχεται όσο προσθέτετε αριθμούς, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Η διακοπή μπλοκάρει και τις απαντήσεις στα δικά του μηνύματα του πελάτη;
Η τεκμηρίωση της Meta περιγράφει τη διακοπή ως κάλυψη των διαφημιστικών μηνυμάτων, και το σφάλμα που επιστρέφει αναφέρεται ρητά σε διαφημιστικά μηνύματα. Οι απαντήσεις σε πελάτη που σας έγραψε είναι μηνύματα υπηρεσίας, δηλαδή άλλη κατηγορία.
Το μπλοκάρισμα της επιχείρησης ενεργοποιεί το user_preferences;
Όχι. Το webhook ενεργοποιείται μόνο με διακοπή και επαναφορά στη ρύθμιση «Προσφορές και ανακοινώσεις». Το μπλοκάρισμα είναι ξεχωριστή ενέργεια και δεν αναφέρεται σε αυτό το πεδίο.
Η επαναφορά μετράει ως συναίνεση;
Σημαίνει ότι ο πελάτης επέλεξε να λαμβάνει ξανά τα διαφημιστικά σας μηνύματα. Οι δικές σας υποχρεώσεις συναίνεσης βάσει της πολιτικής της Meta ισχύουν, οπότε κρατήστε το αρχείο του πώς και πότε ο πελάτης συμφώνησε να ακούει από εσάς.
Σε ποιο πεδίο webhook κάνω εγγραφή;
Στο user_preferences, στο App Dashboard κάτω από WhatsApp > Configuration, στην εφαρμογή που είναι εγγεγραμμένη στον λογαριασμό WhatsApp Business. Είναι ξεχωριστό πεδίο από το messages και χρειάζεται το whatsapp_business_management.
Συνεχίστε την ανάγνωση
Έτοιμοι να ξεκινήσετε;
Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.
Ξεκινήστε δωρεάν δοκιμήΕπαληθεύτηκε στις