easyCoexistence
Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsAppin webhook-kentät ja niiden reititys

WhatsApp Business -tili välittää tapahtumat nimettyinä kenttinä. Kaksi kenttää sisältää keskustelun sisällön ja reititetään endpointiin. Kuusi sisältää toimintatilan tietoja, joiden varaan valvonta rakennetaan. Arkkitehtuurisi riippuu siitä, mitkä kentät ovat kyseessä.

  • Kaksi viestikenttää, kuusi toimintatilakenttää
  • Reititys määritetään tilikohtaisesti
  • Nimetyt kentät, ei yleistä payloadia
Aloita ilmainen kokeilu

Ei veloituksia 7 päivään. Peruuta milloin tahansa.

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

Viestipolun kentät: messages ja smb_message_echoes.

6

Toimintatilakentät säilytetään valvontaa varten.

1

Ohitus määritetään WhatsApp Business -tilikohtaisesti, ja se jakaa kentät.

Mitä kukin kenttä sisältää?

messages sisältää kaiken, mitä asiakas lähettää numeroon: tekstin, mediasisällön viitteet, vastaukset ja reaktiot. smb_message_echoes sisältää sen, mitä tiimisi lähettää WhatsApp Business -sovelluksesta. Kenttä on olemassa vain Coexistence-numerossa, ja sen avulla ohjelmisto näkee ihmisen lähettämät vastaukset.

account_update sisältää yhteyden tilan: PARTNER_REMOVED, kun sovellus poistetaan tililtä, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED sekä rajoitus- ja rikkomustapahtumat. phone_number_quality_update sisältää laatuluokituksen ja läpimenon muutokset. account_alerts sisältää Metan tilille nostamat hälytykset, ja account_review_update sisältää tarkistuksen tuloksen.

business_capability_update sisältää viestintärajojen ja ominaisuuksien muutokset, ja phone_number_name_update sisältää näyttönimen hyväksynnät ja hylkäykset.

Miksi jaolla on arkkitehtuurissa merkitystä?

Se ratkaisee, päätyykö keskustelun sisältö koskaan palveluntarjoajalle.

Ohitus lähettää kaksi viestikenttää Meta-palvelusta suoraan endpointiin. Kuusi toimintatilakenttää jatkaa palveluntarjoajalle, mikä mahdollistaa hallintapaneelin ja hälytykset ilman, että kukaan käsittelee viestiä.

Siksi väite siitä, ettemme tallenna viestejä, voi perustua rakenteeseen eikä käytäntöön. Jos viestikentät toimitetaan muualle, koodissa ei ole reittiä, jota pitkin ne voitaisiin tallentaa. Meillä tili, jolle ohitusta ei ole määritetty, käyttää oletuskutsua, jossa käsittelijä hylkää nämä tapahtumat tallentamatta niitä.

Mitä kenttiä käsittelijän pitäisi odottaa?

Vain kaksi viestikenttää, jos ohitus on määritetty. Käsittelijä kannattaa kirjoittaa niin, että se ohittaa kaiken muun eikä kaadu siihen.

Meta lisää kenttiä ajan mittaan, ja payloadiin voi ilmestyä uusia avaimia ilman ilmoitusta. Kentän nimen perusteella haarautuva käsittelijä, joka ohittaa tuntemattomat kentät, toimii jatkossakin. Käsittelijä, joka olettaa tietyn rakenteen, kaatuu heti ensimmäiseen tuntemattomaan tapahtumaan.

smb_message_echoes kannattaa käsitellä erikseen eikä pitää sitä hälynä. Ilman sitä ohjelmisto ei tiedä, että ihminen on jo vastannut. Muuten asiakas voi saada kaksi vastausta samaan kysymykseen.

Yleiset virheet

  • Yleisen payloadin olettaminen. Jokainen tapahtuma nimeää kenttänsä, ja käsittelijän pitäisi haarautua sen perusteella.
  • smb_message_echoes-kentän ohittaminen. Ilman sitä ohjelmisto vastaa ihmiselle, joka on jo vastannut.
  • Tuntemattomiin kenttiin kaatuminen niiden ohittamisen sijaan. Meta lisää kenttiä kysymättä.
Näin teet tämän EasyCoexistencen avulla

EasyCoexistence tilaa toimintatilakentät valvontaa varten ja reitittää kaksi viestikenttää endpointiisi tai hylkää ne tallentamatta, jos et ole määrittänyt endpointia.

Usein kysytyt kysymykset

Voinko vastaanottaa vain osan kentistä?

Ohitus siirtää viestipolun sinulle. Toimintatilakenttien jako on kiinteä, koska valvonta rakennetaan sen varaan.

Onko smb_message_echoes tavallisessa Cloud API -numerossa?

Ei. Se on olemassa, koska Coexistence-numerossa ihminen lähettää viestejä sovelluksesta ja ohjelmisto API:sta.

Mitä viestitapahtumille tapahtuu, jos en määritä kohdetta?

Ne saapuvat oletuskutsuumme ja hylätään tallentamatta niitä.

Ovatko kenttien nimet Metan vai teidän?

Metan. Emme ole keksineet yhtäkään näistä nimistä, joten ne kannattaa opetella kerran.

Lue lisää

The messages webhookEverything a customer sends arrives on this field. What the payload carries, how to acknowledge it, and why it never reaches a provider on a routed number.The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.The phone_number_quality_update webhookWhat this webhook actually carries as of 2026, why the colour quality rating is not in it, and where the rating has to be read from instead.The WhatsApp Business Account, and why overrides live on itWhat a WABA holds, why webhook overrides are applied at this level rather than per number, and what that means when a connection is removed.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

Valmis aloittamaan?

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

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

Vahvistettu

WhatsAppin webhook-kentät