Zašto WhatsApp poruka nije uspjela: čitanje statusa failed i pogrešaka
Webhook za status failed znači da Meta nije mogla poslati ili isporučiti poruku koju je tvrtka poslala putem API-ja. Stiže na polju messages sa statusom failed i nizom errors koji sadrži code, title, message, error_data.details i href. Kôd daje razlog: 131047 zatvoren prozor, 131026 nedostavljivo, 131049 ograničenje marketinških poruka, 131050 marketinške poruke zaustavljene, 131042 problem s plaćanjem.
easyCoexistence povezuje vaš broj iz aplikacije WhatsApp Business s Metinim Cloud API-jem putem značajke Coexistence i prosljeđuje neuspjele statuse vašem poslužitelju, izravno ili kao potpisane prosljeđe kada su automatizacije uključene.
Prošlo je više od 24 sata otkako je primatelj zadnji put odgovorio; Meta predlaže slanje predloška umjesto toga.
Nije isporučeno kako bi se održao zdrav angažman u ekosustavu; pričekajte najmanje 24 sata prije ponovnog slanja marketinškog predloška.
Primatelj je odabrao zaustaviti marketinške poruke od tvrtke; Meta kaže da se ne pokušava ponovno.
Neuspjeli status ne sadrži niz contacts, pa neuspjeh povežite preko statuses.id.
Meta naplaćuje poruke kad su isporučene, a ne kad su poslane.
Kako izgleda neuspjeli status?
Kao i svaki status, uz dodatak errors. Niz contacts izostaje, recipient_user_id se ne pojavljuje kada je poruka poslana na broj telefona i nema objekta pricing. title i message nose isti tekst, error_data.details objašnjava to u jednoj rečenici, a href upućuje na Metin popis kôdova pogrešaka. Ovo je Metin vlastiti primjer, predložak za marketing zaustavljen ograničenjem 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 se kôdovi pogrešaka najčešće vraćaju i što znače?
Meta vraća pogreške u odgovoru na slanje, u neuspjelom statusu ili u oba, pa isti kôd može doći bilo kojim putem, a vaš handler treba čitati oba mjesta. Ovo su kôdovi koji objašnjavaju većinu poruka koje nikad ne stignu, s Metinim vlastitim razlogom i prvom stvari koju treba isprobati; cijeli popis nalazi se u Metinoj referenci kôdova pogrešaka:
Kako handler treba reagirati na svaku vrstu neuspjeha?
Prije bilo kakvog ponovnog pokušaja razvrstajte kôd prema tome što slijedi. Općenito ponavljanje pretvara odjavu od marketinga u ponovljene neuspjehe i može produljiti blokadu, dok odbacivanje privremene pogreške gubi poruku koja bi prošla minutu kasnije.
- Ponovno pokušajte s postupnim produljivanjem razmaka: 131000 nepoznato, 131016 usluga nedostupna, 130429 dosegnuta propusnost.
- Prvo pričekajte: 131049, najmanje 24 sata, jer rani pokušaji mogu blokirati tog korisnika još do 24 sata.
- Promijenite poruku: 131047 zahtijeva odobreni predložak, jer je 24-satni prozor zatvoren.
- Zaustavite za ovog kupca: 131050, dok ne stigne resume iz
user_preferences. - Popravite račun ili sadržaj: 131042 plaćanje, 131031 ograničen račun, 131053 mediji.
Koji se neuspjesi pojavljuju samo kao neuspjeli status?
Oni koje Meta odlučuje nakon što prihvati zahtjev. Slanje vraća wamid, a odbijanje dolazi kasnije na ovom webhooku. Meta ne isporučuje marketinške predloške na WhatsApp brojeve iz Sjedinjenih Američkih Država (+1 s američkim pozivnim brojem), a marketinški predložak kupcu koji je zaustavio marketinške poruke obrađuje se i zatim prijavljuje kao neuspjeli s kôdom 131050, a ograničenje po korisniku prijavljuje 131049 na isti način.
Ako broj nema odredište webhooka, ti neuspjesi završe tamo gdje ih ne vidite i poruka jednostavno izgleda kao poslana. Puni redoslijed provjera kada kupac ništa nije dobio pogledajte na stranici o WhatsApp API porukama koje nisu isporučene.
Što se mijenja na Coexistence broju?
Dvije stvari su važne. Prvo, 24-satni prozor obvezuje samo API. Metin vodič za Coexistence navodi da se poruke poslane iz aplikacije WhatsApp Business ne podliježu prozoru za korisničku podršku, pa vlasnik nakon 131047 još može odgovoriti tom kupcu s telefona, dok vaš sustav šalje odobreni predložak.
Drugo, propusnost je fiksna. Broj koji se istodobno koristi u aplikaciji i API-ju šalje najviše 20 poruka u sekundi, a prelazak te granice vraća 130429. Sve ostalo izgleda isto kao na bilo kojem Cloud API broju: isto polje, isti niz errors, isti kôdovi.
Kako automatizacije i vaš AI vide neuspjeh?
Ovisi o tome kada Meta kaže ne. Odbijanje u trenutku slanja, poput 131047, obara korak automatizacije: pokretanje se prikazuje kao Failed s Metinom porukom na kartici Runs, a vlasnik dobiva e-poštu kako bi sam odgovorio tom kupcu. Automatizacije također provjeravaju prozor prije slobodnog odgovora i preskaču s window_closed umjesto da pokušaju.
Neuspjeh koji Meta prijavi naknadno stiže kao neuspjeli status na vaš Forward URL ili izravno odredište, a pokretanje ostaje kakvo je bilo. AI koji je poslao predložak putem MCP konektora vidi wamid i "sent: true"; zatražite od svog sustava status tog wamida ili neka asistent pokrene get_number_health kada mnoge poruke istodobno ne uspijevaju.
Uobičajene pogreške
- Ponavljanje 131050 u petlji. Kupac je zaustavio marketinške poruke, pa svaki pokušaj ne uspijeva na isti način dok se ne vrati.
- Ponovno slanje marketinškog predloška 131049 unutar nekoliko sati. Meta traži najmanje 24 sata, a rani pokušaji mogu blokirati tog korisnika još do 24 sata.
- Bilježenje samo naslova. error_data.details nosi konkretan razlog, pa spremite kôd i detalje zajedno s wamidom.
- Rad bez odredišta webhooka i procjena isporuke prema odgovoru na slanje, koji samo kaže da je Meta prihvatila poruku.
Kada je odgovor automatizacije odbijen u trenutku slanja, pokretanje prikazuje Metinu pogrešku i dobivate e-poštu, a svaki broj nadzire se 24/7 zbog prekida i pada kvalitete. Od US$ 9 do US$ 0,75 po broju mjesečno, a cijena pada kako dodajete brojeve, uz besplatno probno razdoblje od 3 dana.
Često postavljana pitanja
Naplaćuje li Meta neuspjelu poruku?
Metine stranice o cijenama kažu da naplaćuje poruke koje su isporučene, a ne poruke koje su samo poslane. Neuspjeli status ne nosi objekt pricing. Naplata ide na vlastiti WhatsApp Business račun tvrtke; easyCoexistence nikad ne dodaje maržu.
Znači li 131026 da je kupac blokirao tvrtku?
Metin popis za 131026 navodi druge razloge: broj nije na WhatsAppu, primatelj nije prihvatio najnovije uvjete ili je njegova verzija WhatsAppa prestara. Meta predlaže da to provjerite pitanjem kupca preko drugog kanala.
Zašto se recipient_user_id pojavljuje kod nekih neuspjeha, a kod drugih ne?
Meta ga izostavlja u neuspjelom statusu kada je poruka poslana na broj telefona. Kada ste slali na BSUID kupca, neuspjeh ga uključuje, a može nedostajati recipient_id.
Može li poruka ne uspjeti nakon što je isporučena?
Metina referenca opisuje failed kao neuspjeh slanja ili isporuke. Kada poruka stigne na uređaj, sljedeći statusi koje možete očekivati su read ili, za glasovne poruke, played.
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 razdobljeProvjereno na