Prijavite seZapočnite besplatni probni period
Meta Tech Provider

WhatsApp Cloud API kodovi grešaka

Ovo su svi kodovi grešaka WhatsApp Cloud API-ja koje dokumentujemo, u jednoj tabeli, sa značenjem i informacijom da li pomaže ponovni pokušaj. Većina ne pomaže: greške su determinističke, pa isti zahtev ponovo pada na isti način, dok petlja ponovnih pokušaja loš zahtev pretvara u rate limit.

EasyCoexistence neprekidno prati vezu i beleži Metine događaje za nalog i kvalitet na vremenskoj liniji veze, pa su greške povezane sa stanjem broja vidljive pre neuspešnog slanja, a ne posle njega.

Bez čuvanja poruka podrazumevanoBusiness App + Cloud APIMCP za Claude i ChatGPTRadi za 2 minuta

Zahtev

KodŠta značiPonovni pokušaj
100Parametar nije podržan, pogrešno je napisan ili je neispravan.Ne
131008Obavezan parametar uopšte nije uključen.Ne
131009Parametar postoji, ali sa vrednošću koju endpoint odbija.Ne
131021Pošiljalac i primalac su isti broj.Ne
131051Tip poruke nije podržan, često zbog ograničenja Coexistence režima.Ne
131052Meta nije mogla da preuzme medijski fajl koji je poslao klijent.Ne
131053Meta nije mogla da otpremi medijski fajl koji ste poslali. Veličina, format ili dostupnost.Ne

Šablon

KodŠta značiPonovni pokušaj
132000Broj parametara se ne poklapa sa šablonom.Ne
132001Ne postoji šablon sa tim parom naziva i jezika.Ne
132007Šablon krši pravila za poruke. Preradite ga i ponovo pošaljite na pregled.Ne
132012Format parametra ne odgovara onome što šablon definiše.Ne
132015Šablon je pauziran nakon pada kvaliteta. Privremeno.Sačekaj
132016Šablon je trajno onemogućen. Neće se vratiti.Ne

Prozor i primalac

KodŠta značiPonovni pokušaj
131047Prozor za korisničku podršku od 24 sata je zatvoren. Pošaljite šablon.Ne
131026Primalac uopšte ne može da primi poruku.Ne
131050Osoba se odjavila. Zaobilaznog rešenja nema, i to je namerno.Ne
130497Slanje poruka u tu zemlju je ograničeno za vaš nalog.Ne

Registracija i PIN

KodŠta značiPonovni pokušaj
131045Broj nikada nije registrovan za slanje poruka preko Cloud API-ja.Ne
133010Broj nije registrovan. Registracija mora da se završi.Ne
133006Broj mora da bude verifikovan pre nego što može da se registruje.Ne
133005PIN za verifikaciju u dva koraka nije tačan. Prestanite da pogađate.Ne
133008Previše pokušaja unosa PIN-a. Registracija je zaključana na neko vreme.Sačekaj

Pristup i nalog

KodŠta značiPonovni pokušaj
190Pristupni token je istekao ili je poništen.Ne
368Nalog je ograničen nakon kršenja pravila.Ne
131031Nalog je ograničen ili se njegovi podaci ne poklapaju sa podacima kod Mete.Ne
131042Problem sa plaćanjem na poslovnom nalogu blokira slanje.Ne
131049Meta je blokirala poruku radi zaštite zdravlja ekosistema.Ne

Ograničenja brzine

KodŠta značiPonovni pokušaj
130429Dostignut je limit protoka poruka za nalog.Sačekaj
131048Dostignuto je ograničenje zbog spama. Uzrok je kvalitet, ne obim.Ne
131056Previše poruka između vašeg broja i jednog primaoca.Ne
80007Nalog je dostigao limit poziva za upravljanje. Obično zbog prozivanja (polling).Sačekaj

Privremene greške

KodŠta značiPonovni pokušaj
131016Jedna Meta usluga je privremeno nedostupna.Da
131000Neklasifikovana greška. Pokušajte ponovo jednom, pa eskalirajte sa trace id.Da

Coexistence sinhronizacija

KodŠta značiPonovni pokušaj
2593107Prekoračen je limit sinhronizacije istorije četa.Ne
2593108Sinhronizacija je pokušana van prozora za sinhronizaciju od 24 sata.Ne

Kako čitati kolonu za retry

Ima tri vrednosti, a pogrešan izbor među njima najskuplja je greška u celoj ovoj referenci.

Ne znači da je greška deterministička. Nešto je pošlo naopako sa zahtevom, šablonom ili stanjem primaoca, a ponovno slanje istog zahteva proizvodi istu grešku i troši protok koji će vam kasnije biti potreban. Da znači da je greška nastala na strani Mete i da je rešava period čekanja sa postepenim produžavanjem. Sačekaj znači da je uslov stvaran, ali privremen: ograničenje ili zaključavanje koje se samo uklanja, pa ponovni pokušaj pre toga ne pomaže i može da ga produži.

Zašto većina ovih kodova ne podržava retry

Zato što platforma vraća konkretne, a ne opšte kodove. Neispravan parametar, šablon koji ne postoji, zatvoren prozor za slanje poruka i primalac koji je povukao saglasnost poznati su u trenutku odgovora, pa ih Meta imenuje umesto da nejasno prijavi grešku.

  • Problem sa zahtevom ne postaje ispravan pri drugom pokušaju.
  • Problem sa šablonom nalazi se u šablonu, a zahtev ne može da ga promeni.
  • Problem sa prozorom ili povučenom saglasnošću odnosi se na stanje primaoca, ne na vaše stanje.
  • Ograničenje naloga je odluka, a ponovni pokušaj nije žalba.

Šta evidentirati kada jedan od ovih kodova stigne

Dovoljno podataka za dijagnostiku bez ponavljanja greške, što je razlika između popravke za pet minuta i celog dana nagađanja.

  • Potpun odgovor o grešci, uključujući trace id, koji Meta podrška traži.
  • Telo zahteva onako kako je poslato, a ne kako je zamišljeno. Razlika između ta dva obično je greška.
  • ID telefonskog broja, da bi se problem na jednom broju razlikovao od problema na celom nalogu.
  • Vremenska oznaka, da bi se greška mogla proveriti u odnosu na stanje veze u tom trenutku.

Kodovi koji postoje samo na Coexistence

Dva su takva koda i zbunjuju ljude jer izgledaju kao obične greške pri slanju. 2593107 i 2593108 odnose se na sinhronizaciju istorije razgovora, korak koji kopira nedavne razgovore iz aplikacije WhatsApp Business kada se broj prvi put poveže.

To nisu greške pri slanju poruka i ne znače da je veza prekinuta. Sinhronizacija koja prekorači ograničenje ili se izvršava van svog vremenskog prozora ostavlja broj povezan i omogućava normalno slanje, uz manje kopirane istorije nego što se očekivalo. Ako ih protumačite kao prekinutu vezu, možete prekinuti povezivanje i početi ponovo, čime gubite još istorije umesto da je vratite.

Često postavljana pitanja

Koje greške treba ponovo pokušati?

131016 i 131000, uz eksponencijalno čekanje. 130429, 132015 i 133008 sami se uklanjaju ako sačekate. Sve ostalo je determinističko.

Da li kod greške znači da je moj broj nepovezan?

Obično ne. Većina ovih kodova odnosi se na zahtev, šablon ili primaoca. Problemi sa vezom pojavljuju se kao webhookovi za nalog i kvalitet, a ne kao greške pri slanju.

Šta je trace id?

Identifikator u odgovoru o grešci koji Meta podršci omogućava da pronađe konkretan zahtev. Evidentirajte ga pri svakom neuspehu; bez njega tiket ne može da se obradi.

Da li su ovi kodovi isti kod svakog provajdera?

Da. Dolaze iz Meta Cloud API-ja, pa su identični bez obzira na provajdera koji je povezao broj. Provajder može da utiče samo na to koliko jasno stižu do vas.

Spremni da počnete?

Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.

Započnite besplatni probni period3 dana bez naplate. Otkažite bilo kada.

Nastavite sa čitanjem