WhatsApp API poruka nije isporučena: uzroci, po redosledu
Prihvaćena WhatsApp API poruka nije isto što i isporučena. Meta ishod prijavljuje kasnije, u webhooku statusa, kao sent, delivered, read ili failed, uz kod greške. Proverite redom: status failed i njegov kod, 24-satni prozor (131047), način plaćanja (131042), šablon (132001, 132015), primaoca (131026, 131049, 131050), pa zatim limite i vezu broja.
easyCoexistence neprekidno prati svaki povezan broj, šalje vam e-poštu kada Meta prestane da isporučuje, prekine vezu ili spusti kvalitet, i prosleđuje Metine webhookove statusa nepromenjene vašem sistemu.
sent (jedna kvačica), delivered (dve), read (dve plave) i failed (crveni trougao upozorenja), kako ih prijavljuju webhookovi statusa.
Prošlo je više od 24 sata od poslednjeg odgovora primaoca; Meta kaže da tada treba poslati šablon.
Nije moguće isporučiti: broj nije na WhatsApp-u, primalac nije prihvatio nove uslove ili koristi staru verziju WhatsApp-a.
Podrazumevano vreme u kojem WhatsApp ponavlja isporuku neisporučenog uslužnog ili marketinškog šablona pre odustajanja; za šablone za autentifikaciju podrazumevano je 10 minuta.
Fiksni propusni kapacitet broja koji se koristi i u aplikaciji WhatsApp Business i u Cloud API-ju.
Zašto prihvaćena poruka ipak ne stigne?
Zato što su odgovor API-ja i isporuka dva odvojena događaja. Kada šaljete, Meta vraća ID poruke čim prihvati zahtev; to da li poruka stiže na telefon kupca dolazi kasnije, u webhooku statusa na polju messages. sent znači da je napustila Metine servere (jedna kvačica), delivered da je stigla na uređaj (dve), read da je otvorena (dve plave), a failed da ne može biti poslata ili isporučena, što vam se prikazuje u nizu errors: code, title i error_data.details. Zato prvo ne nagađajte: nađite status failed za taj ID poruke i pročitajte njegov kod. Ako nemate odredište za webhook, ništa to ne beleži.
Koji su uzroci, redom kojim ih treba proveriti?
Od najčešćeg na novopovezanom broju do najređeg. Svaki red navodi Metin kod, pa status failed pokazuje u kom ste:
- Prozor zatvoren: 131047, više od 24 sata od poslednjeg pisanja kupca. Poruke slobodnog teksta zahtevaju otvoren prozor; pošaljite šablon.
- Plaćanje: 131042, ili šabloni tiho odbačeni. Od 1. oktobra 2026. uslužne poruke takođe prestaju kada se potroši 1.000 poruka mesečno bez načina plaćanja.
- Šablon: 132001 nije odobren ili je pogrešan jezik, 132000 pogrešan broj promenljivih, 132012 pogrešan format, 132015 pauziran, 132016 onemogućen.
- Primalac: 131026 nije na WhatsApp-u, stara verzija ili uslovi nisu prihvaćeni; 131050 zaustavio marketinške poruke; 131049 zadržano radi zdravog angažmana; marketinški šabloni za američke brojeve se ne isporučuju.
- Limiti: 131048 ograničen posle signala o spamu, 131056 previše poruka jednoj osobi, 130429 propusni kapacitet, 20 poruka u sekundi na Coexistence broju.
- Nalog: 131031 ili 368, WhatsApp Business nalog ograničen ili onemogućen zbog kršenja pravila.
- Veza: broj više nije povezan, na primer posle 14 dana bez otvaranja aplikacije WhatsApp Business.
Kako se postupa sa kodovima na strani primaoca?
Drugačije, jer neki zaslužuju ponovni pokušaj, a neki nikada. 131050 znači da je osoba izabrala da prestane da prima marketinške poruke od vas: Meta kaže da se ne pokušava ponovo, a webhook user_preferences javlja kada se prekida ili nastavlja. 131049 je Meta koja zadržava marketinšku poruku da bi angažman ostao zdrav, često kao ograničenje po korisniku za marketinške šablone: Meta savetuje da se sačeka najmanje 24 sata pre ponovnog slanja, jer ranije slanje samo vraća istu grešku. 131026 obuhvata brojeve koji nisu na WhatsApp-u, korisnike koji nisu prihvatili aktuelne uslove WhatsApp-a i veoma stare verzije aplikacije; prvo proverite format broja i pozivni kod zemlje, pa kupca pitajte preko drugog kanala.
Koliko dugo WhatsApp pokušava da isporuči?
Do isteka vremena života (time to live) poruke. Kada je telefon isključen ili van dometa, WhatsApp ponavlja isporuku umesto da odmah ne uspe: podrazumevano 30 dana za uslužne i marketinške šablone, a 10 minuta za šablone za autentifikaciju. Preduzeće to može skratiti po šablonu parametrom message_send_ttl_seconds, od 30 sekundi do 12 sati za uslužne, odnosno od 30 sekundi do 15 minuta za autentifikaciju. Poruka koja se ne može isporučiti u okviru svog TTL-a se odbacuje. Zato poruka sa statusom sent i bez statusa delivered posle nekoliko sati obično čeka na telefonu kupca, a nije izgubljena; za kodove i hitna upozorenja postavite kratak TTL da kasna isporuka nikoga ne zbuni.
Šta ovo znači za AI odgovore i automatizacije?
Prvo pročitajte izvršavanje, pa status. Na kartici Runs, izvršavanje sa oznakom Skipped nije poslalo ništa i kaže zašto: „Prošlo je više od 24 sata od poslednje poruke kupca", „Nedavno ste odgovorili na ovaj čet sa telefona" ili „Dostignut je AI limit odgovora za ovaj čet u ovom satu". Izvršavanje sa oznakom Done znači da je Meta prihvatila svaki odgovor, što nije dokaz isporuke. easyCoexistence ne čuva statuse poruka: uz uključene automatizacije oni stižu na vaš forward URL ako ga postavite, a u direktnom režimu idu ravno na vaš sopstveni endpoint. Iz ChatGPT-ja ili Claude-a zamolite AI da pokrene get_number_health: vraća trenutni status, ocenu kvaliteta i poslednjih 15 događaja praćenja, uključujući blok sending sa Metinim kodom.
Kako da podesite
- 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.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- 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.
Česte greške
- Ponovni pokušaj posle 131050. Osoba je prestala da prima marketinške poruke od vas; dodatni pokušaji se nikada ne isporučuju i mogu samo dodati negativne signale.
- Čitanje ID-ja poruke kao isporuke. Meta prvo prihvata, a neuspehe kasnije prijavljuje, pa tok koji staje na ID-ju propušta svaku odbijenu poruku.
- Slanje odgovora slobodnog teksta dan kasnije. Posle 24 sata bez poruke kupca prihvata se samo šablon.
- Rad bez odredišta za webhook. Neuspeli statusi stižu samo kao webhookovi, pa bez njih razlog zašto poruka nije stigla se gubi.
Vaš AI može proveriti broj iz ChatGPT-ja ili Claude-a pomoću get_number_health. Od US$ 9 do US$ 0.75 po broju mesečno, a cena pada kako dodajete brojeve, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Zašto je poruka satima pokazivala jednu kvačicu?
Jedna kvačica je status sent: Meta ju je poslala, ali telefon je nije primio, obično zato što je isključen ili van mreže. WhatsApp nastavlja da pokušava dok ne istekne vreme života šablona, podrazumevano 30 dana za uslužne i marketinške.
Zašto odgovori stižu, a šabloni ne?
Obično je problem sa načinom plaćanja na WhatsApp Business nalogu. Meta isporučuje uslužne poruke u okviru besplatnog mesečnog nivoa broja i bez načina plaćanja, ali ne isporučuje šablone. Dodajte karticu u Billing & payments.
Mogu li videti neuspele poruke u aplikaciji WhatsApp Business?
Ne pouzdano. Na Coexistence broju poruke poslate preko API-ja se pojavljuju u niti razgovora u aplikaciji, ali razlog neuspeha stiže samo kroz kod greške u webhooku statusa.
Da li Meta naplaćuje poruke koje nisu isporučene?
Ne. Meta naplaćuje samo isporučene poruke, a pokušaji sa pauziranim šablonom se takođe ne naplaćuju.
Nastavite sa čitanjem
Spremni da počnete?
Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.
Započnite besplatni probni periodProvereno na