ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
Meta Tech Provider

Κωδικοί σφάλματος WhatsApp Cloud API

Αυτοί είναι όλοι οι κωδικοί σφάλματος του WhatsApp Cloud API που τεκμηριώνουμε, σε έναν πίνακα, μαζί με τη σημασία τους και το αν βοηθά η επανάληψη. Οι περισσότεροι όχι, επειδή είναι ντετερμινιστικοί. Το ίδιο αίτημα αποτυγχάνει με τον ίδιο τρόπο και ένας βρόχος επαναλήψεων μετατρέπει ένα λανθασμένο αίτημα σε όριο ρυθμού.

Το EasyCoexistence παρακολουθεί συνεχώς τη σύνδεση και καταγράφει τα συμβάντα λογαριασμού και ποιότητας της Meta στο χρονολόγιο της σύνδεσης, ώστε τα σφάλματα που προέρχονται από την κατάσταση ενός αριθμού να είναι ορατά πριν αποτύχει η αποστολή και όχι μετά.

Μηνύματα δεν αποθηκεύονται εξ ορισμούBusiness App + Cloud APIMCP για Claude και ChatGPTΈτοιμο σε 2 λεπτά

Αίτημα

ΚωδικόςΤι σημαίνειΕπανάληψη
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.Περιμένετε

Παροδικά σφάλματα

ΚωδικόςΤι σημαίνειΕπανάληψη
131016Μια υπηρεσία της Meta δεν είναι προσωρινά διαθέσιμη.Ναι
131000Μη ταξινομημένη αποτυχία. Επαναλάβετε μία φορά και μετά κλιμακώστε με το trace id.Ναι

Συγχρονισμός Coexistence

ΚωδικόςΤι σημαίνειΕπανάληψη
2593107Ξεπεράστηκε το όριο συγχρονισμού του ιστορικού συνομιλιών.Όχι
2593108Επιχειρήθηκε συγχρονισμός εκτός του 24ωρου παραθύρου συγχρονισμού.Όχι

Πώς διαβάζετε τη στήλη επανάληψης

Έχει τρεις τιμές και η λανθασμένη επιλογή μεταξύ τους είναι το πιο δαπανηρό λάθος σε όλη αυτή την αναφορά.

Όχι σημαίνει ότι η αποτυχία είναι ντετερμινιστική. Αυτό που απέτυχε είναι το αίτημα, το 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 ημέρες. Ακυρώστε οποιαδήποτε στιγμή.

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

ΑναφοράΣφάλμα WhatsApp 131047: μήνυμα επαναδραστηριοποίησηςΤο σφάλμα 131047 σημαίνει ότι πέρασαν περισσότερες από 24 ώρες από το τελευταίο μήνυμα του πελάτη, οπότε το παράθυρο εξυπηρέτησης πελατών έχει κλείσει και το ελεύθερο κείμενο δεν θα παραδοθεί.ΑναφοράΣφάλμα 100 στο WhatsApp: μη έγκυρη παράμετροςΤο σφάλμα 100 σημαίνει ότι το αίτημα περιείχε παράμετρο που η Meta δεν αποδέχεται: δεν υποστηρίζεται, έχει ορθογραφικό λάθος ή έχει λανθασμένη δομή για το συγκεκριμένο endpoint.ΑναφοράΣφάλμα WhatsApp 131016: η υπηρεσία δεν είναι διαθέσιμηΤο σφάλμα 131016 σημαίνει ότι μια υπηρεσία στην πλευρά της Meta δεν είναι προσωρινά διαθέσιμη.ΑναφοράΈνας αριθμός σταμάτησε να λειτουργεί: πώς θα βρείτε την αιτίαΌταν ένας συνδεδεμένος αριθμός σταματά να λειτουργεί, η αιτία σχεδόν ποτέ δεν είναι ο κώδικας.ΑναφοράΠεδία webhook του WhatsApp και η δρομολόγησή τουςΈνας λογαριασμός WhatsApp Business παραδίδει events ως ονομασμένα πεδία.ΟδηγόςWhatsApp Coexistence: η εφαρμογή και το API στον ίδιο αριθμόΤο Coexistence είναι η επίσημη λειτουργία της Meta για ταυτόχρονη χρήση της εφαρμογής WhatsApp Business και του Cloud API στον ίδιο αριθμό.