Mokapenin opas

WhatsApp Business

WhatsApp Business -integraatio yhdistää organisaatiosi WhatsApp Business -numeron Mokapeniin: voit lähettää ja — toisin kuin SMS — myös vastaanottaa viestejä yhteyshenkilöiltäsi ja hallita keskusteluja suoraan yhteyshenkilön kortilta tai yhtenäisestä Messages-postilaatikosta SMS:n ja chatin kanssa.

Tärkeää: kanava käyttää virallista Meta WhatsApp Business -alustaa. Yhdistämiseen tarvitaan Meta Business -tili ja Meta Developer -sovellus, jossa WhatsApp-tuote on määritetty (katso Vaatimukset): se ei ole suora yhteys henkilökohtaisen puhelimen WhatsApp-sovellukseen.

Integraatioiden yleiskatsaus: Integraatiot.

Vaatimukset

• Mokapen-paketti, joka sisältää WhatsApp Business -integraation (Premium — mitalikuvake sivulla, jos ei ole käytettävissä paketissasi).
• Vahvistettu Meta Business -portfolio.
• Portfolioon linkitetty Meta Developer -sovellus, jossa WhatsApp-tuote on määritetty.
• Puhelinnumero, joka ei ole jo linkitetty henkilökohtaiseen WhatsAppiin, WhatsApp Business -sovellukseen tai toiseen WhatsApp Business API -palveluntarjoajaan. Jos numero on jo rekisteröity muualla, se pitää ensin siirtää Mokapenin asetukseen Metan migraatioprosessin mukaan: ota yhteyttä Mokapen-tukeen, jos tarvitset apua.
• Krediittiä organisaation walletissa: jokainen lähetetty viesti vähentää krediittiä kohdemaan ja viestiluokan mukaan (katso Krediitti ja hinnat).

WhatsApp Business -tilin yhdistäminen

Yhteys tapahtuu Metan Embedded Signup -ikkunalla: Meta/Facebook-kirjautuminen, joka ohjaa Business-portfolion, WhatsApp Business -tilin (WABA) ja yhdistettävän numeron valintaan — se ei ole pelkkä QR-koodi.

1. Käyttäjävalikko → Integrations → WhatsApp Business.
2. Napsauta Connect WhatsApp Business (vaatii sopivan Premium-paketin).
3. Kirjaudu Meta-tililläsi avautuvaan ikkunaan ja seuraa ohjattuja vaiheita: valitse Business-portfolio, WhatsApp Business -tili ja yhdistettävä puhelinnumero.
4. Vahvista: Mokapen vastaanottaa tarvittavat oikeudet ja tilaa automaattisesti ilmoitukset (webhook) kyseiselle tilille.

Jos Meta ilmoittaa yhdistämisen aikana, että numero on jo toisella WhatsApp Business API -palveluntarjoajalla, valitse ehdotettu migraatio ja vahvista, että numero on jo WhatsApp Business API:ssa. Jos numero on edelleen henkilökohtaisessa WhatsApp-sovelluksessa, poista ensin tili kyseiseltä puhelimelta ja odota noin 15 minuuttia ennen uutta yritystä. Jos kaksivaiheinen vahvistus on päällä, poista se käytöstä ennen yhdistämistä (WhatsApp Managerissa tai nykyisen palveluntarjoajan kautta).

Numeron aktivointi

Embedded Signupin jälkeen numero pitää aktivoida ennen viestien lähettämistä:

1. Sivulla Integrations → WhatsApp Business napsauta Activate number.
2. Jos pyydetään, pyydä vahvistuskoodi SMS:llä tai äänipuhelulla yhdistettyyn numeroon ja syötä se, kun se saapuu.
3. Syötä 6-numeroinen PIN: jos kaksivaiheinen vahvistus on jo olemassa, käytä nykyistä PIN-koodia; muuten tästä tulee uusi PIN, jota Meta vaatii myöhemmin numeron hallintaan.
4. Valinnainen: valitse tietojen sijaintialue. Kun se on käytössä, sitä voi muuttaa vain poistamalla numeron rekisteröinnin ja rekisteröimällä uudelleen.
5. Vahvista: jos kaikki on kunnossa, numero siirtyy tilaan active ja voit alkaa käyttää integraatiota.

Meta sallii enintään 10 rekisteröintipyyntöä samalle numerolle 72 tunnin ikkunassa: jos ylität rajan, odota ennen uutta yritystä. Jos PIN on väärä, tarkista se WhatsApp Managerista tai nollaa se edellisellä palveluntarjoajalla, jos olet juuri siirtänyt numeron.

Krediitti ja hinnat

WhatsApp-viestien lähetys on kulutusperusteista: se käyttää samaa organisaation walletia (ennakkoon ladattu krediitti) kuin muut Mokapenin kulutusominaisuudet, esimerkiksi SMS — se ei ole erillinen krediitti.

• Viestin hinta riippuu numeron kohdemaasta ja viestin kategoriasta (marketing, utility, authentication tai vapaa keskusteluviesti 24 tunnin ikkunassa — katso seuraavat osiot).
• Sivulla Integrations → WhatsApp Business näkyy aina organisaation käytettävissä oleva krediitti ja suora linkki walletin lataukseen.
• Krediitti vähennetään lähetyksen hetkellä, ei etukäteen.
• Jos krediitti ei riitä, lähetys estetään ja Mokapen näyttää varoituksen — \"Insufficient WhatsApp Business credits. Please top up your credits to send messages.\" — sekä linkin lataussivulle.

Walletin lataus näkyy Ownerille ja organisaation oikeudet omaaville jäsenille; tarkista saldo ennen kampanjoita tai marketing-mallien massalähetyksiä.

Viestin lähettäminen käsin

WhatsApp-lähetyspainike on yhteyshenkilön kortilla. Kun napsautat WhatsApp-kuvaketta:

1. Valitse yhteyshenkilön puhelinnumero, jolle kirjoitat (kortilla olevista).
2. Jos sinulla on useampi WhatsApp Business -tili, valitse käytettävä.
3. Jos olet 24 tunnin ikkunassa (yhteyshenkilö kirjoitti äskettäin, katso seuraava osio), voit kirjoittaa vapaan viestin kuten tavallisessa WhatsAppissa. Jos olet ikkunan ulkopuolella tai tämä on ensimmäinen yhteydenotto, valitse Metan hyväksytty malli: valikossa näkyvät vain tilassa Approved olevat mallit.
4. Jos mallissa on paikkamerkkejä ({{1}}, {{2}}…), täytä arvot ennen jatkamista: ilman arvoja malli pysyy pois käytöstä.
5. Tarkista esikatselu (WhatsApp-kuplana) ja paina Send. Onnistuessa näkyy vahvistus \"WhatsApp Business message sent successfully.\" ja viesti siirtyy yhteyshenkilön historiaan.

Jos WhatsApp Business -integraatiota ei ole vielä aktiivisena, painike ohjaa sivulle Integrations → WhatsApp Business, jotta yhdistät tilin ensin.

24 tunnin ikkuna

WhatsApp Business asettaa säännön kaikille alustan yrityksille, ei vain Mokapenille: voit kirjoittaa yhteyshenkilölle vapaata tekstiä (ilman mallia) vain 24 tunnin kuluessa yhteyshenkilön viimeisestä viestistä — niin kutsuttu asiakaspalveluikkuna.

• Kun yhteyshenkilö kirjoittaa sinulle, ikkuna avautuu (tai uusiutuu) ja 24 tunnin ajan voit vastata vapaasti tekstillä tai liitteillä.
• Kun 24 tuntia on kulunut ilman uutta saapuvaa viestiä, tai jos et ole koskaan saanut viestiä kyseiseltä numerolta, sinun pitää käyttää Metan hyväksyttyä mallia (katso seuraava osio): näin aloitat tai jatkat kaupallista keskustelua ikkunan ulkopuolella.
• Jos yrität lähettää vapaata tekstiä ikkunan ulkopuolella, lähetys estetään: valitse sopiva malli (tyypillisesti kategoria Utility) vapaan viestin sijaan.

WhatsApp Business -mallit

Viestimallit ovat Metan ennakkohyväksymiä muotoja, joita tarvitaan keskustelun aloittamiseen tai kirjoittamiseen 24 tunnin ikkunan ulkopuolella. Voit hallita niitä kahdella tavalla:

• Synkronoi Metaan jo olemassa olevat mallit — sivulla Integrations → WhatsApp Business käytä Sync templates: Mokapen tuo tilassa Approved olevat mallit, joita ei ole vielä linkitetty, joten voit käyttää niitä heti käsin lähetyksessä.
• Luo tai muokkaa malleja Mokapenissa — kohdassa Settings → Templates, tyyppi WhatsApp Business: luonti, muokkaus tai poisto tapahtuu suoraan Metassa linkitetyn sovelluksen kautta, ja hyväksynnän tila päivittyy automaattisesti, kun Meta ilmoittaa sen.

Tärkeitä sääntöjä mallia luodessa:

• Kategoria — Utility (käyttäjän odottamat tapahtumapäivitykset: tilauksen tila, tapaamisen muistutus, tilivaroitukset), Marketing (kampanjat, tarjoukset, uutiskirjeet: vastaanottajan pitää olla antanut nimenomainen suostumus WhatsApp-viesteihin yritykseltäsi) tai Authentication (OTP- tai vahvistuskoodit, omat painikkeet). Kategorian pitää vastata sisältöä: väärä luokitus voi johtaa hylkäykseen tai heikompaan laatupisteeseen.
• Rakenne — valinnainen otsikko (teksti, kuva, video, asiakirja tai sijainti), pakollinen runko, valinnainen alatunniste, enintään 3 painiketta (nopea vastaus, URL-linkki tai puhelinnumero).
• Nimi — vain pieniä kirjaimia, numeroita ja alaviivoja (esim. order_confirmation), uniikki tilillä ja kielellä.
• Paikkamerkit — käytä {{1}}, {{2}}, {{3}} järjestyksessä ilman hyppyjä; anna esimerkkiarvot luonnissa.
• Merkkirajat — runko enintään 1 024 merkkiä, tekstiotikko ja alatunniste enintään 60 merkkiä kumpikin, painikkeen teksti enintään 20 merkkiä, enintään 3 painiketta mallia kohti.

Meta tarkistaa jokaisen mallin ennen käyttöä: hyväksyntä kestää yleensä muutaman minuutin, joskus jopa 24 tuntia. Hylätty malli näyttää syyn; heikko laatupiste tai liian monet vastaanottajien estot/ilmoitukset voivat rajoittaa WhatsApp Business -tiliä.

Historia, keskustelut ja vastaanotto

Toisin kuin SMS, WhatsApp Business on kaksisuuntainen: yhteyshenkilö voi kirjoittaa vapaasti, ja viesti saapuu uutena keskusteluna Mokapeniin.

• Yhteyshenkilön kortti — historiassa/aikajanalla näkyvät sekä lähetetyt että vastaanotetut viestit tekstiesikatselulla.
• Messages-postilaatikko — WhatsApp-ketjut näkyvät SMS:n ja chatin kanssa samassa postilaatikossa tekstihakuineen. Toisin kuin SMS:ssä, WhatsAppissa Mokapen päivittää automaattisesti toimitus- ja lukutilan (lähetetty, toimitettu, luettu), kun Meta ilmoittaa tapahtumat.
• Yhteyshenkilö voi lähettää tekstiä, kuvia, asiakirjoja, ääntä, videota ja tarroja, myös vastauksena tiettyyn viestiin: kaikki saapuu samaan ketjuun Messages-postilaatikossa.

Rajoitukset

• Ei automaatioissa — Automations-moduuli tarjoaa tänään Send Email- ja Send SMS -toiminnot, mutta ei WhatsApp Business -toimintoa: lähetys onnistuu vain käsin yhteyshenkilön kortilta.
• Vapaa teksti vain 24 tunnin sisällä — asiakaspalveluikkunan ulkopuolella tarvitset aina Metan hyväksymän mallin.
• Yksi kanava yhteyshenkilöllä tänään — lähetyspainike on Contacts-alueella; Companies- tai muilla korteilla WhatsApp-lähetystä ei vielä näy käyttöliittymässä.
• Numeroa ei voi jakaa muihin käyttötarkoituksiin — Mokapeniin WhatsApp Business API:lla yhdistetty numero ei voi olla samanaikaisesti aktiivinen henkilökohtaisessa WhatsAppissa tai toisella API-palveluntarjoajalla.
• Rekisteröintiraja — enintään 10 aktivointiyritystä numeroa kohti 72 tunnissa; raja on Metan, ei Mokapenin.

Yleiset ongelmat

• Yhdistäminen ei onnistu — tarkista vahvistettu Meta Business -portfolio, linkitetty Developer-sovellus WhatsApp-tuotteella, ja yritä Embedded Signup uudelleen.
• Numero on edelleen henkilökohtaisessa WhatsAppissa — poista WhatsApp-tili kyseiseltä numerolta puhelimessa, odota noin 15 minuuttia ja yritä yhdistää uudelleen.
• Numero on jo toisella API-palveluntarjoajalla — valitse yhdistämisessä migraatio ja vahvista se; jos kaksivaiheinen vahvistus on päällä, poista se ensin WhatsApp Managerista tai nykyiseltä palveluntarjoajalta.
• Väärä vahvistus-PIN — tarkista 6-numeroinen kaksivaiheisen vahvistuksen PIN WhatsApp Managerista tai nollaa se edellisellä palveluntarjoajalla, jos olet juuri siirtänyt numeron.
• WhatsApp on yhdistetty, mutta webhook-tilaus epäonnistui — saapuvat viestit eivät ehkä näy: ota yhteyttä Mokapen-tukeen, jos ongelma jatkuu yhdistämisen uudelleenyrityksen jälkeen.
• Vapaa viesti ei lähde — olet todennäköisesti 24 tunnin ikkunan ulkopuolella: valitse hyväksytty malli vapaan tekstin sijaan.
• Meta hylkäsi mallin — tarkista ilmoitettu syy: kategoria ei vastaa sisältöä, väärin numeroidut tai hypätyt paikkamerkit, kielletty sisältö (roskaposti, tekaistu kiire, arkaluontoiset tiedot) tai rakennesääntöjen vastainen muoto.
• Krediitti ei riitä — lataa organisaation wallet sivun Integrations → WhatsApp Business linkistä tai Billing-osiosta.

Yhteyden katkaisu

Sivulla Integrations → WhatsApp Business napsauta Disconnect: avautuu ikkuna, jossa on osio Keep.

• Valinta Messages & Templates on oletuksena päällä: jos jätät sen päälle, viestihistoria ja synkronoidut mallit jäävät näkyviin Mokapeniin myös katkaisun jälkeen.
• Jos poistat valinnan, Mokapen poistaa synkronoidut mallit, tähän integraatioon liittyvät WhatsApp-ketjut ja -viestit sekä liittyvät mediatiedostot.

Joka tapauksessa Meta-tilin linkki ja webhook-tilaus poistetaan aina. Jos olet käyttäjä, jolle integraatio on jaettu (et Owner), katkaisu poistaa vain sinun pääsysi: integraatio jää organisaatiolle. Vahvista kirjoittamalla DISCONNECT pakolliseen kenttään.

Käyttötapaukset

• Tilauksen tai tapaamisen vahvistus — käytä hyväksyttyä Utility-mallia juuri suljetun tilauksen tai sovitun tapaamisen vahvistamiseen: asiakas saa ilmoituksen, vaikka ei olisi vielä kirjoittanut sinulle, ilman sähköpostin odottamista.
• Reaaliaikainen asiakastuki — asiakas kirjoittaa WhatsAppissa kysymyksen: viesti saapuu yhteyshenkilön kortille ja Messages-postilaatikkoon, ja seuraavat 24 tuntia voit vastata vapaalla tekstillä, kuvilla tai asiakirjoilla ilman mallia.
• Toimituksen tilapäivitys — Utility-malli paikkamerkeillä tilausnumerolle ja arvioidulle päivälle, lähetetty käsin yhteyshenkilön kortilta, kun toimituksen tila muuttuu.
• Vahvistuskoodi — Authentication-kategorian malli OTP-painikkeella, kun tarvitset lähettää turvakoodin luotettavasti ja kirjata sen historiaan.
• Kampanja nimenomaisella suostumuksella — Marketing-malli vain yhteyshenkilöille, jotka ovat antaneet nimenomaisen suostumuksen WhatsApp-viesteihin yritykseltä, esimerkiksi kausikampanjan ilmoitukseen.

Usein kysytyt kysymykset

K: Voinko vastaanottaa asiakkaiden viestejä Mokapenissa, toisin kuin SMS:ssä?

V: Kyllä. WhatsApp Business on kaksisuuntainen: jos yhteyshenkilö kirjoittaa, viesti näkyy uutena keskusteluna kortilla ja Messages-postilaatikossa, ja 24 tunnin sisällä voit vastata vapaalla tekstillä.

K: Tarvitsenko todella Meta Business -tilin WhatsAppin yhdistämiseen?

V: Kyllä. Tarvitaan vahvistettu Meta Business -portfolio ja Meta Developer -sovellus WhatsApp-tuotteella: yhteys tapahtuu Metan Embedded Signupin kautta, ei suoraan puhelimen WhatsApp-sovelluksesta.

K: Numeroni on jo tavallisessa WhatsAppissa tai toisella palveluntarjoajalla: voinko silti yhdistää sen?

V: Kyllä, mutta se pitää ensin vapauttaa tai siirtää: jos se on henkilökohtaisessa WhatsAppissa, poista tili kyseiseltä puhelimelta ja odota noin 15 minuuttia; jos se on jo toisella WhatsApp Business API -palveluntarjoajalla, valitse migraatio yhdistämisessä ja vahvista.

K: Voinko kirjoittaa asiakkaalle vapaasti milloin tahansa?

V: Ei. Voit kirjoittaa vapaata tekstiä vain 24 tunnin kuluessa asiakkaan viimeisestä viestistä. Ikkunan ulkopuolella tai ensimmäisessä yhteydenotossa tarvitset Metan hyväksymän mallin.

K: Miten luon tai päivitän viestimallin?

V: Kohdassa Settings → Templates, tyyppi WhatsApp Business: luot tai muokkaat mallia, joka tallennetaan ja lähetetään hyväksyttäväksi suoraan Metaan. Vaihtoehtoisesti, jos sinulla on jo hyväksyttyjä malleja Metassa, käytä Sync templates sivulla Integrations → WhatsApp Business tuodaksesi ne.

K: Paljonko WhatsApp-viestin lähettäminen maksaa?

V: Hinta riippuu kohdemaasta ja viestiluokasta (marketing, utility, authentication tai vapaa keskustelu 24 tunnin ikkunassa). Krediitti vähennetään organisaation walletista lähetyksen hetkellä: tarkista saldo sivulla Integrations → WhatsApp Business.

K: Onko WhatsApp Business käytettävissä automaatioiden toimintona kuten Email tai SMS?

V: Ei vielä: Automations-moduuli tarjoaa tänään vain Send Email ja Send SMS. WhatsApp-lähetys onnistuu vain käsin yhteyshenkilön kortilta.

K: Miksi Meta hylkäsi mallini?

V: Yleisimmät syyt: kategoria ei vastaa sisältöä, väärin numeroidut tai hypätyt paikkamerkit, kielletty sisältö (roskaposti, tekaistu kiire, arkaluontoisten tietojen pyyntö) tai rakennesääntöjen vastainen muoto. Tarkka syy näkyy Metassa mallilla.

K: Mitä datalle tapahtuu, jos katkaisen integraation?

V: Jos «Messages & Templates» on valittuna (oletus), viestihistoria ja synkronoidut mallit jäävät näkyviin Mokapeniin. Jos poistat valinnan, Mokapen poistaa mallit, ketjut, viestit ja mediatiedostot. Meta-tilin linkki poistetaan aina.

K: Voinko käyttää useampaa WhatsApp Business -numeroa samassa organisaatiossa?

V: Kyllä, jos WhatsApp Business -tililläsi (WABA) on useampi numero tai jos yhdistät useamman tilin: kirjoitusikkunassa, jos vaihtoehtoja on useita, valitse lähettäjä ennen lähetystä.