Miksi WhatsApp-viesti epäonnistui: failed-tilan ja sen virheiden lukeminen
Failed-webhook tarkoittaa, että Meta ei voinut lähettää tai toimittaa yrityksen API:n kautta lähettämää viestiä. Se saapuu messages-kenttään, jossa status on failed ja errors-taulukko sisältää kentät code, title, message, error_data.details ja href. Koodi kertoo syyn: 131047 ikkuna suljettu, 131026 ei toimitettavissa, 131049 markkinointiraja, 131050 markkinointi lopetettu, 131042 maksuongelma.
easyCoexistence yhdistää WhatsApp Business -sovelluksen numerosi Metan Cloud API:in Coexistencen kautta ja välittää failed-tilat palvelimellesi, suoraan tai allekirjoitettuina Forward-välityksinä, kun automaatiot ovat käytössä.
Yli 24 tuntia on kulunut siitä, kun vastaanottaja viimeksi vastasi; Metan ratkaisu on lähettää viestipohja.
Ei toimitettu, jotta ekosysteemin sitoutuminen pysyy terveenä; odota vähintään 24 tuntia ennen markkinointipohjan lähettämistä uudelleen.
Vastaanottaja on valinnut lopettaa yrityksen markkinointiviestit; Meta ohjeistaa olemaan yrittämättä uudelleen.
Failed-tila jättää pois contacts-taulukon, joten virhe yhdistetään statuses.id-kentän kautta.
Meta veloittaa viesteistä, kun ne on toimitettu, ei kun ne on lähetetty.
Miltä failed-tila näyttää?
Kuten mikä tahansa tila, mutta lisäksi errors. contacts-taulukko puuttuu, recipient_user_id jätetään pois, kun viesti lähetettiin puhelinnumeroon, eikä hinnoittelun objektia ole. title ja message sisältävät saman tekstin, error_data.details selittää sen yhdessä lauseessa ja href osoittaa Metan virhekoodilistaan. Tämä on Metan oma esimerkki: markkinointipohja, jonka käyttäjäkohtainen raja pysäytti:
{
"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"
}
]
}
]
}Mitkä virhekoodit tulevat useimmin ja mitä ne tarkoittavat?
Meta palauttaa virheet joko lähetysvastauksessa, failed-tilassa tai molemmissa, joten sama koodi voi tulla kumpaa kautta tahansa, ja käsittelijän tulee lukea molemmat paikat. Nämä koodit selittävät suurimman osan viesteistä, jotka eivät koskaan saavu, Metan oman syyn ja ensimmäisen kokeiltavan asian kanssa. Koko lista on Metan virhekoodiviitteessä:
Miten käsittelijän tulee reagoida kuhunkin virhetyyppiin?
Lajittele koodi sen mukaan, mitä tehdään seuraavaksi, ennen kuin mitään yritetään uudelleen. Yleinen uudelleenyritys muuttaa markkinoinnista kieltäytymisen toistuviksi virheiksi ja voi pidentää estoa, kun taas tilapäisen virheen hylkääminen menettää viestin, joka olisi mennyt perille minuutin päästä.
- Yritä uudelleen viiveellä: 131000 tuntematon, 131016 palvelu ei käytettävissä, 130429 läpäisyraja saavutettu.
- Odota ensin: 131049, vähintään 24 tuntia, koska varhaiset uudelleenyritykset voivat estää käyttäjän jopa 24 tuntia lisää.
- Vaihda viestityyppi: 131047 vaatii hyväksytyn viestipohjan, koska 24 tunnin ikkuna on suljettu.
- Lopeta tälle asiakkaalle: 131050, kunnes saapuu
user_preferencesresume -ilmoitus. - Korjaa tili tai sisältö: 131042 maksu, 131031 tili rajoitettu, 131053 media.
Mitkä virheet näkyvät vain failed-tilana?
Ne, jotka Meta päättää pyynnön hyväksymisen jälkeen. Lähetys palauttaa wamid-tunnuksen, ja hylkäys tulee myöhemmin tälle webhookille. Meta ei toimita markkinointipohjia WhatsApp-käyttäjille, joilla on Yhdysvaltain puhelinnumero (+1 Yhdysvaltain suuntanumerolla). Markkinointipohja asiakkaalle, joka lopetti markkinointiviestit, käsitellään ja raportoidaan sitten virheellä 131050, ja käyttäjäkohtainen markkinointiraja raportoi 131049 samalla tavalla.
Jos numerolla ei ole webhook-kohdetta, nämä virheet eivät näy missään ja viesti näyttää vain lähetetyltä. Täydelliset tarkistusjärjestykset asiakkaalle, joka ei saanut mitään, löydät sivulta ”WhatsApp API -viestit eivät toimitu”.
Mitä muuttuu Coexistence-numerolla?
Kaksi asiaa on tärkeää. Ensinnäkin 24 tunnin ikkuna koskee vain API:a. Metan Coexistence-opas sanoo, että WhatsApp Business -sovelluksesta lähetettyihin viesteihin ei sovelleta asiakaspalveluikkunaa, joten 131047:n jälkeen omistaja voi yhä vastata asiakkaalle puhelimesta, kun järjestelmäsi lähettää hyväksytyn viestipohjan.
Toiseksi läpäisy on kiinteä. Numero, jota käytetään samanaikaisesti sovelluksessa ja API:ssa, lähettää enintään 20 viestiä sekunnissa, ja sen ylittäminen palauttaa 130429. Muu on sama kuin missä tahansa Cloud API -numerossa: sama kenttä, sama errors-taulukko, samat koodit.
Miten automaatiot ja tekoälysi näkevät virheen?
Se riippuu siitä, milloin Meta sanoo ei. Lähetyshetkellä tuleva hylkäys, kuten 131047, pysäyttää automaation vaiheen: ajossa näkyy Failed ja Metan viesti Runs-välilehdellä, ja omistaja saa sähköpostin, jotta hän voi vastata asiakkaalle itse. Automaatiot tarkistavat myös ikkunan ennen vapaamuotoisen vastauksen lähettämistä ja ohittavat vaiheen tilalla window_closed eivätkä yritä lähettää.
Metan jälkikäteen raportoima virhe saapuu failed-tilana Forward URL -osoitteeseen tai suoraan kohteeseen, ja ajo jää ennalleen. Tekoäly, joka lähetti pohjan MCP-liitännän kautta, näkee wamid-tunnuksen ja ”sent: true”. Pyydä järjestelmältäsi tämän wamid-tunnuksen tila tai pyydä avustajaa ajamaan get_number_health, kun monta viestiä epäonnistuu kerralla.
Yleiset virheet
- Yritetään 131050 uudelleen silmukassa. Asiakas lopetti markkinointiviestit, joten jokainen yritys epäonnistuu samalla tavalla, kunnes hän jatkaa.
- Lähetetään 131049-markkinointipohja uudelleen muutamassa tunnissa. Meta pyytää vähintään 24 tuntia, ja varhaiset yritykset voivat estää käyttäjän jopa 24 tuntia lisää.
- Pelkän title-kentän kirjaaminen. error_data.details kertoo tarkan syyn, joten tallenna code ja details yhdessä wamid-tunnuksen kanssa.
- Toimitusta arvioidaan lähetysvastauksesta ilman webhook-kohdetta. Vastaus kertoo vain, että Meta hyväksyi viestin.
Kun automaation vastaus hylätään lähetyshetkellä, ajo näyttää Metan virheen ja saat sähköpostin, ja jokaista numeroa valvotaan 24/7 katkosten ja laatuheikkenemisten varalta. US$ 9:stä US$ 0,75:een per numero kuukaudessa, hinta laskee numeroiden lisääntyessä, ja ensimmäiset 3 päivää ovat ilmaista kokeilua.
Usein kysytyt kysymykset
Veloittaako Meta epäonnistuneesta viestistä?
Metan hinnoittelusivut kertovat, että se veloittaa toimitetuista viesteistä, ei pelkästään lähetetyistä. Failed-tilassa ei ole hinnoittelun objektia. Veloitukset menevät yrityksen omalle WhatsApp Business Account -tilille, eikä easyCoexistence koskaan lisää niihin mitään.
Tarkoittaako 131026, että asiakas esti yrityksen?
Metan 131026-lista nimeää muita syitä: numero ei ole WhatsAppissa, vastaanottaja ei ole hyväksynyt uusimpia ehtoja tai hänen WhatsApp-versionsa on liian vanha. Meta neuvoo kysymään asiakkaalta näiden tarkistamista toisen kanavan kautta.
Miksi recipient_user_id näkyy joillakin virheillä ja toisilla ei?
Meta jättää sen failed-tilasta pois, kun viesti lähetettiin puhelinnumeroon. Kun lähetit viestin BSUID-tunnuksella, virhe sisältää sen, ja recipient_id voi puuttua.
Voiko viesti epäonnistua toimituksen jälkeen?
Metan viite kuvaa failed-tilan lähettämisen tai toimittamisen epäonnistumiseksi. Kun viesti on saavuttanut laitteen, seuraavat odotettavat tilat ovat read tai äänilähetyksissä played.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu