Meta Tech Provider

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

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

Χωρίς αποθήκευση μηνυμάτωνBusiness App + Cloud APIMCP για Claude και ChatGPTΈτοιμο σε 2 λεπτά

Request

Code	What it means	Retry
100	A parameter is unsupported, misspelled or malformed.	No
131008	A required parameter was not included at all.	No
131009	A parameter is present with a value the endpoint rejects.	No
131021	Sender and recipient are the same number.	No
131051	The message type is not supported, often a Coexistence limit.	No
131052	Meta could not download media a customer sent.	No
131053	Meta could not upload media you sent. Size, format or reach.	No

Template

Code	What it means	Retry
132000	The number of parameters does not match the template.	No
132001	No template exists with that name and language pair.	No
132007	The template breaks messaging policy. Rewrite and resubmit.	No
132012	Parameter format does not match what the template defines.	No
132015	The template is paused after a quality decline. Temporary.	Wait
132016	The template is permanently disabled. It will not come back.	No

Window and recipient

Code	What it means	Retry
131047	The 24-hour service window is closed. Send a template.	No
131026	The recipient cannot receive the message at all.	No
131050	The person opted out. There is no workaround, by design.	No
130497	Messaging that country is restricted for your account.	No

Registration and PIN

Code	What it means	Retry
131045	The number was never registered for Cloud API messaging.	No
133010	The number is not registered. Registration must be completed.	No
133006	The number must be verified before it can be registered.	No
133005	The two-step verification PIN was wrong. Stop guessing.	No
133008	Too many PIN attempts. Registration is locked for a period.	Wait

Access and account

Code	What it means	Retry
190	The access token expired or was invalidated.	No
368	The account is restricted after a policy violation.	No
131031	The account is restricted, or its data does not match Meta's.	No
131042	A payment problem on the business account blocks sending.	No
131049	Meta blocked the message to protect ecosystem health.	No

Rate limits

Code	What it means	Retry
130429	The account's messaging throughput limit was reached.	Wait
131048	A spam rate limit was hit. Quality, not volume, is the cause.	No
131056	Too many messages between your number and one recipient.	No
80007	The account hit its management call limit. Usually polling.	Wait

Transient

Code	What it means	Retry
131016	A Meta service is temporarily unavailable.	Yes
131000	Unclassified failure. Retry once, then escalate with the trace id.	Yes

Coexistence sync

Code	What it means	Retry
2593107	The chat history synchronisation limit was exceeded.	No
2593108	A sync was attempted outside the 24-hour sync window.	No

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

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

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

Ξεκινήστε δωρεάν δοκιμήΚαμία χρέωση για 7 ημέρες. Ακυρώστε οποιαδήποτε στιγμή.

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

ReferenceWhatsApp error 131047: re-engagement messageError 131047 means more than 24 hours have passed since that customer last messaged you, so the customer service window is closed and free text will not deliver.ReferenceWhatsApp error 100: invalid parameterError 100 means the request carried a parameter Meta does not accept: unsupported, misspelled, or the wrong shape for that endpoint.ReferenceWhatsApp error 131016: service unavailableError 131016 means a service on Meta's side is temporarily unavailable.ReferenceA number stopped working: how to find out whyWhen a connected number stops working, the cause is almost never the code.ReferenceWhatsApp webhook fields, and which ones go whereA WhatsApp Business Account delivers events as named fields.GuideWhatsApp Coexistence: the app and the API on one numberCoexistence is Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time.