messages-webhook
`messages` on kenttä, joka kuljettaa kaiken asiakkaan numeroosi lähettämän: tekstin, median, vastaukset, reaktiot ja interaktiiviset vastaukset. Reititetyssä Coexistence-numerossa se kulkee Metalta suoraan endpointiisi eikä koskaan palveluntarjoajan kautta.
Kenttä, joka kuljettaa asiakkaalta saapuvat viestit webhookissa.
Viestin tunnisteen etuliite, jonka avulla uudelleenyritykset voidaan deduplikoida.
Tila, jota Meta odottaa nopeasti ennen käsittelyä.
Mitä payload sisältää
Yksi toimitus voi sisältää yhden tai useamman viestin. Jokaisessa on lähettäjä, tunniste ja tyyppi. Tyyppi määrittää, mitkä muut avaimet ovat mukana.
- Lähettäjän puhelinnumero ja sen numeron puhelinnumero-ID, johon hän kirjoitti.
- wamid-viestin tunniste, johon deduplikointi perustuu.
- Unix-aikaleima.
- Tyyppi: text, image, audio, video, document, sticker, location, contacts, reaction, button tai interactive.
- Mediasisällöissä media-ID, jolla sisältö haetaan, ei itse tavudataa.
Miksi se ei saavu meille reititetyssä numerossa
Ohitus siirtää tämän kentän ja smb_message_echoes-kentän valitsemaasi kohteeseen.
Meta sallii sovelluksen määrittää uudelleen, minne WhatsApp Business -tili toimittaa webhookinsa. Asetamme ohituksen URL-osoitteeseesi, jolloin viestipolku poistuu kokonaan infrastruktuuristamme. Meille ei synny kopiota, jonoa eikä säilytystä, koska toimitus ei koskaan saavu tänne.
Kun kohdetta ei ole määritetty, nämä tapahtumat palaavat oletuscallbackiimme, jossa käsittelijä hylkää ne tallentamatta. Tämä erottaa säilytystä koskevan väitteen koodipolusta: keskustelusisällöllä ei ole paikkaa, johon se voisi päätyä.
Kuittaaminen oikein
Palauta 200 ennen työn aloittamista, ei sen jälkeen.
Meta tulkitsee hitaan vastauksen virheeksi ja yrittää uudelleen. Siksi inline-käsittelyä tekevä käsittelijä voi nähdä saman viestin useammin kuin kerran. Vastaa heti, siirrä payload jonoon tai taustatehtävään ja anna työn tapahtua pyynnön ulkopuolella.
Palvelimettomassa ympäristössä tämä ei ole valinnaista. Funktio, joka palauttaa vastauksen mutta jatkaa sen jälkeen työskentelyä, voidaan jäädyttää heti vastauksen jälkeen. Siksi kuittauksen ja käsittelyn on oltava aidosti erillisiä.
Deduplikointi
Tee se aina wamid-tunnisteen perusteella, koska uudelleenyritykset ovat normaaleja eivätkä poikkeuksia.
Sama viesti voi saapua kahdesti syistä, joilla ei ole mitään tekemistä oman puolesi virheen kanssa: hidas vastaus, verkkoyhteyden aikakatkaisu tai kesken toimituksen valmistuva julkaisu. Nähtyjen tunnisteiden tallentaminen ja toistojen ohittaminen vaatii vain muutaman rivin, mutta ratkaisee, vastaataanko asiakkaalle kerran vai kahdesti.
Coexistence-numerossa tämä on vielä tärkeämpää, koska smb_message_echoes saapuu samaa polkua pitkin. Käsittelijä, joka tulkitsee jokaisen tapahtuman uudeksi, vastaa ihmisen jo antaman vastauksen päälle.
Yleiset virheet
- 200-palautuksen lykkääminen käsittelyn jälkeen. Meta yrittää hidasta vastausta uudelleen, joten käsittelet viestin kahdesti.
- Deduplikoinnin ohittaminen. Uudelleenyritykset kuuluvat toimintaan, eivätkä ole poikkeustapauksia.
- Mediasisällön tavudatan odottaminen payloadissa. Se sisältää haettavan media-ID:n.
EasyCoexistence reitittää tämän kentän suoraan Metalta endpointiisi ja säilyttää vain valvonnan tarvitsemat operatiiviset tapahtumat, joten keskustelusisällöllä ei ole lainkaan polkua tallennustilaamme.
Usein kysytyt kysymykset
Näkeekö EasyCoexistence asiakkaideni viestit?
Ei. Ohitus toimittaa tämän kentän endpointiisi. Oletuscallbackiimme saapuva sisältö hylätään tallentamatta.
Voiko yhteen pyyntöön saapua useita viestejä?
Kyllä. Yksi toimitus voi sisältää useita viestejä, joten käsittelijän tulee käydä ne läpi sen sijaan, että se lukisi vain ensimmäisen.
Miten saan median?
Payload sisältää media-ID:n. Hae sen avulla URL käyttäen numeron access tokenia ja lataa sisältö.
Mikä smb_message_echoes on?
Se on kumppanikenttä, joka kuljettaa tiimisi WhatsApp Business -sovelluksesta lähettämät viestit. Se on olemassa vain Coexistence-numeroissa.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu