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.
Zahtev
| Kod | Šta znači | Ponovni pokušaj |
|---|---|---|
| 100 | Parametar nije podržan, pogrešno je napisan ili je neispravan. | Ne |
| 131008 | Obavezan parametar uopšte nije uključen. | Ne |
| 131009 | Parametar postoji, ali sa vrednošću koju endpoint odbija. | Ne |
| 131021 | Pošiljalac i primalac su isti broj. | Ne |
| 131051 | Tip poruke nije podržan, često zbog ograničenja Coexistence režima. | Ne |
| 131052 | Meta nije mogla da preuzme medijski fajl koji je poslao klijent. | Ne |
| 131053 | Meta nije mogla da otpremi medijski fajl koji ste poslali. Veličina, format ili dostupnost. | Ne |
Šablon
| Kod | Šta znači | Ponovni pokušaj |
|---|---|---|
| 132000 | Broj parametara se ne poklapa sa šablonom. | Ne |
| 132001 | Ne 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 |
| 132012 | Format 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
Registracija i PIN
| Kod | Šta znači | Ponovni pokušaj |
|---|---|---|
| 131045 | Broj nikada nije registrovan za slanje poruka preko Cloud API-ja. | Ne |
| 133010 | Broj nije registrovan. Registracija mora da se završi. | Ne |
| 133006 | Broj mora da bude verifikovan pre nego što može da se registruje. | Ne |
| 133005 | PIN za verifikaciju u dva koraka nije tačan. Prestanite da pogađate. | Ne |
| 133008 | Previše pokušaja unosa PIN-a. Registracija je zaključana na neko vreme. | Sačekaj |
Pristup i nalog
| Kod | Šta znači | Ponovni pokušaj |
|---|---|---|
| 190 | Pristupni token je istekao ili je poništen. | Ne |
| 368 | Nalog je ograničen nakon kršenja pravila. | Ne |
| 131031 | Nalog je ograničen ili se njegovi podaci ne poklapaju sa podacima kod Mete. | Ne |
| 131042 | Problem sa plaćanjem na poslovnom nalogu blokira slanje. | Ne |
| 131049 | Meta je blokirala poruku radi zaštite zdravlja ekosistema. | Ne |
Ograničenja brzine
| Kod | Šta znači | Ponovni pokušaj |
|---|---|---|
| 130429 | Dostignut je limit protoka poruka za nalog. | Sačekaj |
| 131048 | Dostignuto je ograničenje zbog spama. Uzrok je kvalitet, ne obim. | Ne |
| 131056 | Previše poruka između vašeg broja i jednog primaoca. | Ne |
| 80007 | Nalog je dostigao limit poziva za upravljanje. Obično zbog prozivanja (polling). | Sačekaj |
Privremene greške
Coexistence sinhronizacija
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.