Kodovi pogrešaka WhatsApp Cloud API-ja
Ovo su svi kodovi pogrešaka WhatsApp Cloud API-ja koje dokumentiramo, u jednoj tablici, uz objašnjenje svakog kôda i informaciju pomaže li ponovni pokušaj. Većinom ne pomaže: pogreške su determinističke, pa isti zahtjev ne uspijeva na isti način, a petlja ponovnih pokušaja loš zahtjev pretvara u ograničenje broja zahtjeva.
EasyCoexistence neprekidno prati vezu i bilježi Metine događaje računa i kvalitete na vremenskoj crti veze, pa su pogreške uzrokovane stanjem broja vidljive prije neuspjelog slanja, a ne poslije.
Zahtjev
| Kod | Što znači | Ponovni pokušaj |
|---|---|---|
| 100 | Parametar nije podržan, pogrešno je napisan ili je neispravan. | Ne |
| 131008 | Obavezni parametar uopće nije uključen. | Ne |
| 131009 | Parametar postoji, ali s vrijednošću koju endpoint odbija. | Ne |
| 131021 | Pošiljatelj i primatelj isti su broj. | Ne |
| 131051 | Vrsta poruke nije podržana, često zbog ograničenja načina Coexistence. | Ne |
| 131052 | Meta nije mogla preuzeti medijsku datoteku koju je poslao klijent. | Ne |
| 131053 | Meta nije mogla učitati medijsku datoteku koju ste poslali. Veličina, format ili dostupnost. | Ne |
Predložak
| Kod | Što znači | Ponovni pokušaj |
|---|---|---|
| 132000 | Broj parametara ne odgovara predlošku. | Ne |
| 132001 | Ne postoji predložak s tim parom naziva i jezika. | Ne |
| 132007 | Predložak krši pravila za poruke. Prepravite ga i ponovno pošaljite. | Ne |
| 132012 | Format parametra ne odgovara onome što predložak definira. | Ne |
| 132015 | Predložak je pauziran nakon pada kvalitete. Privremeno. | Pričekajte |
| 132016 | Predložak je trajno onemogućen. Neće se vratiti. | Ne |
Prozor i primatelj
Registracija i PIN
| Kod | Što znači | Ponovni pokušaj |
|---|---|---|
| 131045 | Broj nikad nije registriran za slanje poruka putem Cloud API-ja. | Ne |
| 133010 | Broj nije registriran. Registracija se mora dovršiti. | Ne |
| 133006 | Broj mora biti potvrđen prije nego što se može registrirati. | Ne |
| 133005 | PIN za potvrdu u dva koraka bio je pogrešan. Prestanite pogađati. | Ne |
| 133008 | Previše pokušaja unosa PIN-a. Registracija je zaključana na neko vrijeme. | Pričekajte |
Pristup i račun
| Kod | Što znači | Ponovni pokušaj |
|---|---|---|
| 190 | Pristupni token je istekao ili je poništen. | Ne |
| 368 | Račun je ograničen nakon kršenja pravila. | Ne |
| 131031 | Račun je ograničen ili se njegovi podaci ne podudaraju s Metinima. | Ne |
| 131042 | Problem s plaćanjem na poslovnom računu blokira slanje. | Ne |
| 131049 | Meta je blokirala poruku radi zaštite zdravlja ekosustava. | Ne |
Ograničenja brzine
| Kod | Što znači | Ponovni pokušaj |
|---|---|---|
| 130429 | Dosegnuto je ograničenje propusnosti poruka za račun. | Pričekajte |
| 131048 | Dosegnuto je ograničenje zbog neželjenih poruka. Uzrok je kvaliteta, a ne obujam. | Ne |
| 131056 | Previše poruka između vašeg broja i jednog primatelja. | Ne |
| 80007 | Račun je dosegnuo ograničenje poziva za upravljanje. Obično zbog učestalog provjeravanja (polling). | Pričekajte |
Privremene pogreške
Coexistence sinkronizacija
Kako čitati stupac o ponovnom pokušaju
Sadrži tri vrijednosti, a pogrešan odabir među njima najskuplja je pogreška u cijeloj ovoj referenci.
Ne znači da je neuspjeh deterministički. Pogreška je u zahtjevu, predlošku ili stanju primatelja, a ponovno slanje identičnog zahtjeva daje istu pogrešku i troši propusnost koja će vam poslije trebati. Da znači da je pogreška na Metinoj strani i da je postupno ponovno slanje doista uklanja. Pričekajte znači da je uvjet stvaran, ali privremen: ograničenje ili zaključavanje koje se samo uklanja, pa ponovni pokušaj prije toga ne pomaže i može ga produljiti.
Zašto se većina ovih kôdova ne može riješiti ponovnim pokušajem
Zato što platforma vraća konkretne kodove, a ne generičke. Neispravan parametar, predložak koji ne postoji, zatvoren prozor za slanje poruka i primatelj koji je odustao od primanja poruka poznati su već u trenutku odgovora, pa ih Meta imenuje umjesto da neodređeno prijavi neuspjeh.
- Problem sa zahtjevom ne postaje ispravan u drugom pokušaju.
- Problem s predloškom nalazi se u samom predlošku, a zahtjev ga ne može promijeniti.
- Problem s prozorom ili odjavom primanja poruka odnosi se na stanje primatelja, a ne na vaše stanje.
- Ograničenje računa odluka je sustava, a ponovni pokušaj nije žalba.
Što zapisati kada stigne jedan od ovih kôdova
Dovoljno podataka za dijagnostiku bez ponavljanja problema, što je razlika između popravka za pet minuta i cijelog dana nagađanja.
- Cijeli odgovor pogreške, uključujući trace id, koji Meta podrška traži.
- Tijelo zahtjeva kako je poslano, a ne kako je zamišljeno. Razlika između toga najčešće je pogreška.
- ID telefonskog broja, kako bi se problem na jednom broju razlikovao od problema na cijelom računu.
- Vremensku oznaku, kako bi se neuspjeh mogao provjeriti u odnosu na stanje veze u tom trenutku.
Kôdovi koji postoje samo na Coexistence
Dva su takva kôda i zbunjuju ljude jer izgledaju kao obični neuspjesi slanja. 2593107 i 2593108 odnose se na sinkronizaciju povijesti razgovora, odnosno korak koji kopira nedavne razgovore iz aplikacije WhatsApp Business kada se broj prvi put poveže.
To nisu pogreške slanja poruka i ne znače da povezivanje nije uspjelo. Sinkronizacija koja premaši ograničenje ili se pokrene izvan svojeg prozora ostavlja broj povezanim i spremnim za uobičajeno slanje, ali kopira manje povijesti nego što se očekivalo. Ako ih protumačite kao neispravnu vezu, mogli biste prekinuti povezivanje i početi ispočetka, čime se gubi još više povijesti umjesto da se ona obnovi.
Često postavljana pitanja
Koje pogreške trebam pokušati ponoviti?
131016 i 131000, uz eksponencijalno povećavanje razmaka između pokušaja. 130429, 132015 i 133008 sami se ponište ako pričekate. Sve ostalo je determinističko.
Znači li kôd pogreške da je moj broj odspojen?
Obično ne. Većina se odnosi na zahtjev, predložak ili primatelja. Problemi s povezivanjem pojavljuju se kao webhookovi računa i kvalitete, a ne kao pogreške slanja.
Što je trace id?
Identifikator u odgovoru pogreške koji Metinoj podršci omogućuje pronalaženje konkretnog zahtjeva. Zapisujte ga pri svakom neuspjehu; bez njega se upit ne može obraditi.
Jesu li ovi kôdovi isti kod svakog pružatelja?
Da. Dolaze iz Metina Cloud API-ja, pa su jednaki bez obzira na to koji je pružatelj povezao broj. Pružatelj može promijeniti samo koliko jasno dopiru do vas.
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdoblje3 dana bez naplate. Otkažite bilo kada.