Κωδικοί σφάλματος WhatsApp Cloud API
Αυτοί είναι όλοι οι κωδικοί σφάλματος του WhatsApp Cloud API που τεκμηριώνουμε, σε έναν πίνακα, μαζί με τη σημασία τους και το αν βοηθά η επανάληψη. Οι περισσότεροι όχι, επειδή είναι ντετερμινιστικοί. Το ίδιο αίτημα αποτυγχάνει με τον ίδιο τρόπο και ένας βρόχος επαναλήψεων μετατρέπει ένα λανθασμένο αίτημα σε όριο ρυθμού.
Το EasyCoexistence παρακολουθεί συνεχώς τη σύνδεση και καταγράφει τα συμβάντα λογαριασμού και ποιότητας της Meta στο χρονολόγιο της σύνδεσης, ώστε τα σφάλματα που προέρχονται από την κατάσταση ενός αριθμού να είναι ορατά πριν αποτύχει η αποστολή και όχι μετά.
Αίτημα
| Κωδικός | Τι σημαίνει | Επανάληψη |
|---|---|---|
| 100 | Μια παράμετρος δεν υποστηρίζεται, είναι γραμμένη λάθος ή έχει λανθασμένη μορφή. | Όχι |
| 131008 | Μια υποχρεωτική παράμετρος δεν συμπεριλήφθηκε καθόλου. | Όχι |
| 131009 | Μια παράμετρος υπάρχει, αλλά με τιμή που το endpoint απορρίπτει. | Όχι |
| 131021 | Ο αποστολέας και ο παραλήπτης είναι ο ίδιος αριθμός. | Όχι |
| 131051 | Ο τύπος μηνύματος δεν υποστηρίζεται, συχνά λόγω περιορισμού του Coexistence. | Όχι |
| 131052 | Η Meta δεν μπόρεσε να κατεβάσει πολυμέσα που έστειλε ένας πελάτης. | Όχι |
| 131053 | Η Meta δεν μπόρεσε να ανεβάσει πολυμέσα που στείλατε. Μέγεθος, μορφή ή προσβασιμότητα. | Όχι |
Template
| Κωδικός | Τι σημαίνει | Επανάληψη |
|---|---|---|
| 132000 | Ο αριθμός των παραμέτρων δεν αντιστοιχεί στο template. | Όχι |
| 132001 | Δεν υπάρχει template με αυτόν τον συνδυασμό ονόματος και γλώσσας. | Όχι |
| 132007 | Το template παραβιάζει την πολιτική μηνυμάτων. Ξαναγράψτε το και υποβάλετέ το ξανά. | Όχι |
| 132012 | Η μορφή της παραμέτρου δεν αντιστοιχεί σε αυτήν που ορίζει το template. | Όχι |
| 132015 | Το template τέθηκε σε παύση μετά από πτώση ποιότητας. Προσωρινά. | Περιμένετε |
| 132016 | Το template απενεργοποιήθηκε οριστικά. Δεν θα επανέλθει. | Όχι |
Παράθυρο και παραλήπτης
| Κωδικός | Τι σημαίνει | Επανάληψη |
|---|---|---|
| 131047 | Το 24ωρο παράθυρο εξυπηρέτησης έκλεισε. Στείλτε ένα template. | Όχι |
| 131026 | Ο παραλήπτης δεν μπορεί να λάβει καθόλου το μήνυμα. | Όχι |
| 131050 | Το άτομο έχει εξαιρεθεί. Εκ σχεδιασμού δεν υπάρχει παράκαμψη. | Όχι |
| 130497 | Η αποστολή μηνυμάτων σε αυτή τη χώρα είναι περιορισμένη για τον λογαριασμό σας. | Όχι |
Εγγραφή και PIN
| Κωδικός | Τι σημαίνει | Επανάληψη |
|---|---|---|
| 131045 | Ο αριθμός δεν εγγράφηκε ποτέ για μηνύματα μέσω Cloud API. | Όχι |
| 133010 | Ο αριθμός δεν είναι εγγεγραμμένος. Η εγγραφή πρέπει να ολοκληρωθεί. | Όχι |
| 133006 | Ο αριθμός πρέπει να επαληθευτεί πριν μπορέσει να εγγραφεί. | Όχι |
| 133005 | Το PIN επαλήθευσης δύο βημάτων ήταν λάθος. Σταματήστε να μαντεύετε. | Όχι |
| 133008 | Πάρα πολλές προσπάθειες PIN. Η εγγραφή κλειδώνει για ένα διάστημα. | Περιμένετε |
Πρόσβαση και λογαριασμός
| Κωδικός | Τι σημαίνει | Επανάληψη |
|---|---|---|
| 190 | Το token πρόσβασης έληξε ή ακυρώθηκε. | Όχι |
| 368 | Ο λογαριασμός είναι περιορισμένος μετά από παραβίαση πολιτικής. | Όχι |
| 131031 | Ο λογαριασμός είναι περιορισμένος ή τα στοιχεία του δεν ταιριάζουν με αυτά της Meta. | Όχι |
| 131042 | Ένα πρόβλημα πληρωμής στον επιχειρηματικό λογαριασμό εμποδίζει την αποστολή. | Όχι |
| 131049 | Η Meta μπλόκαρε το μήνυμα για να προστατεύσει την υγεία του οικοσυστήματος. | Όχι |
Όρια ρυθμού
| Κωδικός | Τι σημαίνει | Επανάληψη |
|---|---|---|
| 130429 | Επιτεύχθηκε το όριο throughput μηνυμάτων του λογαριασμού. | Περιμένετε |
| 131048 | Επιτεύχθηκε όριο ρυθμού για spam. Αιτία είναι η ποιότητα, όχι ο όγκος. | Όχι |
| 131056 | Πάρα πολλά μηνύματα μεταξύ του αριθμού σας και ενός παραλήπτη. | Όχι |
| 80007 | Ο λογαριασμός έφτασε το όριο κλήσεων διαχείρισης. Συνήθως λόγω polling. | Περιμένετε |
Παροδικά σφάλματα
Συγχρονισμός Coexistence
Πώς διαβάζετε τη στήλη επανάληψης
Έχει τρεις τιμές και η λανθασμένη επιλογή μεταξύ τους είναι το πιο δαπανηρό λάθος σε όλη αυτή την αναφορά.
Όχι σημαίνει ότι η αποτυχία είναι ντετερμινιστική. Αυτό που απέτυχε είναι το αίτημα, το template ή η κατάσταση του παραλήπτη, και η αποστολή του ίδιου αιτήματος ξανά παράγει το ίδιο σφάλμα, καταναλώνοντας ταυτόχρονα throughput που θα χρειαστείτε αργότερα. Ναι σημαίνει ότι η αποτυχία προήλθε από την πλευρά της Meta και μια backoff καθυστέρηση την επιλύει πραγματικά. Περιμένετε σημαίνει ότι η συνθήκη είναι υπαρκτή αλλά προσωρινή, όπως ένα όριο ή ένα κλείδωμα που αίρεται μόνο του. Η επανάληψη πριν αρθεί δεν κάνει τίποτα και μπορεί να την παρατείνει.
Γιατί οι περισσότεροι από αυτούς δεν επιδέχονται επανάληψη
Επειδή η πλατφόρμα επιστρέφει συγκεκριμένους κωδικούς αντί για γενικούς. Μια κακοσχηματισμένη παράμετρος, ένα template που δεν υπάρχει, ένα κλειστό παράθυρο μηνυμάτων και ένας παραλήπτης που έχει εξαιρεθεί είναι γνωστά τη στιγμή της απόκρισης. Γι' αυτό η Meta τα κατονομάζει αντί να αποτυγχάνει αόριστα.
- Ένα πρόβλημα στο αίτημα δεν διορθώνεται στη δεύτερη προσπάθεια.
- Ένα πρόβλημα template βρίσκεται στο ίδιο το template, το οποίο το αίτημα δεν μπορεί να αλλάξει.
- Ένα πρόβλημα παραθύρου ή εξαίρεσης αφορά την κατάσταση του παραλήπτη, όχι τη δική σας.
- Ένας περιορισμός λογαριασμού είναι απόφαση και η επανάληψη δεν αποτελεί ένσταση.
Τι να καταγράφετε όταν εμφανίζεται ένας από αυτούς
Αρκετά στοιχεία ώστε να το διαγνώσετε χωρίς αναπαραγωγή. Αυτή είναι η διαφορά ανάμεσα σε μια διόρθωση πέντε λεπτών και σε μια ολόκληρη ημέρα εικασιών.
- Ολόκληρη την απόκριση σφάλματος, μαζί με το trace id, που ζητά η υποστήριξη της Meta.
- Το σώμα του αιτήματος όπως στάλθηκε, όχι όπως το είχατε σκοπό. Η διαφορά μεταξύ των δύο είναι συνήθως το σφάλμα.
- Το phone number id, ώστε ένα πρόβλημα σε έναν αριθμό να ξεχωρίζει από ένα πρόβλημα σε ολόκληρο τον λογαριασμό.
- Η χρονική σήμανση, ώστε η αποτυχία να μπορεί να ελεγχθεί σε σχέση με την κατάσταση της σύνδεσης εκείνη τη στιγμή.
Οι κωδικοί που υπάρχουν μόνο στο Coexistence
Είναι δύο και προκαλούν σύγχυση επειδή μοιάζουν με συνηθισμένα σφάλματα αποστολής. Οι 2593107 και 2593108 αφορούν τον συγχρονισμό ιστορικού συνομιλιών, δηλαδή το βήμα που αντιγράφει τις πρόσφατες συνομιλίες από το WhatsApp Business app όταν ένας αριθμός συνδέεται για πρώτη φορά.
Δεν είναι σφάλματα μηνυμάτων και δεν σημαίνουν ότι η σύνδεση απέτυχε. Ένας συγχρονισμός που υπερβαίνει το όριό του ή εκτελείται εκτός του παραθύρου του αφήνει τον αριθμό συνδεδεμένο και να στέλνει κανονικά, με λιγότερο ιστορικό αντιγραμμένο από το αναμενόμενο. Αν τα διαβάσετε ως κατεστραμμένη σύνδεση, μπορεί να αποσυνδέσετε τον αριθμό και να ξεκινήσετε ξανά, χάνοντας περισσότερο ιστορικό αντί να το ανακτήσετε.
Συχνές ερωτήσεις
Ποια σφάλματα πρέπει να επαναλαμβάνω;
Τα 131016 και 131000, με εκθετική backoff καθυστέρηση. Τα 130429, 132015 και 133008 καθαρίζουν μόνα τους αν περιμένετε. Όλα τα υπόλοιπα είναι ντετερμινιστικά.
Σημαίνει ένας κωδικός σφάλματος ότι ο αριθμός μου αποσυνδέθηκε;
Συνήθως όχι. Οι περισσότεροι αφορούν το αίτημα, το template ή τον παραλήπτη. Τα προβλήματα σύνδεσης εμφανίζονται ως account και quality webhooks και όχι ως σφάλματα αποστολής.
Τι είναι το trace id;
Ένα αναγνωριστικό στην απόκριση σφάλματος που επιτρέπει στην υποστήριξη της Meta να εντοπίσει το συγκεκριμένο αίτημα. Καταγράφετέ το σε κάθε αποτυχία. Χωρίς αυτό, ένα αίτημα δεν μπορεί να διεκπεραιωθεί.
Είναι ίδιοι αυτοί οι κωδικοί σε κάθε πάροχο;
Ναι. Προέρχονται από το Cloud API της Meta, επομένως είναι ίδιοι ανεξάρτητα από τον πάροχο που σύνδεσε τον αριθμό. Ο πάροχος μπορεί να αλλάξει μόνο το πόσο καθαρά φτάνουν σε εσάς.
Έτοιμοι να ξεκινήσετε;
Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.
Ξεκινήστε δωρεάν δοκιμήΚαμία χρέωση για 3 ημέρες. Ακυρώστε οποιαδήποτε στιγμή.