Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsApp Cloud API -virhekoodit

Tässä ovat kaikki dokumentoimamme WhatsApp Cloud API -virhekoodit yhdessä taulukossa, merkityksineen ja uudelleenyrityksen vaikutuksineen. Useimmat eivät auta: ne ovat deterministisiä, joten sama pyyntö epäonnistuu aina samalla tavalla ja uudelleenyrityssilmukka muuttaa virheellisen pyynnön nopeusrajoitukseksi.

EasyCoexistence valvoo yhteyttä jatkuvasti ja tallentaa Metan tili- ja laatutapahtumat yhteyden aikajanalle.

Emme tallenna viestejä oletuksenaBusiness-sovellus + Cloud APIMCP Claudelle ja ChatGPT:lleKäyttövalmis 2 minuutissa

Pyyntö

KoodiMitä se tarkoittaaUudelleenyritys
100Parametri ei ole tuettu, se on kirjoitettu väärin tai se on virheellinen.Ei
131008Pakollinen parametri puuttuu kokonaan.Ei
131009Parametri on mukana, mutta endpoint hylkää sen arvon.Ei
131021Lähettäjä ja vastaanottaja ovat sama numero.Ei
131051Viestityyppiä ei tueta, usein Coexistence-rajoituksen vuoksi.Ei
131052Meta ei pystynyt lataamaan asiakkaan lähettämää mediaa.Ei
131053Meta ei pystynyt lähettämään lähettämääsi mediaa. Koko, muoto tai saavutettavuus.Ei

Viestipohja

KoodiMitä se tarkoittaaUudelleenyritys
132000Parametrien määrä ei vastaa viestipohjaa.Ei
132001Viestipohjaa tällä nimen ja kielen yhdistelmällä ei ole olemassa.Ei
132007Viestipohja rikkoo viestintäkäytäntöä. Kirjoita se uudelleen ja lähetä uudelleen tarkistettavaksi.Ei
132012Parametrin muoto ei vastaa viestipohjan määrittelyä.Ei
132015Viestipohja on keskeytetty laadun heikennyttyä. Tilapäinen.Odota
132016Viestipohja on poistettu käytöstä pysyvästi. Se ei palaa.Ei

Ikkuna ja vastaanottaja

KoodiMitä se tarkoittaaUudelleenyritys
13104724 tunnin asiakaspalveluikkuna on sulkeutunut. Lähetä viestipohja.Ei
131026Vastaanottaja ei voi vastaanottaa viestiä lainkaan.Ei
131050Henkilö on kieltäytynyt viesteistä. Kiertotietä ei ole, ja se on tarkoituksellista.Ei
130497Viestien lähettäminen kyseiseen maahan on rajoitettu tililtäsi.Ei

Rekisteröinti ja PIN

KoodiMitä se tarkoittaaUudelleenyritys
131045Numeroa ei ole koskaan rekisteröity Cloud API -viestintään.Ei
133010Numeroa ei ole rekisteröity. Rekisteröinti on suoritettava loppuun.Ei
133006Numero on vahvistettava ennen kuin sen voi rekisteröidä.Ei
133005Kaksivaiheisen vahvistuksen PIN oli väärä. Lopeta arvaaminen.Ei
133008Liian monta PIN-yritystä. Rekisteröinti on lukittu joksikin aikaa.Odota

Käyttöoikeus ja tili

KoodiMitä se tarkoittaaUudelleenyritys
190Käyttöoikeustoken on vanhentunut tai mitätöity.Ei
368Tiliä on rajoitettu käytäntörikkomuksen vuoksi.Ei
131031Tiliä on rajoitettu, tai sen tiedot eivät vastaa Metan tietoja.Ei
131042Yritystilin maksuongelma estää lähettämisen.Ei
131049Meta esti viestin suojellakseen ekosysteemin terveyttä.Ei

Nopeusrajoitukset

KoodiMitä se tarkoittaaUudelleenyritys
130429Tilin viestien läpäisykyvyn raja on saavutettu.Odota
131048Roskapostin nopeusrajoitus täyttyi. Syy on laatu, ei määrä.Ei
131056Liikaa viestejä numerosi ja yhden vastaanottajan välillä.Ei
80007Tili saavutti hallintakutsujen rajan. Yleensä tiheän kyselyn (polling) vuoksi.Odota

Tilapäiset virheet

KoodiMitä se tarkoittaaUudelleenyritys
131016Jokin Metan palvelu on tilapäisesti poissa käytöstä.Kyllä
131000Luokittelematon virhe. Yritä kerran uudelleen ja eskaloi sitten trace id:n kanssa.Kyllä

Coexistence-synkronointi

KoodiMitä se tarkoittaaUudelleenyritys
2593107Keskusteluhistorian synkronoinnin raja ylittyi.Ei
2593108Synkronointia yritettiin 24 tunnin synkronointi-ikkunan ulkopuolella.Ei

Uudelleenyrityssarakkeen lukeminen

Sarakkeessa on kolme arvoa, ja väärän vaihtoehdon valitseminen on tämän koko viitteen kallein virhe.

Ei tarkoittaa, että epäonnistuminen on deterministinen. Pyyntö, viestipohja tai vastaanottajan tila aiheutti virheen, ja saman pyynnön lähettäminen uudelleen tuottaa saman virheen sekä kuluttaa myöhemmin tarvitsemaasi läpäisykykyä. Kyllä tarkoittaa, että virhe oli Metan puolella ja viive ratkaisee sen aidosti. Odota tarkoittaa, että tila on todellinen mutta väliaikainen: rajoitus tai lukitus poistuu itsestään, eikä ennen sitä tehty uudelleenyritys auta vaan voi pidentää tilaa.

Miksi useimpia näistä ei voi yrittää uudelleen

Koska alusta palauttaa tarkat koodit yleisten sijaan. Virheellinen parametri, puuttuva viestipohja, sulkeutunut viesti-ikkuna ja viesteistä kieltäytynyt vastaanottaja ovat tiedossa jo vastauksen hetkellä, joten Meta nimeää ongelman sen sijaan, että epäonnistuisi epämääräisesti.

  • Pyyntöongelma ei muutu oikeaksi toisella yrityksellä.
  • Viestipohjaongelma on viestipohjassa, eikä pyyntö voi muuttaa sitä.
  • Ikkuna- tai kieltäytymisongelma koskee vastaanottajan tilaa, ei sinun tilaasi.
  • Tilirajoitus on päätös, eikä uudelleenyritys ole valitus.

Mitä kirjataan, kun jokin näistä saapuu

Kirjaa tarpeeksi tietoja vian selvittämiseen ilman toistoa. Se erottaa viiden minuutin korjauksen päivän arvailusta.

  • Koko virhevastaus, mukaan lukien trace id, jota Metan tuki pyytää.
  • Lähetetty pyyntörunko, ei aiottu runko. Näiden välinen ero on yleensä virhe.
  • Puhelinnumeron tunnus, jotta yhden numeron ongelma erottuu koko tiliä koskevasta ongelmasta.
  • Aikaleima, jotta virhe voidaan tarkistaa yhteyden tilaa vasten juuri sillä hetkellä.

Vain Coexistencessa esiintyvät koodit

Niitä on kaksi, ja ne hämmentävät, koska näyttävät tavallisilta lähetysvirheiltä. 2593107 ja 2593108 koskevat keskusteluhistorian synkronointia. Se kopioi viimeisimmät keskustelut WhatsApp Business -sovelluksesta, kun numero yhdistetään ensimmäisen kerran.

Ne eivät ole viestintävirheitä eivätkä tarkoita, että yhteys epäonnistui. Jos synkronointi ylittää rajansa tai tapahtuu ikkunan ulkopuolella, numero pysyy yhdistettynä ja lähettää normaalisti, mutta historiaa kopioituu odotettua vähemmän. Jos koodi tulkitaan rikkoutuneeksi yhteydeksi, yhteys katkaistaan ja aloitetaan alusta, mikä menettää lisää historiaa sen palauttamisen sijaan.

Usein kysytyt kysymykset

Mitkä virheet kannattaa yrittää uudelleen?

131016 ja 131000 eksponentiaalisella viiveellä. 130429, 132015 ja 133008 poistuvat itsestään odottamalla. Kaikki muut ovat deterministisiä.

Tarkoittaako virhekoodi, että numeroni yhteys katkaistiin?

Yleensä ei. Useimmat koskevat pyyntöä, viestipohjaa tai vastaanottajaa. Yhteysongelmat näkyvät tili- ja laatua koskevina webhookeina, eivät lähetysvirheinä.

Mikä on trace id?

Virhevastauksessa oleva tunniste, jonka avulla Metan tuki löytää tietyn pyynnön. Kirjaa se jokaisesta virheestä, sillä ilman sitä tukipyyntöä ei voida käsitellä.

Ovatko nämä koodit samoja kaikilla palveluntarjoajilla?

Kyllä. Ne tulevat Metan Cloud API:sta, joten ne ovat samat riippumatta siitä, mikä palveluntarjoaja yhdisti numeron. Palveluntarjoaja voi muuttaa vain sitä, kuinka selkeästi koodit saavuttavat sinut.

Valmis aloittamaan?

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

Aloita ilmainen kokeiluEi veloituksia 3 päivään. Peruuta milloin tahansa.

Lue lisää