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.
Pyyntö
| Koodi | Mitä se tarkoittaa | Uudelleenyritys |
|---|---|---|
| 100 | Parametri ei ole tuettu, se on kirjoitettu väärin tai se on virheellinen. | Ei |
| 131008 | Pakollinen parametri puuttuu kokonaan. | Ei |
| 131009 | Parametri on mukana, mutta endpoint hylkää sen arvon. | Ei |
| 131021 | Lähettäjä ja vastaanottaja ovat sama numero. | Ei |
| 131051 | Viestityyppiä ei tueta, usein Coexistence-rajoituksen vuoksi. | Ei |
| 131052 | Meta ei pystynyt lataamaan asiakkaan lähettämää mediaa. | Ei |
| 131053 | Meta ei pystynyt lähettämään lähettämääsi mediaa. Koko, muoto tai saavutettavuus. | Ei |
Viestipohja
| Koodi | Mitä se tarkoittaa | Uudelleenyritys |
|---|---|---|
| 132000 | Parametrien määrä ei vastaa viestipohjaa. | Ei |
| 132001 | Viestipohjaa tällä nimen ja kielen yhdistelmällä ei ole olemassa. | Ei |
| 132007 | Viestipohja rikkoo viestintäkäytäntöä. Kirjoita se uudelleen ja lähetä uudelleen tarkistettavaksi. | Ei |
| 132012 | Parametrin muoto ei vastaa viestipohjan määrittelyä. | Ei |
| 132015 | Viestipohja on keskeytetty laadun heikennyttyä. Tilapäinen. | Odota |
| 132016 | Viestipohja on poistettu käytöstä pysyvästi. Se ei palaa. | Ei |
Ikkuna ja vastaanottaja
| Koodi | Mitä se tarkoittaa | Uudelleenyritys |
|---|---|---|
| 131047 | 24 tunnin asiakaspalveluikkuna on sulkeutunut. Lähetä viestipohja. | Ei |
| 131026 | Vastaanottaja ei voi vastaanottaa viestiä lainkaan. | Ei |
| 131050 | Henkilö on kieltäytynyt viesteistä. Kiertotietä ei ole, ja se on tarkoituksellista. | Ei |
| 130497 | Viestien lähettäminen kyseiseen maahan on rajoitettu tililtäsi. | Ei |
Rekisteröinti ja PIN
| Koodi | Mitä se tarkoittaa | Uudelleenyritys |
|---|---|---|
| 131045 | Numeroa ei ole koskaan rekisteröity Cloud API -viestintään. | Ei |
| 133010 | Numeroa ei ole rekisteröity. Rekisteröinti on suoritettava loppuun. | Ei |
| 133006 | Numero on vahvistettava ennen kuin sen voi rekisteröidä. | Ei |
| 133005 | Kaksivaiheisen vahvistuksen PIN oli väärä. Lopeta arvaaminen. | Ei |
| 133008 | Liian monta PIN-yritystä. Rekisteröinti on lukittu joksikin aikaa. | Odota |
Käyttöoikeus ja tili
| Koodi | Mitä se tarkoittaa | Uudelleenyritys |
|---|---|---|
| 190 | Käyttöoikeustoken on vanhentunut tai mitätöity. | Ei |
| 368 | Tiliä on rajoitettu käytäntörikkomuksen vuoksi. | Ei |
| 131031 | Tiliä on rajoitettu, tai sen tiedot eivät vastaa Metan tietoja. | Ei |
| 131042 | Yritystilin maksuongelma estää lähettämisen. | Ei |
| 131049 | Meta esti viestin suojellakseen ekosysteemin terveyttä. | Ei |
Nopeusrajoitukset
| Koodi | Mitä se tarkoittaa | Uudelleenyritys |
|---|---|---|
| 130429 | Tilin viestien läpäisykyvyn raja on saavutettu. | Odota |
| 131048 | Roskapostin nopeusrajoitus täyttyi. Syy on laatu, ei määrä. | Ei |
| 131056 | Liikaa viestejä numerosi ja yhden vastaanottajan välillä. | Ei |
| 80007 | Tili saavutti hallintakutsujen rajan. Yleensä tiheän kyselyn (polling) vuoksi. | Odota |
Tilapäiset virheet
Coexistence-synkronointi
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.