Lähetä WhatsApp-tilauspäivitykset WooCommercesta

Miten WooCommerce-tilaus käynnistää WhatsApp-viestin?

WooCommercen webhookin ja vastaanottajan kautta. Lisää WooCommercessa kohdassa Asetukset, Lisäasetukset, Webhookit uusi webhook, jolle valitset tilausaiheen, kuten tilaus luotu tai tilaus päivitetty, toimitus-URL:n ja salaisen avaimen. WooCommerce lähettää tilauksen JSON-muodossa tähän URL-osoitteeseen aina, kun tapahtuma toteutuu.

Payload on kiinteä, joten sitä ei voi ohjata suoraan Cloud API -rajapintaan. Väliin tarvitaan vastaanottaja: n8n:n Webhook-node, reitti kaupan omassa PHP-koodissa tai mikä tahansa pieni palvelu. Se lukee tilauksen, poimii asiakkaan puhelinnumeron ja viestiin tarvittavat tiedot ja tekee yhden HTTPS-pyynnön yhdistetyn numeron Cloud API -rajapinnan viestien endpointiin käyttäen numeron access tokenia bearer-tokenina.

Aihe order.updated ei ole sidottu yhteen tilaan, joten vastaanottajan kannattaa lukea tilauksen status-kenttä ja lähettää viesti kerran jokaisesta siirtymästä, josta se välittää. WooCommerce toimittaa tiedot oletuksena taustalla wp-cronin kautta, joten viesti voi seurata tilausta pienellä viiveellä.

Mistä vastaanottaja tietää, että pyyntö tuli kaupasta?

WooCommercen allekirjoituksesta. Jokaisessa toimituksessa on X-WC-Webhook-Signature-otsake, joka sisältää raakapayloadin base64-koodatun HMAC-SHA256-tiivisteen, laskettuna webhookille asettamallasi salaisella avaimella. Vastaanottaja laskee saman tiivisteen saamastaan sisällöstä, vertaa niitä ja hylkää kaiken, mikä ei täsmää.

Tämä on kaupan oma salainen avain, joten toisin kuin Metan allekirjoitus saapuvissa WhatsApp-viesteissä, tämän voi tarkistaa. Vertaa vakioajassa ja laske tiiviste raakasisällöstä ennen kuin mikään kehys jäsentää sen, sillä uudelleenkoodattu JSON tuottaa eri tiivisteen.

Vastaa nopeasti 2xx-koodilla. WooCommerce laskee virheeksi kaikki vastaukset, jotka eivät ole 2xx, 301 tai 302, ja yli viiden peräkkäisen virheen jälkeen se poistaa webhookin käytöstä. Vastaanottaja, joka on alhaalla julkaisun takia tai hidas, koska odottaa Metaa ennen vastaamista, voi katkaista kaupan viestit kenenkään huomaamatta.

Mitä kauppa voi lähettää ja milloin?

Hyväksytyn viestipohjan aina, kun kauppa kirjoittaa ensin. Metan 24 tunnin asiakaspalveluikkuna aukeaa vain, kun asiakas lähettää viestin numeroon, joten tilausvahvistus tai lähetyspäivitys on yrityksen aloittama ja vapaa teksti hylätään. Luo jokaiselle päivitykselle utility-viestipohja, odota hyväksyntää ja lähetä se nimellä ja kielellä, tilausnumero ja muut tiedot parametreina.

Meta vaatii myös suostumuksen: asiakas on antanut numeronsa ja hyväksynyt yrityksen viestit WhatsAppissa. Kassalla oleva valintaruutu, joka tallennetaan tilaukseen, on yksinkertaisin todiste, ja vastaanottajan pitää tarkistaa se ennen lähetystä.

Kun asiakas vastaa, keskustelu on tavallista Coexistence-käyttöä. Vastaus näkyy kaupan puhelimen WhatsApp Business -sovelluksessa, ikkuna on auki vapaalle tekstille ja tiimi vastaa sovelluksesta kuten ennenkin.

Yleiset virheet

• Cloud API -kutsun tekeminen ennen vastaamista WooCommercelle. Hidas tai epäonnistunut lähetys lasketaan webhookin virheeksi, ja webhook poistetaan käytöstä yli viiden virheen jälkeen.
• Jäsennetyn JSONin tiivistäminen raakasisällön sijaan. Allekirjoitus ei koskaan täsmää, ja jokainen aito toimitus hylätään.
• Lähettäminen jokaisesta order.updated-toimituksesta. Aihe ei ole sidottu yhteen tilaan, joten ilman seurantaa siitä, mistä siirtymästä on jo lähetetty viesti, asiakkaat saavat kaksoiskappaleita.

Usein kysytyt kysymykset

Lue lisää