Tässä ohjeessa kuvataan, miten otat AI Commercessa käyttöön toiminnon, jossa asiakas voi hyväksyä laskun/tilausvahvistuksen lähettämisen WhatsAppiin. Kun käyttöönotto on tehty, asiakas saa laskun PDF-liitteenä WhatsAppiin ja viestissä näkyy lyhyt caption-teksti valitulla kieliversiolla.

Mitä toiminto tekee

• Kun asiakas on antanut suostumuksen kassalla, AI Commerce voi lähettää tilauksen laskun asiakkaan WhatsAppiin.
• Asiakas saa WhatsApp document message -viestin, jossa on PDF-lasku liitteenä.
• PDF:n tiedostonimi muodostetaan laskun otsikosta + .pdf. Jos otsikko puuttuu, nimi on order-<orderId>.pdf.
• PDF:n mukana menee caption-teksti, joka tulee käännösavaimesta:
  • Invoice -> THANKS_FOR_ORDER_WHATSAPP_MESSAGE
• Vastaanottaja on asiakkaan puhelinnumero (AI Commercen session account -data).

Ennen kuin aloitat

Tarvitset Metan puolelta

• WhatsApp Business Platformin käyttöön (WABA / lähettävä numero).
• Permanent Access Token (System User).
• Phone Number ID (lähettäjänumeron ID, ei puhelinnumero).

Tarvitset AI Commercen puolelta

• Konfiguraatioon lisättävät arvot: whatsapp_token ja whatsapp_phone_id.
• Integraatiokumppanin toteuttama kassavalinta (suostumus WhatsApp-viestiin).

Meta Business Manager – ylätason vaiheet

Tämä osuus tehdään Metan puolella (kauppiaan/tilin omistajan toimesta).

1. Varmista Business Manager / yritystili
   • Business Managerin tulee olla kunnossa ja tyypillisesti verifioitu, jotta WhatsApp Business Platformin käyttöönotto onnistuu.
2. Luo/ota käyttöön WhatsApp Business Account (WABA)
   • Lisää WhatsApp Business Account ja liitä se yritystiliin.
3. Lisää ja vahvista lähettävä puhelinnumero
   • Rekisteröi/varmista lähettävä numero WhatsAppiin (tämä on “sender”).
4. Luo (tai käytä olemassa olevaa) Meta App ja liitä WhatsApp
   • App Dashboardissa yhdistä WhatsApp-tuote ja liitä se oikeaan WABA:an + lähettävään numeroon.
5. Luo System User ja generoi Permanent Access Token
   • Polku: Business Settings → System Users
   • Luo System User (Admin/Employee) ja generoi Permanent Access Token.
   • Varmista permissionit:
     • whatsapp_business_management
     • whatsapp_business_messaging
6. Tärkein kohta: Asset assignment
   • Varmista, että System Userille on assignattu oikea WABA ja lähettävä numero (Phone) “assetteina”.
   • Pelkät permissionit eivät riitä, jos WABA/phone-asset ei ole liitetty System Userille.
7. Kerää talteen nämä kaksi arvoa
   • whatsapp_token = Permanent Access Token
   • whatsapp_phone_id = Phone Number ID (lähettäjänumeron ID)

Huom: Jos Meta API antaa virheitä tyyliin “Object does not exist / missing permissions”, syy on lähes aina väärä Phone Number ID tai puuttuva asset assignment System Userille.

AI Commerce – konfigurointi My Storeen

Mistä editoidaan

• Lisää asetukset AI Commercen Hallintapaneelissa MyStore-konfiguraatioon (MyStore).

Lisättävät asetukset

• whatsapp_token = WhatsApp API token
• whatsapp_phone_id = WhatsApp Phone Number ID

Kassaan suostumus kassalla

Integraatiokumppanin tulee lisätä AI Commercen kassalle valinta, esimerkiksi “Haluan vastaanottaa laskun WhatsAppiin”.

Suositukset toteutukseen

• Näytä valinta vasta kun asiakkaalla on puhelinnumero annettuna.
• Tallenna suostumus asiakkaan tili-/sessiodataan.

Suostumuksen tallennus API:lla

• Endpoint: /api/account/update
• Metodi: POST

Viestin kieliversiot

Captionin teksti tulee käännösavaimesta. 

• invoice -> THANKS_FOR_ORDER_WHATSAPP_MESSAGE
• checkout -> TEXT_GRANT_WHATSAPP_INVOICE

Testaus

1. Varmista, että Meta-puolella token + phone id on oikein ja System Userille on assignattu WABA/phone.
2. Lisää whatsapp_token ja whatsapp_phone_id MyStoreen.
3. Tee testiostos:
   • anna puhelinnumero
   • valitse kassalla WhatsApp-suostumus
4. Varmista, että lasku lähtee PDF-liitteenä ja caption vastaa haluttua käännöstä.

Yleisin ongelma ja mitä se tarkoittaa

• “Object does not exist / missing permissions” → whatsapp_phone_id on väärä tai System Userille ei ole assignattu WABA/phone-assetit Metassa.

Kun Meta-puolen asset assignment on kunnossa ja Phone Number ID on oikea, AI Commercen puolella ei yleensä tarvita lisämuutoksia — toiminnon pitäisi lähteä toimimaan samoilla asetuksilla.

Yhteenveto

• Ota Metassa käyttöön WABA + lähettävä numero, luo System User ja generoi Permanent Access Token.
• Varmista asset assignment (WABA + Phone) System Userille ja tallenna whatsapp_token sekä whatsapp_phone_id.
• Lisää arvot AI Commercen MyStore-konfiguraatioon.
• Toteuta kassalle suostumus ja tallenna se API:lla kenttään whatsAppInvoice.
• Testaa, että PDF lähtee WhatsAppiin ja caption käyttää oikeaa käännösavainta.

Avainsanat

• WhatsApp-laskuviesti
• WhatsApp document message
• PDF-lasku WhatsAppiin
• WABA (WhatsApp Business Account)
• Permanent Access Token (System User)
• Phone Number ID
• AI Commerce MyStore whatsapp_token
• AI Commerce MyStore whatsapp_phone_id
• /api/account/update whatsAppInvoice
• asset assignment WhatsApp