Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsApp API -viesti ei toimitettu: syyt järjestyksessä

Hyväksytty WhatsApp API -viesti ei ole vielä toimitettu: Meta ilmoittaa lopputuloksen myöhemmin status-webhookissa tiloina lähetetty, toimitettu, luettu tai epäonnistunut, virhekoodin kanssa. Tarkista järjestyksessä: epäonnistunut tila ja sen koodi, 24 tunnin ikkuna (131047), maksutapa (131042), viestipohja (132001, 132015), vastaanottaja (131026, 131049, 131050), sitten numeron rajat ja yhteys.

easyCoexistence valvoo jokaista yhdistettyä numeroa vuorokauden ympäri, lähettää sähköpostia, kun Meta lopettaa toimitukset, linkki katkeaa tai laatu laskee, ja välittää Metan status-webhookit muuttamattomina järjestelmääsi.

4 statuses

lähetetty (yksi rasti), toimitettu (kaksi rastia), luettu (kaksi sinistä rastia) ja epäonnistunut (punainen virhekolmio), sellaisina kuin status-webhookit ne raportoivat.

131047

Yli 24 tuntia on kulunut siitä, kun vastaanottaja vastasi viimeksi; Meta suosittaa lähettämään sen sijaan viestipohjan.

131026

Toimitus ei onnistu: numero ei ole WhatsAppissa, vastaanottaja ei ole hyväksynyt uusia ehtoja tai hänellä on vanha WhatsApp-versio.

30 days

Oletusaika, jonka WhatsApp yrittää toimittaa toimittamatonta hyödyllisyys- tai markkinointiviestipohjaa uudelleen ennen sen hylkäämistä; todennusviestipohjilla oletus on 10 minuuttia.

20 mps

Kiinteä läpimenonopeus numerolle, jota käytetään sekä WhatsApp Business -sovelluksessa että Cloud API:ssa.

Miksi hyväksytty viesti ei silti saavu perille?

Koska API:n vastaus ja toimitus ovat kaksi erillistä tapahtumaa. Kun lähetät viestin, Meta palauttaa viestitunnuksen heti, kun se hyväksyy pyynnön. Se, saapuuko viesti asiakkaan puhelimeen, selviää myöhemmin messages-kentän status-webhookissa. sent tarkoittaa, että viesti lähti Metan palvelimilta (yksi rasti), delivered että se tavoitti laitteen (kaksi rastia), read että se avattiin (kaksi sinistä rastia) ja failed että sitä ei voitu lähettää tai toimittaa. Tämä näkyy sinulle errors-taulukossa kenttinä code, title ja error_data.details. Ensimmäinen askel ei siis ole arvailu: etsi kyseisen viestitunnuksen epäonnistunut tila ja lue sen koodi. Jos sinulla ei ole webhook-kohdetta, mitään ei tallennu.

Mitkä ovat syyt tarkistusjärjestyksessä?

Yleisimmistä uudella yhdistetyllä numerolla esiintyvistä aina harvinaisimpiin. Jokainen rivi nimeää Metan koodin, joten epäonnistunut tila kertoo, missä tilanteessa olet:

  • Ikkuna suljettu: 131047, yli 24 tuntia siitä, kun asiakas kirjoitti viimeksi. Vapaamuotoiset viestit vaativat auki olevan ikkunan; lähetä viestipohja.
  • Maksutapa: 131042, tai viestipohjat pudotetaan hiljaa. 1. lokakuuta 2026 alkaen myös palveluviestit lakkaavat, kun kuukaudessa on käytetty 1 000 ilman maksutapaa.
  • Viestipohja: 132001 ei hyväksytty tai väärä kieli, 132000 väärä muuttujien määrä, 132012 väärä muoto, 132015 keskeytetty, 132016 poistettu käytöstä.
  • Vastaanottaja: 131026 ei ole WhatsAppissa, vanha versio tai ehtoja ei ole hyväksytty; 131050 markkinointiviestit on lopetettu; 131049 pidätetty sitoutumisen turvaamiseksi; markkinointiviestipohjia ei toimiteta Yhdysvaltojen numeroihin.
  • Rajat: 131048 rajoitettu roskapostisignaalien vuoksi, 131056 liian monta viestiä yhdelle henkilölle, 130429 läpimenonopeus, 20 viestiä sekunnissa Coexistence-numerolla.
  • Tili: 131031 tai 368, WhatsApp Business -tili rajoitettu tai poistettu käytöstä käytäntörikkomuksen vuoksi.
  • Yhteys: numero ei ole enää linkitetty, esimerkiksi jos WhatsApp Business -sovellusta ei ole avattu 14 päivään.

Miten käsittelet vastaanottajan puolen koodit?

Eri tavalla, koska osa kannattaa yrittää uudelleen ja osa ei koskaan. 131050 tarkoittaa, että henkilö on valinnut lopettaa markkinointiviestisi: Meta sanoo, ettei uudelleenyrityksiä kannata tehdä, ja user_preferences-webhook kertoo, kun he lopettavat tai jatkavat. 131049 on Metan pidättämä markkinointiviesti, jolla turvataan sitoutumisen terveys, usein henkilökohtainen raja markkinointiviestipohjille: Meta suosittaa odottamaan vähintään 24 tuntia ennen uudelleenlähetystä, sillä aiemmin lähettäminen palauttaa vain saman virheen. 131026 kattaa numerot, jotka eivät ole WhatsAppissa, käyttäjät, jotka eivät ole hyväksyneet WhatsAppin nykyisiä ehtoja, ja hyvin vanhat sovellusversiot. Tarkista ensin numeron muoto ja maanumero, ja pyydä sitten asiakasta toisen kanavan kautta.

Kuinka kauan WhatsApp yrittää toimittaa viestiä?

Viestin elinajan (TTL) mukaan. Kun puhelin on sammutettu tai kuuluvuusalueen ulkopuolella, WhatsApp yrittää toimitusta uudelleen sen sijaan, että epäonnistuisi heti: oletuksena 30 päivää hyödyllisyys- ja markkinointiviestipohjilla ja 10 minuuttia todennusviestipohjilla. Yritys voi lyhentää aikaa viestipohjakohtaisesti message_send_ttl_seconds-kentällä, 30 sekunnista 12 tuntiin hyödyllisyysviesteille ja 30 sekunnista 15 minuuttiin todennusviesteille. Viesti, jota ei voida toimittaa elinajan kuluessa, pudotetaan. Jos viestillä on lähetetty-tila mutta ei toimitettu-tilaa tuntien jälkeen, se odottaa yleensä asiakkaan puhelimessa eikä ole kadonnut. Aseta lyhyt TTL koodeille ja aikaherkille hälytyksille, jotta myöhäinen toimitus ei hämmennä ketään.

Mitä tämä tarkoittaa tekoälyvastauksille ja automaatioille?

Lue ensin ajo, sitten tila. Runs-välilehdellä ohitettu ajo (Skipped) ei lähettänyt mitään ja kertoo syyn: "Yli 24 tuntia asiakkaan viimeisestä viestistä", "Vastasit tähän keskusteluun äskettäin puhelimellasi" tai "Tämän keskustelun tekoälyvastausten raja saavutettiin tänä tuntina". Onnistunut ajo (Done) tarkoittaa, että Meta hyväksyi jokaisen vastauksen, mikä ei todista toimitusta. easyCoexistence ei tallenna viestien tiloja: kun automaatiot ovat päällä, ne menevät edelleenlähetys-URL-osoitteeseen, jos asetat sellaisen, ja suoralla tilassa ne menevät suoraan omaan endpointiisi. ChatGPT:stä tai Claudesta pyydä tekoälyäsi ajamaan get_number_health: se palauttaa reaaliaikaisen tilan, laatuluokituksen ja viimeiset 15 valvontatapahtumaa, mukaan lukien sending-lohkon Metan koodilla.

Näin otat sen käyttöön

  1. 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.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. 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.

Yleiset virheet

  • Uudelleenyritys koodin 131050 kohdalla. Henkilö on lopettanut markkinointiviestisi; lisäyritykset eivät koskaan toimitu ja voivat vain lisätä negatiivisia signaaleja.
  • Viestitunnuksen lukeminen toimitetuksi. Meta hyväksyy ensin ja raportoi virheet myöhemmin, joten työnkulku, joka pysähtyy tunnukseen, jää paitsi jokaisesta hylätystä viestistä.
  • Vapaamuotoisen viestin lähettäminen päivä myöhemmin. Yli 24 tunnin asiakkaan hiljaisuuden jälkeen hyväksytään vain viestipohja.
  • Ajo ilman webhook-kohdetta. Epäonnistuneet tilat tulevat vain webhookin kautta, joten ilman kohdetta syy, miksi viesti ei saapunut, katoaa.
Näin teet tämän EasyCoexistencen avulla

Tekoälysi voi tarkistaa numeron ChatGPT:stä tai Claudesta get_number_health-työkalulla. Alkaen US$ 9 yhdistettyä numeroa kohti kuukaudessa, laskien US$ 0,75:een numeroiden lisääntyessä, ja kolmen päivän ilmainen kokeilu.

Usein kysytyt kysymykset

Miksi viesti näytti yhden rastin tunteja?

Yksi rasti on lähetetty-tila: Meta lähetti sen, mutta puhelin ei ole vastaanottanut sitä, yleensä koska se on sammuksissa tai offline-tilassa. WhatsApp yrittää uudelleen, kunnes viestipohjan elinaika loppuu, oletuksena 30 päivää hyödyllisyys- ja markkinointiviestipohjille.

Miksi vastaukset saapuvat, mutta viestipohjat eivät?

Yleensä kyse on maksutavasta WhatsApp Business -tilillä. Meta toimittaa palveluviestit numeron kuukausittaisen ilmaisen tason sisällä ilman maksutapaa, mutta ei toimita viestipohjia. Lisää kortti kohdassa Laskutus ja maksut (Billing & payments).

Voinko nähdä epäonnistuneet viestit WhatsApp Business -sovelluksessa?

Ei luotettavasti. Coexistence-numerolla API:n kautta lähetetyt viestit näkyvät sovelluksen keskusteluketjussa, mutta syy viestin epäonnistumiseen tulee vain status-webhookin virhekoodista.

Veloittaako Meta viesteistä, joita ei toimitettu?

Ei. Meta veloittaa vain toimitetuista viesteistä, eikä yrityksiä veloiteta myöskään keskeytetyllä viestipohjalla lähetetyistä yrityksistä.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu