Γιατί ένα μήνυμα WhatsApp απέτυχε: ανάγνωση της κατάστασης failed και των σφαλμάτων
Το webhook αποτυχίας σημαίνει ότι η Meta δεν μπόρεσε να στείλει ή να παραδώσει ένα μήνυμα που έστειλε η επιχείρηση μέσω του API. Φτάνει στο πεδίο messages με τιμή failed στο πεδίο status και έναν πίνακα errors που περιέχει code, title, message, error_data.details και href. Ο κωδικός δείχνει την αιτία: 131047 κλειστό παράθυρο 24 ωρών, 131026 μη παραδοτέο, 131049 όριο μάρκετινγκ, 131050 διακοπή μάρκετινγκ, 131042 πρόβλημα πληρωμής.
Το easyCoexistence συνδέει τον αριθμό σας της εφαρμογής WhatsApp Business με το Cloud API της Meta μέσω Coexistence και περνά τις καταστάσεις failed στον server σας, απευθείας ή ως υπογεγραμμένα forwards όταν οι αυτοματισμοί είναι ενεργοί.
Έχουν περάσει περισσότερες από 24 ώρες από την τελευταία απάντηση του παραλήπτη· η λύση της Meta είναι να στείλετε πρότυπο μηνύματος.
Δεν παραδόθηκε, για να διατηρηθεί υγιής η δραστηριότητα του οικοσυστήματος· περιμένετε τουλάχιστον 24 ώρες πριν ξαναστείλετε το πρότυπο μάρκετινγκ.
Ο παραλήπτης επέλεξε να σταματήσει τα μηνύματα μάρκετινγκ από την επιχείρηση· η Meta λέει να μην επαναληφθεί η αποστολή.
Η κατάσταση failed δεν περιλαμβάνει τον πίνακα contacts· συσχετίστε την αποτυχία μέσω του statuses.id.
Η Meta χρεώνει μηνύματα όταν παραδίδονται, όχι όταν στέλνονται.
Πώς μοιάζει μια κατάσταση failed;
Όπως κάθε κατάσταση, με επιπλέον errors. Ο πίνακας contacts λείπει, το recipient_user_id παραλείπεται όταν το μήνυμα στάλθηκε σε αριθμό τηλεφώνου, και δεν υπάρχει αντικείμενο pricing. Τα title και message περιέχουν το ίδιο κείμενο, το error_data.details το εξηγεί σε μία πρόταση, και το href δείχνει στη λίστα κωδικών σφαλμάτων της Meta. Αυτό είναι παράδειγμα της ίδιας της Meta: ένα πρότυπο μάρκετινγκ που σταμάτησε από το όριο ανά χρήστη:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"statuses": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0QUQ2MjA4NEYyRkExNjMyREUA",
"status": "failed",
"timestamp": "1751142888",
"recipient_id": "16505551234",
"errors": [
{
"code": 131049,
"title": "This message was not delivered to maintain healthy ecosystem engagement.",
"message": "This message was not delivered to maintain healthy ecosystem engagement.",
"error_data": {
"details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
},
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
}
]
}
]
},
"field": "messages"
}
]
}
]
}Ποιοι κωδικοί σφάλματος επιστρέφουν πιο συχνά και τι σημαίνουν;
Η Meta επιστρέφει σφάλματα στην απάντηση αποστολής, σε μια κατάσταση failed, ή και στις δύο, οπότε ο ίδιος κωδικός μπορεί να φτάσει με οποιονδήποτε τρόπο και ο χειριστής σας πρέπει να διαβάζει και τα δύο σημεία. Αυτοί είναι οι κωδικοί που εξηγούν τα περισσότερα μηνύματα που δεν φτάνουν, με την αιτιολογία της Meta και το πρώτο πράγμα που πρέπει να δοκιμάσετε· η πλήρης λίστα βρίσκεται στην αναφορά κωδικών σφαλμάτων της Meta:
Πώς πρέπει να αντιδρά ο χειριστής σε κάθε είδος αποτυχίας;
Ταξινομήστε τον κωδικό ως προς το επόμενο βήμα πριν γίνει οποιαδήποτε επανάληψη. Μια γενική επανάληψη μετατρέπει μια διακοπή μάρκετινγκ σε επαναλαμβανόμενες αποτυχίες και μπορεί να παρατείνει τον αποκλεισμό, ενώ η απόρριψη ενός προσωρινού σφάλματος χάνει ένα μήνυμα που θα είχε περάσει ένα λεπτό αργότερα.
- Επανάληψη με backoff: 131000 άγνωστο, 131016 μη διαθέσιμη υπηρεσία, 130429 επίτευξη μέγιστου ρυθμού αποστολής.
- Πρώτα αναμονή: 131049, τουλάχιστον 24 ώρες, γιατί οι πρόωρες επαναλήψεις μπορούν να αποκλείσουν αυτόν τον χρήστη για έως 24 ώρες επιπλέον.
- Αλλαγή μηνύματος: 131047 χρειάζεται εγκεκριμένο πρότυπο, επειδή το παράθυρο 24 ωρών είναι κλειστό.
- Διακοπή για αυτόν τον πελάτη: 131050, έως ότου φτάσει ένα
user_preferencesresume. - Διόρθωση λογαριασμού ή περιεχομένου: 131042 πληρωμή, 131031 περιορισμένος λογαριασμός, 131053 πολυμέσα.
Ποιες αποτυχίες εμφανίζονται μόνο ως κατάσταση failed;
Εκείνες που αποφασίζει η Meta αφού έχει δεχτεί το αίτημα. Η αποστολή επιστρέφει ένα wamid, και η άρνηση έρχεται αργότερα σε αυτό το webhook. Η Meta δεν παραδίδει πρότυπα μάρκετινγκ σε χρήστες WhatsApp με αριθμούς των Ηνωμένων Πολιτειών (+1 με κωδικό περιοχής ΗΠΑ), ένα πρότυπο μάρκετινγκ προς πελάτη που σταμάτησε τα μηνύματα μάρκετινγκ υποβάλλεται σε επεξεργασία και στη συνέχεια αναφέρεται ως failed με 131050, και το όριο ανά χρήστη αναφέρει 131049 με τον ίδιο τρόπο.
Αν ο αριθμός δεν έχει προορισμό webhook, αυτές οι αποτυχίες δεν εμφανίζονται πουθενά που να μπορείτε να δείτε, και το μήνυμα απλώς φαίνεται σταλμένο. Για την πλήρη σειρά ελέγχων όταν ένας πελάτης δεν έλαβε τίποτα, δείτε τη σελίδα για τα μηνύματα WhatsApp API που δεν παραδόθηκαν.
Τι αλλάζει σε αριθμό Coexistence;
Δύο πράγματα έχουν σημασία. Πρώτον, το παράθυρο 24 ωρών δεσμεύει μόνο το API. Ο οδηγός Coexistence της Meta λέει ότι τα μηνύματα που στέλνονται από την εφαρμογή WhatsApp Business δεν υπόκεινται στο παράθυρο εξυπηρέτησης πελατών, οπότε μετά από 131047 ο ιδιοκτήτης μπορεί ακόμα να απαντήσει σε αυτόν τον πελάτη από το τηλέφωνο, ενώ το σύστημά σας στέλνει εγκεκριμένο πρότυπο.
Δεύτερον, ο ρυθμός αποστολής είναι σταθερός. Ένας αριθμός που χρησιμοποιείται ταυτόχρονα στην εφαρμογή και στο API στέλνει το πολύ 20 μηνύματα το δευτερόλεπτο, και αν ξεπεραστεί αυτό επιστρέφεται 130429. Όλα τα υπόλοιπα διαβάζονται ακριβώς όπως σε κάθε αριθμό Cloud API: το ίδιο πεδίο, ο ίδιος πίνακας errors, οι ίδιοι κωδικοί.
Πώς βλέπουν οι αυτοματισμοί και η AI σας μια αποτυχία;
Εξαρτάται από το πότε η Meta λέει όχι. Μια άρνηση τη στιγμή της αποστολής, όπως το 131047, αποτυγχάνει το βήμα του αυτοματισμού: η εκτέλεση εμφανίζει Failed με το μήνυμα της Meta στην καρτέλα Runs, και ο ιδιοκτήτης λαμβάνει email ώστε να απαντήσει ο ίδιος στον πελάτη. Οι αυτοματισμοί ελέγχουν επίσης το παράθυρο πριν στείλουν ελεύθερο κείμενο και παραλείπουν με window_closed αντί να προσπαθήσουν.
Μια αποτυχία που αναφέρει η Meta αργότερα φτάνει ως κατάσταση failed στο Forward URL σας ή στον άμεσο προορισμό, και η εκτέλεση μένει όπως ήταν. Ένα AI που έστειλε πρότυπο μέσω του συνδέσμου MCP βλέπει το wamid και το "sent: true"· ζητήστε από το σύστημά σας την κατάσταση αυτού του wamid, ή ζητήστε από τον βοηθό να εκτελέσει το get_number_health όταν αποτυγχάνουν πολλά μηνύματα ταυτόχρονα.
Συνηθισμένα λάθη
- Επανάληψη του 131050 σε βρόχο. Ο πελάτης σταμάτησε τα μηνύματα μάρκετινγκ, οπότε κάθε προσπάθεια αποτυγχάνει με τον ίδιο τρόπο μέχρι να τα ξαναενεργοποιήσει.
- Επαναποστολή προτύπου μάρκετινγκ με 131049 μέσα σε λίγες ώρες. Η Meta ζητά τουλάχιστον 24 ώρες, και οι πρόωρες επαναλήψεις μπορούν να αποκλείσουν αυτόν τον χρήστη για έως 24 ώρες επιπλέον.
- Καταγραφή μόνο του title. Το error_data.details φέρει τη συγκεκριμένη αιτία, οπότε αποθηκεύστε τον κωδικό και τις λεπτομέρειες μαζί με το wamid.
- Λειτουργία χωρίς προορισμό webhook και κρίση της παράδοσης από την απάντηση αποστολής, η οποία μόνο λέει ότι η Meta δέχτηκε το μήνυμα.
Όταν η απάντηση ενός αυτοματισμού απορρίπτεται τη στιγμή της αποστολής, η εκτέλεση εμφανίζει το σφάλμα της Meta και λαμβάνετε email, ενώ κάθε αριθμός παρακολουθείται 24/7 για αποσυνδέσεις και πτώσεις ποιότητας. Από US$ 9 μέχρι US$ 0,75 ανά αριθμό τον μήνα, με μείωση όσο προσθέτετε αριθμούς, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Χρεώνει η Meta ένα μήνυμα που απέτυχε;
Οι σελίδες τιμολόγησης της Meta λένε ότι χρεώνει μηνύματα που παραδίδονται, όχι μηνύματα που μόνο στάλθηκαν. Μια κατάσταση failed δεν περιέχει αντικείμενο pricing. Οι χρεώσεις πηγαίνουν στον δικό σας λογαριασμό WhatsApp Business, και το easyCoexistence δεν τις αυξάνει ποτέ.
Σημαίνει το 131026 ότι ο πελάτης απέκλεισε την επιχείρηση;
Η λίστα της Meta για το 131026 αναφέρει άλλες αιτίες: ο αριθμός δεν είναι στο WhatsApp, ο παραλήπτης δεν έχει αποδεχτεί τους τελευταίους όρους, ή η έκδοση WhatsApp του είναι πολύ παλιά. Η Meta προτείνει να ρωτήσετε τον πελάτη μέσω άλλου καναλιού για να τα ελέγξει.
Γιατί το recipient_user_id εμφανίζεται σε ορισμένες αποτυχίες και σε άλλες όχι;
Η Meta το παραλείπει σε μια κατάσταση failed όταν το μήνυμα στάλθηκε σε αριθμό τηλεφώνου. Όταν στείλατε στο BSUID του πελάτη, η αποτυχία το περιλαμβάνει, και μπορεί να λείπει το recipient_id.
Μπορεί ένα μήνυμα να αποτύχει αφού παραδόθηκε;
Η αναφορά της Meta περιγράφει το failed ως αποτυχία αποστολής ή παράδοσης. Αφού ένα μήνυμα φτάσει στη συσκευή, οι επόμενες καταστάσεις που μπορείτε να περιμένετε είναι read, ή played για φωνητικά μηνύματα.
Συνεχίστε την ανάγνωση
Έτοιμοι να ξεκινήσετε;
Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.
Ξεκινήστε δωρεάν δοκιμήΕπαληθεύτηκε στις