Zašto WhatsApp poruka nije stigla: čitanje statusa failed i njegovih grešaka
Failed status webhook znači da Meta nije mogla da pošalje ili isporuči poruku koju je firma poslala preko API-ja. Stiže na polju messages sa statusom failed i nizom errors koji sadrži code, title, message, error_data.details i href. Kod kaže razlog: 131047 prozor zatvoren, 131026 nedostavljivo, 131049 limit za marketing, 131050 marketing zaustavljen, 131042 problem sa plaćanjem.
easyCoexistence povezuje vaš broj iz WhatsApp Business aplikacije sa Metinim Cloud API-jem preko Coexistence i prosleđuje failed statuse vašem serveru, direktno ili kao potpisane prosleđene poruke kada su automatizacije uključene.
Prošlo je više od 24 sata od poslednjeg odgovora primaoca; Metino rešenje je da pošaljete šablon.
Nije isporučeno da bi se očuvao zdrav angažman u ekosistemu; sačekajte najmanje 24 sata pre ponovnog slanja marketing šablona.
Primalac je izabrao da prestane da prima marketing poruke od firme; Meta kaže da ne pokušavate ponovo.
Failed status ne sadrži niz contacts, pa neuspeh povežite preko statuses.id.
Meta naplaćuje poruke kada su isporučene, a ne kada su poslate.
Kako izgleda failed status?
Kao svaki status, uz errors. Niz contacts nedostaje, recipient_user_id je izostavljen kada je poruka poslata na broj telefona, i nema objekta pricing. title i message nose isti tekst, error_data.details to objašnjava u rečenici, a href vodi na Metinu listu kodova grešaka. Ovo je Metin sopstveni primer, šablon za marketing zaustavljen limitom po korisniku:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"statuses": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0QUQ2MjA4NEYyRkExNjMyREUA",
"status": "failed",
"timestamp": "1751142888",
"recipient_id": "16505551234",
"errors": [
{
"code": 131049,
"title": "This message was not delivered to maintain healthy ecosystem engagement.",
"message": "This message was not delivered to maintain healthy ecosystem engagement.",
"error_data": {
"details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
},
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
}
]
}
]
},
"field": "messages"
}
]
}
]
}Koji kodovi grešaka se najčešće vraćaju i šta znače?
Meta vraća greške u odgovoru na slanje, u failed statusu ili u oba, pa isti kod može stići na bilo koji način, a vaš handler treba da čita oba mesta. Ovo su kodovi koji objašnjavaju većinu poruka koje nikada ne stignu, sa Metinim razlogom i prvom stvari koju treba probati; kompletna lista je u Metinoj referenci kodova grešaka:
Kako handler treba da reaguje na svaku vrstu greške?
Svrstajte kod u sledeći korak pre bilo kakvog ponovnog pokušaja. Slepo ponavljanje pretvara odjavu od marketinga u uzastopne greške i može produžiti blokadu, dok odbacivanje privremene greške gubi poruku koja bi prošla minut kasnije.
- Ponovo sa backoff-om: 131000 nepoznato, 131016 servis nedostupan, 130429 dostignut protok.
- Prvo sačekajte: 131049, najmanje 24 sata, jer rani pokušaji mogu blokirati tog korisnika još do 24 sata.
- Promenite poruku: 131047 zahteva odobren šablon, jer je 24-satni prozor zatvoren.
- Zaustavite za ovog kupca: 131050, dok ne stigne
user_preferencesresume. - Popravite nalog ili sadržaj: 131042 plaćanje, 131031 nalog ograničen, 131053 mediji.
Koji neuspesi se pojavljuju samo kao failed status?
Oni koje Meta odlučuje nakon što prihvati zahtev. Slanje vraća wamid, a odbijanje stiže kasnije na ovom webhooku. Meta ne isporučuje marketing šablone korisnicima WhatsApp-a sa američkim brojevima telefona (+1 sa američkim pozivnim brojem), a marketing šablon kupcu koji je prestao da prima marketing poruke se obradi, pa prijavi kao neuspeo sa 131050, i limit po korisniku prijavljuje 131049 na isti način.
Ako broj nema odredište za webhook, ovi neuspesi ne završavaju nigde gde možete da ih vidite, i poruka jednostavno izgleda poslata. Za kompletan redosled provera kada kupac nije ništa dobio, pogledajte stranicu o WhatsApp API porukama koje nisu isporučene.
Šta se menja na Coexistence broju?
Dve stvari su važne. Prvo, prozor od 24 sata obavezuje samo API. Metino uputstvo za Coexistence kaže da se poruke poslate iz WhatsApp Business aplikacije ne podležu prozoru za korisničku podršku, pa posle 131047 vlasnik i dalje može da odgovori tom kupcu sa telefona, dok vaš sistem šalje odobreni šablon.
Drugo, protok je fiksiran. Broj koji se koristi u aplikaciji i API-ju istovremeno šalje najviše 20 poruka u sekundi, a prelazak preko toga vraća 130429. Sve ostalo izgleda isto kao na bilo kom Cloud API broju: isto polje, isti niz errors, isti kodovi.
Kako automatizacije i vaš AI vide neuspeh?
Zavisi od toga kada Meta kaže ne. Odbijanje u trenutku slanja, kao 131047, pada korak automatizacije: pokretanje se prikazuje kao Failed sa Metinom porukom na kartici Runs, a vlasnik dobija e-mail da kupcu sam odgovori. Automatizacije takođe proveravaju prozor pre slobodnog odgovora i preskaču ga sa window_closed umesto da pokušaju.
Neuspeh koji Meta prijavi kasnije stiže kao failed status na vaš Forward URL ili direktno odredište, a pokretanje ostaje kakvo je bilo. AI koji je poslao šablon preko MCP konektora vidi wamid i "sent: true"; zatražite od sistema status tog wamid-a ili neka asistent pokrene get_number_health kada mnogo poruka istovremeno padne.
Česte greške
- Ponavljanje 131050 u petlji. Kupac je prestao da prima marketing poruke, pa svaki pokušaj propada na isti način dok se ne vrati.
- Ponovno slanje 131049 marketing šablona u roku od nekoliko sati. Meta traži najmanje 24 sata, a rani pokušaji mogu blokirati tog korisnika još do 24 sata.
- Beleženje samo polja title. error_data.details nosi konkretan razlog, pa sačuvajte kod i detalje zajedno sa wamid-om.
- Rad bez odredišta za webhook i procena isporuke na osnovu odgovora na slanje, koji samo kaže da je Meta prihvatila poruku.
Kada odgovor automatizacije bude odbijen u trenutku slanja, run prikazuje Metinu grešku i dobijate e-mail, a svaki broj se prati 24/7 zbog prekida veze i pada kvaliteta. Od US$ 9 do US$ 0.75 po broju mesečno, uz sniženje kako dodajete brojeve, a prvi 3 dana su besplatno.
Često postavljana pitanja
Da li Meta naplaćuje neuspelu poruku?
Cenovnici Mete kažu da se naplaćuju poruke koje su isporučene, a ne poruke koje su samo poslate. Failed status ne nosi objekat pricing. Naplata ide na sopstveni WhatsApp Business nalog firme; easyCoexistence je nikada ne uvećava.
Da li 131026 znači da je kupac blokirao firmu?
Metin spisak za 131026 navodi druge razloge: broj nije na WhatsApp-u, primalac nije prihvatio najnovije uslove, ili je njegova verzija WhatsApp-a previše stara. Meta predlaže da to proverite kod kupca preko drugog kanala.
Zašto se recipient_user_id pojavljuje kod nekih neuspeha, a kod drugih ne?
Meta ga izostavlja u failed statusu kada je poruka poslata na broj telefona. Kada ste slali na BSUID kupca, neuspeh ga uključuje, a može nedostajati recipient_id.
Može li poruka da padne nakon što je isporučena?
Metina referenca opisuje failed kao neuspeh slanja ili isporuke. Kada poruka stigne na uređaj, sledeći statusi koje možete očekivati su read, ili played za glasovne poruke.
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