Kody błędów WhatsApp Cloud API
To wszystkie udokumentowane przez nas kody błędów WhatsApp Cloud API, zebrane w jednej tabeli wraz ze znaczeniem i informacją, czy ponowienie żądania pomoże. Większość nie pomoże: błędy są deterministyczne, więc to samo żądanie kończy się tak samo, a pętla ponowień zmienia nieprawidłowe żądanie w przekroczenie limitu.
EasyCoexistence stale monitoruje połączenie i zapisuje zdarzenia Meta dotyczące konta i jakości na osi czasu połączenia, dzięki czemu problemy wynikające ze stanu numeru są widoczne przed nieudaną wysyłką, a nie dopiero po niej.
Żądanie
| Kod | Co oznacza | Ponowienie |
|---|---|---|
| 100 | Parametr jest nieobsługiwany, ma literówkę lub jest nieprawidłowo sformatowany. | Nie |
| 131008 | Wymagany parametr w ogóle nie został dołączony. | Nie |
| 131009 | Parametr jest obecny, ale z wartością, którą endpoint odrzuca. | Nie |
| 131021 | Nadawca i odbiorca to ten sam numer. | Nie |
| 131051 | Typ wiadomości nie jest obsługiwany, często z powodu ograniczenia Coexistence. | Nie |
| 131052 | Meta nie mogła pobrać multimediów wysłanych przez klienta. | Nie |
| 131053 | Meta nie mogła przesłać multimediów wysłanych przez Ciebie. Rozmiar, format lub dostępność. | Nie |
Szablon
| Kod | Co oznacza | Ponowienie |
|---|---|---|
| 132000 | Liczba parametrów nie zgadza się z szablonem. | Nie |
| 132001 | Nie istnieje szablon o tej nazwie w tym języku. | Nie |
| 132007 | Szablon narusza zasady przesyłania wiadomości. Przeredaguj go i prześlij ponownie. | Nie |
| 132012 | Format parametru nie zgadza się z tym, co definiuje szablon. | Nie |
| 132015 | Szablon wstrzymano po spadku jakości. Tymczasowo. | Poczekaj |
| 132016 | Szablon został trwale wyłączony. Nie wróci. | Nie |
Okno i odbiorca
| Kod | Co oznacza | Ponowienie |
|---|---|---|
| 131047 | 24-godzinne okno obsługi klienta jest zamknięte. Wyślij szablon. | Nie |
| 131026 | Odbiorca w ogóle nie może odebrać wiadomości. | Nie |
| 131050 | Ta osoba zrezygnowała z wiadomości. Celowo nie ma na to obejścia. | Nie |
| 130497 | Wysyłanie wiadomości do tego kraju jest ograniczone dla Twojego konta. | Nie |
Rejestracja i PIN
| Kod | Co oznacza | Ponowienie |
|---|---|---|
| 131045 | Numer nigdy nie został zarejestrowany do wysyłania wiadomości przez Cloud API. | Nie |
| 133010 | Numer nie jest zarejestrowany. Rejestrację trzeba dokończyć. | Nie |
| 133006 | Numer musi zostać zweryfikowany, zanim będzie można go zarejestrować. | Nie |
| 133005 | PIN weryfikacji dwuetapowej był błędny. Przestań zgadywać. | Nie |
| 133008 | Zbyt wiele prób podania PIN-u. Rejestracja jest zablokowana na pewien czas. | Poczekaj |
Dostęp i konto
| Kod | Co oznacza | Ponowienie |
|---|---|---|
| 190 | Token dostępu wygasł lub został unieważniony. | Nie |
| 368 | Konto jest ograniczone po naruszeniu zasad. | Nie |
| 131031 | Konto jest ograniczone lub jego dane nie zgadzają się z danymi w Meta. | Nie |
| 131042 | Problem z płatnością na koncie firmowym blokuje wysyłanie. | Nie |
| 131049 | Meta zablokowała wiadomość dla dobra ekosystemu. | Nie |
Limity częstotliwości
| Kod | Co oznacza | Ponowienie |
|---|---|---|
| 130429 | Osiągnięto limit przepustowości wiadomości dla konta. | Poczekaj |
| 131048 | Przekroczono limit związany ze spamem. Przyczyną jest jakość, nie wolumen. | Nie |
| 131056 | Zbyt wiele wiadomości między Twoim numerem a jednym odbiorcą. | Nie |
| 80007 | Konto osiągnęło limit wywołań zarządzania. Zwykle przez odpytywanie. | Poczekaj |
Błędy przejściowe
Synchronizacja Coexistence
Jak czytać kolumnę ponowienia
Zawiera trzy wartości, a błędny wybór między nimi jest najkosztowniejszą pomyłką w całym tym zestawieniu.
„Nie” oznacza, że błąd jest deterministyczny. Nie powiodło się żądanie, szablon lub stan odbiorcy, a ponowne wysłanie identycznego żądania wywoła ten sam błąd i zużyje przepustowość potrzebną później. „Tak” oznacza, że błąd leżał po stronie Meta i właściwe opóźnienie rzeczywiście go rozwiązuje. „Poczekaj” oznacza, że przyczyna jest rzeczywista, lecz tymczasowa: to limit lub blokada, która znika samoistnie. Ponowienie przed jej usunięciem nic nie daje i może ją przedłużyć.
Dlaczego większości z nich nie należy ponawiać
Ponieważ platforma zwraca konkretne kody zamiast ogólnych. Nieprawidłowy parametr, nieistniejący szablon, zamknięte okno wiadomości i odbiorca, który zrezygnował z otrzymywania wiadomości, są znane w chwili udzielenia odpowiedzi, więc Meta nazywa je wprost, zamiast kończyć żądanie niejasnym błędem.
- Problem z żądaniem nie stanie się poprawny przy drugiej próbie.
- Problem z szablonem tkwi w szablonie, którego żądanie nie może zmienić.
- Problem z oknem lub rezygnacją odbiorcy dotyczy jego stanu, nie Twojego.
- Ograniczenie konta jest decyzją, a ponowienie żądania nie jest odwołaniem.
Co rejestrować po otrzymaniu jednego z tych kodów
Tyle, by zdiagnozować problem bez jego odtwarzania. To różnica między pięciominutową naprawą a całym dniem zgadywania.
- Pełną odpowiedź z błędem, w tym trace id, o które prosi pomoc Meta.
- Treść żądania w wysłanej postaci, nie w zamierzonej. Różnica między nimi jest zwykle źródłem problemu.
- Identyfikator numeru telefonu, aby odróżnić problem jednego numeru od problemu całego konta.
- Znacznik czasu, aby sprawdzić błąd względem stanu połączenia w danym momencie.
Kody występujące tylko w Coexistence
Są dwa i powodują zamieszanie, bo wyglądają jak zwykłe błędy wysyłania. 2593107 i 2593108 dotyczą synchronizacji historii czatów, czyli etapu kopiowania ostatnich rozmów z aplikacji WhatsApp Business po pierwszym połączeniu numeru.
Nie są to błędy wiadomości i nie oznaczają nieudanego połączenia. Jeśli synchronizacja przekroczy limit lub odbędzie się poza wyznaczonym oknem, numer pozostanie połączony i będzie normalnie wysyłać wiadomości, ale skopiuje się mniej historii, niż oczekiwano. Odczytanie tych kodów jako zerwanego połączenia prowadzi do odłączenia numeru i rozpoczęcia od nowa, co powoduje utratę większej części historii zamiast jej odzyskania.
Najczęściej zadawane pytania
Które błędy należy ponawiać?
131016 i 131000, z wykładniczym zwiększaniem opóźnienia. 130429, 132015 i 133008 znikają samoistnie po odczekaniu. Wszystkie pozostałe są deterministyczne.
Czy kod błędu oznacza, że mój numer jest odłączony?
Zwykle nie. Większość tych kodów dotyczy żądania, szablonu lub odbiorcy. Problemy z połączeniem pojawiają się jako webhooki konta i jakości, a nie jako błędy wysyłania.
Czym jest trace id?
To identyfikator w odpowiedzi z błędem, który pozwala pomocy Meta znaleźć konkretne żądanie. Rejestruj go przy każdym błędzie, bo bez niego nie da się skutecznie obsłużyć zgłoszenia.
Czy te kody są takie same u każdego dostawcy?
Tak. Pochodzą z Cloud API Meta, więc są identyczne niezależnie od dostawcy, który połączył numer. Dostawca może jedynie zmienić sposób, w jaki do Ciebie docierają.
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyPrzez 3 dni nic nie zapłacisz. Anuluj w dowolnym momencie.