Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

Virhe 131060: ei tuettu viesti Coexistence-numerossa

Virhe 131060 saapuu messages-webhookiin viestinä, jonka tyyppi on unsupported ja otsikkona ”This message is currently unavailable.” Coexistence-numerossa Meta pitää tätä odotettuna: sitä esiintyy useimmin, kun joku kirjoittaa yritykselle ensimmäistä kertaa, usein heti Click-to-WhatsApp -mainoksen napautuksen jälkeen, ja tilanne korjaantuu yleensä sekunneissa. Viestin voi silti lukea WhatsApp Business -sovelluksesta.

easyCoexistence pitää tukemattomat viestit automaatioidesi ulkopuolella, joten tekoäly ei vastaa koskaan viestiin, jota se ei pysty lukemaan, ja välittää silti Metan payloadin järjestelmällesi, kun Forward URL on asetettu.

131060

Metan koodi saapuvalle viestille, joka ei ole tällä hetkellä saatavilla, otsikolla ”This message is currently unavailable.”

Seconds

Meta sanoo virheen korjaantuvan yleensä muutamassa sekunnissa, minkä jälkeen WhatsApp toimittaa viestit normaalisti.

First contact

Meta mainitsee pääskenaariona WhatsApp-käyttäjän, joka viestii yritykselle ensimmäistä kertaa, usein heti Click-to-WhatsApp -mainoksen napautuksen jälkeen.

131051

Saman webhookin toinen koodi: Cloud API ei tue tätä viestityyppiä lainkaan.

Skipped

easyCoexistence-automaatiot eivät aja tukematonta viestiä; seuraava luettava viesti samasta keskustelusta käynnistää ne.

Mitä 131060-webhook sisältää?

Se on tavallinen messages-webhook, jonka viestillä on ”type”: ”unsupported” ja errors-taulukko. Virheessä on koodi 131060 ja otsikko ”This message is currently unavailable.”, samalla lauseella kuin sen viesti. Unsupported-objekti nimeää sisältötyypin, jota Meta ei voinut välittää; Metan arvolistaan kuuluvat muun muassa image, interactive, reaction ja poll_creation. Tekstirunkoa ja media-id:tä ei ole, joten payloadista ei näe, mitä asiakas kirjoitti. Lähettäjän numero, viestin tunnus ja aikaleima ovat mukana kuten tavallisesti.

messages webhook with error 131060 (shape from Meta's reference, values illustrative)
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "<WABA_ID>",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "<BUSINESS_NUMBER>",
          "phone_number_id": "<PHONE_NUMBER_ID>"
        },
        "contacts": [{ "profile": { "name": "Ana" }, "wa_id": "5511999998888" }],
        "messages": [{
          "from": "5511999998888",
          "id": "wamid.HBgN...",
          "timestamp": "1762876800",
          "type": "unsupported",
          "errors": [{
            "code": 131060,
            "title": "This message is currently unavailable.",
            "message": "This message is currently unavailable."
          }],
          "unsupported": { "type": "<UNSUPPORTED_TYPE>" }
        }]
      }
    }]
  }]
}

Miksi se tapahtuu Coexistence-numerolla?

Metan Coexistence-ohjeen mukaan kumppanit voivat saada unsupported-tyyppisen messages-webhookin virhekoodilla 131060, ja se on odotettua. Ohje nimeää kaksi tilannetta.

Ensimmäinen on WhatsApp-käyttäjä, joka kirjoittaa yritykselle ensimmäistä kertaa. Meta sanoo tämän olevan erityisen yleistä, kun joku napauttaa Click-to-WhatsApp -mainosta ja lähettää viestin heti. Toinen on WhatsApp-käyttäjä tukemattomalla linkitetyllä laitteella, joka lähettää viestin yritykselle tai vastaanottaa sen yritykseltä.

Meta ei selitä mekanismia. Tärkeämpää on se, mitä se sanoo: virhe korjaantuu yleensä muutamassa sekunnissa, ja sen jälkeen WhatsApp toimittaa viestit normaalisti.

Mitä yrityksen kannattaa tehdä, kun se saapuu?

Lue viesti sovelluksesta. Metan ohje alustoille on kehottaa yritystä tarkistamaan viesti WhatsApp Business -sovelluksesta, koska puhelimen sovelluksessa viesti on silti, vaikka API:n kopio ei ollut saatavilla.

Käytännössä: avaa keskustelu puhelimella, lue mitä asiakas kirjoitti ja vastaa sieltä, tai odota asiakkaan seuraavaa viestiä, joka yleensä tulee API:n kautta ilman virhettä. Vastaaminen puhelimelta kertoo myös automaatioille, että ihminen hoitaa keskustelua. Mainoskampanjassa kannattaa odottaa uusien keskustelujen alussa pientä purskeita eikä vikaa.

Miten ohjelmisto ja tekoäly käsittelevät sen?

Käsittele sitä tunnettuna tapahtumana, ei vikana. Vastaa webhookiin koodilla 200 kuten mihin tahansa toimitukseen, jotta Meta ei lähetä sitä uudelleen. Tallenna viestin tunnus ja lähettäjä, jotta voit yhdistää sen seuraavaan keskusteluun. Älä anna tyhjää viestiä tekoälylle ikään kuin se olisi tekstiä: ilman sisältöä mikä tahansa vastaus on arvaus. Hälytä 131060-tapahtumien määrän perusteella, älä yksittäisistä.

  • Palauta 200 nopeasti ja poista kaksoiskappaleet viestin tunnuksen perusteella, kuten jokaisessa webhookissa.
  • Ohita tekoälyvastaukset ja avainsanahaku, kun tyyppi on unsupported.
  • Näytä tiimille, että viesti odottaa puhelimen sovelluksessa.
  • Laske 131060 erikseen todellisista virheistä hallintapaneeleissa.

Suorittavatko automaatiot tukemattoman viestin?

easyCoexistencessä ei. Automaatiot lukevat tekstin, painike- ja listavastaukset, median kuvatekstit ja paikkamerkit kuten ”[voice message]”. Tyyppiä unsupported olevalla viestillä ei ole näitä, joten automaatio ei vastaa siihen eikä suoritusta näy. Jos Forward URL on asetettu, järjestelmäsi saa silti Metan alkuperäisen payloadin virheineen. Suorassa tilassa Meta lähettää sen suoraan palvelimellesi.

Seuraava luettava viesti samalta henkilöltä käynnistää automaatiot normaalisti. Koska keskustelusta ei ollut vielä tallennettu mitään, ”First message” -automaatio, esimerkiksi tervetulovastaus, vastaa seuraavaan viestiin.

Miten 131060 eroaa virheestä 131051?

Molemmat saapuvat tyypillä unsupported samassa messages-webhookissa, minkä vuoksi ne sekoittuvat lokeissa. Suunnittelun kannalta ne tarkoittavat päinvastaisia asioita: toinen on lyhyt katko, joka korjaantuu itsestään, toinen pysyvä API:n rajoitus kyseiselle sisällölle. Erota ne käsittelijässäsi lukemalla errors[0].code eikä tyyppiä. Taulukko kokoaa yhteen, mitä Metan viitteet sanovat kustakin koodista.

131060131051
TitleThis message is currently unavailable.Message type unknown
MeaningThe message cannot be passed on right nowThe Cloud API does not support that type
Typical causeFirst contact on a Coexistence number, often after an ad tapContent the API never delivers
How longUsually clears within secondsPermanent for that content
What to doRead it in the WhatsApp Business appAsk the customer for text, or read it in the app

Yleiset virheet

  • Yksittäisten 131060-tapahtumien hälyttäminen. Meta pitää niitä odotettuina Coexistence-numeroilla; seuraa sen sijaan määrää.
  • Tekoälyn vastaaminen tyhjään viestiin. Payloadissa ei ole tekstiä, joten vastaus olisi keksitty.
  • Webhookin vastaaminen virhestatuksella. Meta lähettää epäonnistuneet webhookit uudelleen, joten yksi tukematon viesti muuttuu useiksi toimituksiksi.
  • Oletus, että viesti on kadonnut. Se on WhatsApp Business -sovelluksessa; vain API:n kopio ei ollut saatavilla.
Näin teet tämän EasyCoexistencen avulla

Numero pysyy puhelimen sovelluksessa, josta alkuperäisen viestin voi lukea. US$ 9:stä US$ 0,75:een numeroa kohden kuukaudessa, kun numeroita lisätään, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Voinko hakea alkuperäisen sisällön API:n kautta?

Metan ohje virheelle 131060 on tarkistaa WhatsApp Business -sovellus. Sen webhook-viitteessä ei ole kuvausta siitä, miten sisällön voi hakea myöhemmin.

Tarkoittaako 131060, että numero on rikki?

Ei. Jos tavallisilta yhteyshenkilöiltä tulevat viestit saapuvat yhä virheellä 131060 tuntien ajan, pyydä tekoälyä ajamaan get_number_health tai tarkistamaan yhteys. Ensikontaktin purskeet ovat silti odotettuja.

Esiintyykö se numeroilla, jotka käyttävät vain Cloud API:a?

Meta kuvaa ensikontaktin kaavan ohjeessaan numeroille, jotka on otettu käyttöön WhatsApp Business -sovelluksella, ja juuri sitä Coexistence on. Koodi itsessään on Metan yleisessä webhook-viitteessä, joten käsittele sitä samoin millä tahansa numerolla.

Veloitetaanko siitä jotain?

Kyseessä on saapuva viesti. Meta veloittaa yritystä sen lähettämistä viesteistä viestikohtaisesti kategorian ja maan mukaan omalla WhatsApp Business -tilillään.

Lue lisää

Valmis aloittamaan?

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

Aloita ilmainen kokeilu

Vahvistettu