Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

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ä.

131047

Yli 24 tuntia on kulunut siitä, kun vastaanottaja viimeksi vastasi; Metan ratkaisu on lähettää viestipohja.

131049

Ei toimitettu, jotta ekosysteemin sitoutuminen pysyy terveenä; odota vähintään 24 tuntia ennen markkinointipohjan lähettämistä uudelleen.

131050

Vastaanottaja on valinnut lopettaa yrityksen markkinointiviestit; Meta ohjeistaa olemaan yrittämättä uudelleen.

No contacts

Failed-tila jättää pois contacts-taulukon, joten virhe yhdistetään statuses.id-kentän kautta.

Delivered

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:

Meta's example: a message that failed with 131049
{
  "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ä:

131026Undeliverable: not a WhatsApp number, terms not accepted, or an outdated WhatsApp version on the recipient's phone.
131047More than 24 hours since the customer last wrote. Send an approved template instead.
131049Held back to keep engagement healthy, usually the per-user marketing limit. Wait 24 hours or more.
131050The customer stopped marketing messages from you. Do not retry.
131042A problem with the payment method on the WhatsApp Business Account.
130472Not sent because the recipient is part of Meta's marketing message experiment.
131053Media could not be uploaded, often an unsupported file type.
131000Unknown error. Try again; if it persists, open a Direct Support ticket.

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_preferences resume -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.
Näin teet tämän EasyCoexistencen avulla

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 kokeilu

Vahvistettu