Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

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.

Poruke se zadano ne pohranjujuBusiness App + Cloud APIMCP za Claude i ChatGPTAktivno za 2 minute

Zahtjev

KodŠto značiPonovni pokušaj
100Parametar nije podržan, pogrešno je napisan ili je neispravan.Ne
131008Obavezni parametar uopće nije uključen.Ne
131009Parametar postoji, ali s vrijednošću koju endpoint odbija.Ne
131021Pošiljatelj i primatelj isti su broj.Ne
131051Vrsta poruke nije podržana, često zbog ograničenja načina Coexistence.Ne
131052Meta nije mogla preuzeti medijsku datoteku koju je poslao klijent.Ne
131053Meta nije mogla učitati medijsku datoteku koju ste poslali. Veličina, format ili dostupnost.Ne

Predložak

KodŠto značiPonovni pokušaj
132000Broj parametara ne odgovara predlošku.Ne
132001Ne postoji predložak s tim parom naziva i jezika.Ne
132007Predložak krši pravila za poruke. Prepravite ga i ponovno pošaljite.Ne
132012Format parametra ne odgovara onome što predložak definira.Ne
132015Predložak je pauziran nakon pada kvalitete. Privremeno.Pričekajte
132016Predložak je trajno onemogućen. Neće se vratiti.Ne

Prozor i primatelj

KodŠto značiPonovni pokušaj
131047Prozor korisničke službe od 24 sata je zatvoren. Pošaljite predložak.Ne
131026Primatelj uopće ne može primiti poruku.Ne
131050Osoba se odjavila. Zaobilaznog rješenja nema, i to namjerno.Ne
130497Slanje poruka u tu zemlju ograničeno je za vaš račun.Ne

Registracija i PIN

KodŠto značiPonovni pokušaj
131045Broj nikad nije registriran za slanje poruka putem Cloud API-ja.Ne
133010Broj nije registriran. Registracija se mora dovršiti.Ne
133006Broj mora biti potvrđen prije nego što se može registrirati.Ne
133005PIN za potvrdu u dva koraka bio je pogrešan. Prestanite pogađati.Ne
133008Previše pokušaja unosa PIN-a. Registracija je zaključana na neko vrijeme.Pričekajte

Pristup i račun

KodŠto značiPonovni pokušaj
190Pristupni token je istekao ili je poništen.Ne
368Račun je ograničen nakon kršenja pravila.Ne
131031Račun je ograničen ili se njegovi podaci ne podudaraju s Metinima.Ne
131042Problem s plaćanjem na poslovnom računu blokira slanje.Ne
131049Meta je blokirala poruku radi zaštite zdravlja ekosustava.Ne

Ograničenja brzine

KodŠto značiPonovni pokušaj
130429Dosegnuto je ograničenje propusnosti poruka za račun.Pričekajte
131048Dosegnuto je ograničenje zbog neželjenih poruka. Uzrok je kvaliteta, a ne obujam.Ne
131056Previše poruka između vašeg broja i jednog primatelja.Ne
80007Račun je dosegnuo ograničenje poziva za upravljanje. Obično zbog učestalog provjeravanja (polling).Pričekajte

Privremene pogreške

KodŠto značiPonovni pokušaj
131016Jedna Metina usluga privremeno je nedostupna.Da
131000Neklasificirana pogreška. Pokušajte ponovno jednom, a zatim eskalirajte uz trace id.Da

Coexistence sinkronizacija

KodŠto značiPonovni pokušaj
2593107Prekoračeno je ograničenje sinkronizacije povijesti razgovora.Ne
2593108Sinkronizacija je pokušana izvan prozora za sinkronizaciju od 24 sata.Ne

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.

Nastavite čitati