WhatsApp-webhookit: ohjaa viestit suoraan palvelimellesi

Mitä Meta todella lähettää webhookiin?

Tapahtumia eri luokissa, ja niiden välinen ero ratkaisee arkkitehtuurisi.

Viestipolku sisältää asiakkaiden lähettämät viestit sekä Coexistence-numerossa kaiut viesteistä, jotka tiimisi lähettää WhatsApp Business -sovelluksesta. Näitä ovat kentät messages ja smb_message_echoes, ja ne sisältävät keskustelujen sisällön.

Toimintopolku sisältää kaiken muun: account_update, kun yhteyden tila muuttuu, phone_number_quality_update, kun laatu tai läpimeno muuttuu, sekä account_alerts, account_review_update, business_capability_update ja phone_number_name_update. Ne eivät sisällä keskustelujen sisältöä, vaan niiden pohjalta valvonta rakennetaan.

Palveluntarjoaja, joka sijoittuu viestipolulle, vastaanottaa ensimmäisen ryhmän. Palveluntarjoaja, joka ei sijoitu siihen, ei vastaanota sitä.

Miten Meta vahvistaa endpointin?

GET-pyynnöllä ennen minkään toimittamista. Tämän epäonnistuminen on yleisin syy siihen, ettei valmiilta näyttävä käyttöönotto koskaan vastaanota viestiä.

Meta kutsuu URL-osoitettasi niin, että hub.mode-arvona on subscribe, mukana ovat hub.verify_token ja hub.challenge-arvo. Endpointisi on palautettava haaste raakana vastausrunkona, ei JSON-muodossa eikä minkään lisäyksen kanssa. Jos näin ei tapahdu, Meta ei koskaan aloita toimituksia, eikä mikään hallintapaneeli kerro siitä.

Endpointin on oltava HTTPS. Endpoint, joka palauttaa hiljaisen 404-virheen, tai todennustason takana oleva endpoint, joka hylkää Metan, näyttää toimivalta käyttöönotolta siihen asti, kun ensimmäinen viesti jää saapumatta.

Voiko kohde osoittaa omaan palvelimeesi?

Kyllä, ja tämä on palveluntarjoajien välinen ero.

Meta sallii sovelluksen ohittaa kohteen, johon tietyn WhatsApp Business Account -tilin webhookit toimitetaan. Asetamme ohituksen URL-osoitteeseesi, jolloin viestipolun tapahtumat siirtyvät meidän callbackistamme sinulle. Pidämme toimintopolun tapahtumat, koska hallintapaneeli ja hälytykset perustuvat niihin.

Seuraus liittyy arkkitehtuuriin, ei julkaisemaamme käytäntöön. Keskustelujen sisällöllä ei ole paikkaa puolellamme, koska sitä ei koskaan toimiteta meille. Tili, jolle ohitusta ei ole asetettu, käyttää oletusarvoista callbackiamme, jossa käsittelijä hylkää nämä tapahtumat tallentamatta niitä.

Mitä kohteelle tapahtuu, kun numero yhdistetään uudelleen?

Se poistetaan. Tätä lähes kukaan ei suunnittele etukäteen.

Kohde ei ole puhelinnumeron ominaisuus. Se on ohitus sovelluksemme WhatsApp Business Account -tilin tilaukseen. Kun yhteys poistetaan Metan neljäntoista päivän passiivisuussäännön vuoksi tai muusta syystä, sovellus poistetaan tililtä ja ohitus poistuu sen mukana.

Uudelleenyhdistäminen palauttaa lähettämisen ja valvonnan. Se ei palauta toimituksia palvelimellesi, eikä mikään ilmoita virheestä, joten ensimmäinen merkki voi olla asiakkaan kertomus siitä, ettei kukaan vastannut. Asetamme ohituksen uudelleen jokaisen uudelleenyhdistämisen yhteydessä, koska näin kävi oikealle numerolle, joka yhdistettiin uudelleen onnistuneesti mutta hiljeni.

Yleiset virheet

• JSON-vastauksen palauttaminen vahvistuksen GET-pyynnössä. Meta haluaa raakana hub.challenge-arvon eikä mitään muuta.
• Väliaikaisen tai testikäyttöön tarkoitetun URL-osoitteen käyttäminen. Meta jatkaa toimituksia siihen, vaikka sen luonut työkalu lopettaisi kuuntelun.
• Oletus, että kohde säilyy uudelleenyhdistämisen jälkeen. Se kuuluu sovelluksen tilaukseen ja poistetaan sen mukana.
• Endpointin sijoittaminen todennuksen taakse niin, että se hylkää Metan pyynnön.

Usein kysytyt kysymykset

Lue lisää