Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

WhatsApp API poruka nije isporučena: uzroci redom kojim ih provjeravate

Poruka prihvaćena u WhatsApp API-ju još nije isporučena poruka. Meta ishod javlja kasnije, u webhooku statusa: sent, delivered, read ili failed, uz kôd pogreške. Provjerite redom: status failed i njegov kôd, 24-satni prozor (131047), način plaćanja (131042), predložak (132001, 132015), primatelja (131026, 131049, 131050), pa zatim ograničenja broja i vezu.

easyCoexistence prati svaki povezani broj neprekidno, šalje vam e-poštu kad Meta prestane isporučivati, prekine vezu ili smanji kvalitetu te prosljeđuje Metine webhookove statusa nepromijenjene vašem sustavu.

4 statuses

sent (jedna kvačica), delivered (dvije), read (dvije plave) i failed (crveni trokut pogreške), onako kako ih javljaju webhookovi statusa.

131047

Prošlo je više od 24 sata otkad je primatelj zadnji put odgovorio; Meta kaže da treba poslati predložak.

131026

Nije moguća isporuka: broj nije na WhatsAppu, primatelj nije prihvatio nove uvjete ili koristi staru verziju WhatsAppa.

30 days

Zadano vrijeme u kojem WhatsApp ponavlja isporuku neisporučenog uslužnog ili marketinškog predloška prije nego ga odbaci; predlošci za autentifikaciju zadano imaju 10 minuta.

20 mps

Fiksna propusnost broja koji se koristi i u aplikaciji WhatsApp Business i u Cloud API-ju.

Zašto prihvaćena poruka i dalje ne stigne?

Zato što su odgovor API-ja i isporuka dva odvojena događaja. Kad šaljete, Meta vraća message id čim prihvati zahtjev; hoće li poruka doći do telefona kupca, saznaje se kasnije, u webhooku statusa na polju messages. sent znači da je poruka napustila Metine poslužitelje (jedna kvačica), delivered da je stigla na uređaj (dvije), read da je otvorena (dvije plave), a failed da nije mogla biti poslana ili isporučena, što vam se prikazuje u polju errors: code, title i error_data.details. Zato prvi korak nikad nije nagađanje: pronađite status failed za taj message id i pročitajte njegov kôd. Ako nemate odredište webhooka, ništa se ne bilježi.

Koji su uzroci, redom kojim ih treba provjeriti?

Od najčešćeg na novo povezanom broju do najrjeđeg. Svaki redak navodi Metin kôd, pa status failed pokazuje u kojem ste slučaju:

  • Prozor zatvoren: 131047, više od 24 sata otkad je kupac zadnji put pisao. Poruke slobodnog teksta trebaju otvoren prozor; pošaljite predložak.
  • Plaćanje: 131042, ili predlošci tiho odbačeni. Od 1. listopada 2026. uslužne poruke također prestaju nakon što se iskoristi 1.000 mjesečno bez načina plaćanja.
  • Predložak: 132001 nije odobren ili je pogrešan jezik, 132000 pogrešan broj varijabli, 132012 pogrešan format, 132015 pauziran, 132016 onemogućen.
  • Primatelj: 131026 nije na WhatsAppu, stara verzija ili uvjeti nisu prihvaćeni; 131050 zaustavljene marketinške poruke; 131049 zadržano radi zdravog angažmana; marketinški predlošci za američke brojeve se ne isporučuju.
  • Ograničenja: 131048 ograničeno nakon signala neželjene pošte, 131056 previše poruka jednoj osobi, 130429 propusnost, 20 poruka u sekundi na Coexistence broju.
  • Račun: 131031 ili 368, račun WhatsApp Business Account ograničen ili onemogućen zbog kršenja pravila.
  • Veza: broj više nije povezan, na primjer nakon 14 dana bez otvaranja aplikacije WhatsApp Business.

Kako postupati s kodovima na strani primatelja?

Drugačije, jer neki zaslužuju ponovni pokušaj, a neki nikad. 131050 znači da je osoba odlučila prestati primati marketinške poruke od vas: Meta kaže da se ne pokušava ponovno, a webhook user_preferences javlja kad se prestane ili nastavi. 131049 je Meta koja zadržava marketinšku poruku kako bi angažman ostao zdrav, često kao ograničenje po korisniku za marketinške predloške: Meta savjetuje čekati najmanje 24 sata prije ponovnog slanja, jer ranije slanje samo vraća istu pogrešku. 131026 obuhvaća brojeve koji nisu na WhatsAppu, korisnike koji nisu prihvatili trenutačne uvjete WhatsAppa i vrlo stare verzije aplikacije; najprije provjerite format broja i pozivni broj zemlje, a zatim kupca kontaktirajte drugim kanalom.

Koliko dugo WhatsApp pokušava isporučiti?

Do isteka vremena života poruke (time to live, TTL). Kad je telefon isključen ili izvan dosega, WhatsApp ponavlja isporuku umjesto da odmah javi neuspjeh: zadano 30 dana za uslužne i marketinške predloške te 10 minuta za predloške za autentifikaciju. Tvrtka to može skratiti po predlošku parametrom message_send_ttl_seconds, od 30 sekundi do 12 sati za uslužne i od 30 sekundi do 15 minuta za autentifikaciju. Poruka koja se ne može isporučiti unutar svog TTL-a se odbacuje. Zato poruka sa statusom sent i bez statusa delivered nakon nekoliko sati obično čeka na telefonu kupca, a nije izgubljena; za kodove i hitna upozorenja postavite kratak TTL da kašnjenje isporuke nikoga ne zbuni.

Što to znači za AI odgovore i automatizacije?

Prvo pročitajte izvršavanje, pa status. U kartici Runs, izvršavanje Skipped ništa nije poslalo i kaže zašto: „Više od 24 sata od zadnje poruke kupca“, „Nedavno ste odgovorili na ovaj razgovor s telefona“ ili „Dosegnuto ograničenje AI odgovora za ovaj razgovor u ovom satu“. Izvršavanje Done znači da je Meta prihvatila svaki odgovor, što nije dokaz isporuke. easyCoexistence ne pohranjuje statuse poruka: uz uključene automatizacije oni stižu na vaš URL za prosljeđivanje ako ga postavite, a u izravnom načinu idu ravno na vaš endpoint. Iz ChatGPT-a ili Claude-a zamolite AI da pokrene get_number_health: vraća trenutačni status, ocjenu kvalitete i zadnjih 15 događaja praćenja, uključujući blok sending s Metinim kodom.

Kako ga postaviti

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

Uobičajene pogreške

  • Ponovni pokušaj nakon 131050. Osoba je prestala primati marketinške poruke od vas; daljnji pokušaji nikad ne stižu i mogu samo dodati negativne signale.
  • Čitanje message id-a kao isporučene poruke. Meta prvo prihvaća, a neuspjehe javlja kasnije, pa tijek rada koji staje na message id-u propušta svaku odbijenu poruku.
  • Slanje slobodnog odgovora dan kasnije. Nakon 24 sata bez poruke kupca prihvaća se samo predložak.
  • Rad bez odredišta webhooka. Neuspjeli statusi stižu samo kao webhookovi, pa se bez njih razlog zašto poruka nije stigla gubi.
Radite ovo uz EasyCoexistence

Vaš AI može provjeriti broj iz ChatGPT-a ili Claude-a alatom get_number_health. Od US$ 9 do US$ 0,75 po povezanom broju mjesečno, a cijena pada kako dodajete brojeve, uz besplatno probno razdoblje od 3 dana.

Često postavljana pitanja

Zašto poruka satima pokazuje jednu kvačicu?

Jedna kvačica je status sent: Meta je poslala poruku, ali telefon je nije primio, obično zato što je isključen ili offline. WhatsApp nastavlja pokušavati dok ne istekne vrijeme života predloška, zadano 30 dana za uslužne i marketinške.

Zašto odgovori stižu, a predlošci ne?

Obično je riječ o problemu s načinom plaćanja na računu WhatsApp Business. Meta isporučuje uslužne poruke unutar besplatnog mjesečnog okvira broja i bez njega, ali predloške ne isporučuje. Dodajte karticu u Billing & payments.

Mogu li vidjeti neuspjele poruke u aplikaciji WhatsApp Business?

Ne pouzdano. Na Coexistence broju poruke poslane putem API-ja pojavljuju se u razgovoru u aplikaciji, ali razlog neuspjeha stiže samo kao kôd pogreške u webhooku statusa.

Naplaćuje li Meta poruke koje nisu isporučene?

Ne. Meta naplaćuje samo isporučene poruke, a pokušaji s pauziranim predloškom također se ne naplaćuju.

Nastavite čitati

Spremni za početak?

Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.

Započnite besplatno probno razdoblje

Provjereno na