WhatsApp-laskuviestin toiminta ja käyttöönotto

WhatsApp-laskuviesti lähettää asiakkaalle laskun PDF-liitteenä WhatsAppiin laskun muodostamisen yhteydessä. Lähetys edellyttää toimivia WhatsApp Business -tunnuksia, asiakkaan tallennettua puhelinnumeroa ja asiakkaan antamaa WhatsApp-laskusuostumusta.

Määritä WhatsApp-laskuviestin asetukset

WhatsApp-laskuviestin käyttöönotto alkaa kahden asetuksen määrittämisestä. Avaa Integrations reitillä /configuration/integrations ja määritä WhatsApp Business -viestinnän salainen WHATSAPP_TOKEN. Tarkista sen jälkeen Configuration-näkymässä reitillä /configuration, että WHATSAPP_PHONE_NUMBER_ID sisältää WhatsApp Business -puhelinnumeron tunnisteen.

Molempien arvojen pitää olla ei-tyhjiä. WHATSAPP_TOKEN on salaisuus, joten jo tallennettu arvo näytetään peitettynä. Älä lisää tokenia asiakasviestiin, kuvakaappaukseen tai tukipyyntöön. Puhelinnumeron tunniste ei ole sama asia kuin asiakkaalle näkyvä puhelinnumero.

Varmista asiakkaan numero ja suostumus

WhatsApp-laskun vastaanottajaksi käytetään asiakkaan tilille tallennettua puhelinnumeroa. Varmista ennen tilausta, että numero kuuluu oikealle asiakkaalle ja on WhatsApp Business -palvelun hyväksymässä muodossa. Tyhjä puhelinnumero estää lähetyksen ilman, että tavallinen laskun muodostaminen keskeytyy.

Asiakkaan WhatsApp-laskusuostumus tallennetaan kentästä whatsAppInvoice, ja pysyvä asiakastieto on grant_whatsapp. Suostumus voidaan tallentaa kassalla tai asiakkaan tietojen kautta siinä käyttöliittymässä, jossa kyseinen valinta on käytössä. Kun asiakas kirjautuu myöhemmin, tallennettu suostumus palautetaan istuntoon ja sitä käytetään seuraavan laskun lähetyspäätöksessä. Älä ota suostumusta käyttöön asiakkaan puolesta ilman asiakkaan nimenomaista valintaa.

Milloin WhatsApp-laskuviesti lähetetään

WhatsApp-laskuviesti yritetään lähettää silloin, kun lasku muodostetaan ja kaikki lähetysehdot täyttyvät. Järjestelmä tarkistaa samassa yhteydessä, että istunnon whatsAppInvoice-suostumus on päällä, asiakkaan tilillä on puhelinnumero sekä WHATSAPP_TOKEN ja WHATSAPP_PHONE_NUMBER_ID on määritetty.

Jos yksikin ehto puuttuu, WhatsApp-laskuviestiä ei lähetetä. Vastaanottajaa ei päätellä laskutusosoitteesta tai erillisestä WhatsApp-asetuksesta, vaan viesti osoitetaan asiakkaan tilille tallennettuun puhelinnumeroon. WhatsApp-lähetyksen virhe kirjataan palvelinlokiin, mutta virhe ei estä laskusähköpostin muuta käsittelyä.

Mitä asiakas saa WhatsAppissa

Asiakas saa WhatsAppissa dokumenttiviestin, jonka liitteen sisältö on muodostettu lasku PDF-muodossa. PDF-tiedoston nimi muodostetaan laskun otsikosta: otsikko siistitään tiedostonimeen sopivaksi ja loppuun lisätään .pdf. Jos otsikosta ei jää kelvollista nimeä, käytetään muotoa order-<orderId>.pdf.

Dokumenttiviestin kuvateksti haetaan laskun käännösavaimesta THANKS_FOR_ORDER_WHATSAPP_MESSAGE. Avaimen suomenkielinen arvo on Kiitos tilauksestanne. Jos käännösarvo on tyhjä, järjestelmä käyttää oletustekstiä Thank you for your order!. Muokkaa näkyvä kuvateksti laskun käännöksissä ja tarkista se jokaisella kaupan käyttämällä kielellä.

Testaa WhatsApp-laskuviesti

WhatsApp-laskuviestin toiminta kannattaa testata erillisellä testiasiakkaalla, jonka puhelinnumeroon sinulla on lupa lähettää viesti. Tallenna testiasiakkaalle numero ja WhatsApp-laskusuostumus, muodosta lasku ja tarkista, että WhatsAppiin saapuu oikean tilauksen PDF oikealla tiedostonimellä ja kuvatekstillä.

Tarkista samalla, että normaali laskusähköposti muodostuu odotetusti. Älä käytä onnistumisen todisteena vain laskun syntymistä: WhatsApp-palvelu lataa ensin PDF-dokumentin ja lähettää sen jälkeen erillisen dokumenttiviestin, joten molempien vaiheiden pitää onnistua.

Jos WhatsApp-laskuviesti ei saavu

Jos WhatsApp-laskuviesti ei saavu, tarkista asiat tässä järjestyksessä:

1. Asiakkaan tilillä on oikea puhelinnumero.
2. Asiakkaan WhatsApp-laskusuostumus on tallennettu ja istunnossa päällä.
3. WHATSAPP_TOKEN on määritetty Integrations-näkymässä.
4. WHATSAPP_PHONE_NUMBER_ID on määritetty Configuration-näkymässä.
5. Lasku muodostettiin kyseisessä tilauskäsittelyssä.
6. Palvelinlokissa ei ole WhatsApp-dokumentin lataus- tai lähetysvirhettä.

Jos asetukset ja asiakastiedot ovat kunnossa mutta viesti puuttuu, kerää tukea varten tilauksen ID, laskun muodostamisaika, vastaanottajan puhelinnumeron loppuosa ja tarkka lokivirhe. Älä lähetä tukipyynnössä WhatsApp-tokenia tai koko puhelinnumeroa.