Zaloguj sięRozpocznij bezpłatny okres próbny
Meta Tech Provider

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.

Domyślnie bez zapisu wiadomościAplikacja firmowa + Cloud APIMCP dla Claude i ChatGPTGotowe w 2 minuty

Żądanie

KodCo oznaczaPonowienie
100Parametr jest nieobsługiwany, ma literówkę lub jest nieprawidłowo sformatowany.Nie
131008Wymagany parametr w ogóle nie został dołączony.Nie
131009Parametr jest obecny, ale z wartością, którą endpoint odrzuca.Nie
131021Nadawca i odbiorca to ten sam numer.Nie
131051Typ wiadomości nie jest obsługiwany, często z powodu ograniczenia Coexistence.Nie
131052Meta nie mogła pobrać multimediów wysłanych przez klienta.Nie
131053Meta nie mogła przesłać multimediów wysłanych przez Ciebie. Rozmiar, format lub dostępność.Nie

Szablon

KodCo oznaczaPonowienie
132000Liczba parametrów nie zgadza się z szablonem.Nie
132001Nie istnieje szablon o tej nazwie w tym języku.Nie
132007Szablon narusza zasady przesyłania wiadomości. Przeredaguj go i prześlij ponownie.Nie
132012Format parametru nie zgadza się z tym, co definiuje szablon.Nie
132015Szablon wstrzymano po spadku jakości. Tymczasowo.Poczekaj
132016Szablon został trwale wyłączony. Nie wróci.Nie

Okno i odbiorca

KodCo oznaczaPonowienie
13104724-godzinne okno obsługi klienta jest zamknięte. Wyślij szablon.Nie
131026Odbiorca w ogóle nie może odebrać wiadomości.Nie
131050Ta osoba zrezygnowała z wiadomości. Celowo nie ma na to obejścia.Nie
130497Wysyłanie wiadomości do tego kraju jest ograniczone dla Twojego konta.Nie

Rejestracja i PIN

KodCo oznaczaPonowienie
131045Numer nigdy nie został zarejestrowany do wysyłania wiadomości przez Cloud API.Nie
133010Numer nie jest zarejestrowany. Rejestrację trzeba dokończyć.Nie
133006Numer musi zostać zweryfikowany, zanim będzie można go zarejestrować.Nie
133005PIN weryfikacji dwuetapowej był błędny. Przestań zgadywać.Nie
133008Zbyt wiele prób podania PIN-u. Rejestracja jest zablokowana na pewien czas.Poczekaj

Dostęp i konto

KodCo oznaczaPonowienie
190Token dostępu wygasł lub został unieważniony.Nie
368Konto jest ograniczone po naruszeniu zasad.Nie
131031Konto jest ograniczone lub jego dane nie zgadzają się z danymi w Meta.Nie
131042Problem z płatnością na koncie firmowym blokuje wysyłanie.Nie
131049Meta zablokowała wiadomość dla dobra ekosystemu.Nie

Limity częstotliwości

KodCo oznaczaPonowienie
130429Osiągnięto limit przepustowości wiadomości dla konta.Poczekaj
131048Przekroczono limit związany ze spamem. Przyczyną jest jakość, nie wolumen.Nie
131056Zbyt wiele wiadomości między Twoim numerem a jednym odbiorcą.Nie
80007Konto osiągnęło limit wywołań zarządzania. Zwykle przez odpytywanie.Poczekaj

Błędy przejściowe

KodCo oznaczaPonowienie
131016Usługa Meta jest tymczasowo niedostępna.Tak
131000Niesklasyfikowany błąd. Ponów raz, a potem zgłoś problem z identyfikatorem trace id.Tak

Synchronizacja Coexistence

KodCo oznaczaPonowienie
2593107Przekroczono limit synchronizacji historii czatów.Nie
2593108Synchronizację podjęto poza 24-godzinnym oknem synchronizacji.Nie

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.

Czytaj dalej