Artikkelit
WhatsApp Business API selitettynä: käyttöoikeus, viestimallit, kulut ja CRM-yhteys
WhatsApp Business API on Metan virallinen tapa liittää numero ohjelmistoon puhelimen sijaan. Tässä on, mitä tarvitset, mitä se maksaa ja mikä muuttuu päivittäisessä työssä.
Mikä WhatsApp Business API on?
Se on rajapinta, ei sovellus. Sitä ei ladata, eikä siinä ole näkymää, johon kirjauduttaisiin. Ohjelmistosi (CRM, asiakaspalvelujärjestelmä tai oma skripti) keskustelee WhatsAppin kanssa sen kautta: saapuvat viestit tulevat webhook-osoitteeseen, ja vastaukset lähtevät API-kutsuina.
Nykyään Meta dokumentoi rajapinnan nimellä Cloud API, ja se toimii Metan omilla palvelimilla. Kun joku hakee sanoilla ”whatsapp api”, ”api of whatsapp” tai ”whatsapp cloud api”, hän tarkoittaa juuri tätä. ”WhatsApp Business Platform” on Metan laajempi nimi koko yritysviestinnän tarjonnalle; Cloud API on sen sisällä oleva rajapinta.
Mitä voitat puhelimeen verrattuna: useampi ihminen voi vastata samasta numerosta, ohjelmisto voi lähettää viestejä, ja jokainen keskustelu voi olla yhteystiedon ja kaupan rinnalla. Mitä hyväksyt: viestimalleja koskevat säännöt, 24 tunnin ikkunan ja viestikohtaisen laskutuksen. Ne kaikki käydään läpi alla.
Mitä eroa on WhatsApp Business -sovelluksella, WhatsApp Business Webillä ja API:lla?
- WhatsApp Business -sovellus. Puhelinsovellus, jonka WhatsApp kertoo suunnitelleensa pienyrittäjää ajatellen. Yksi yritys ja yleensä yksi ihminen näppäimistön ääressä.
- WhatsApp Business Web. Hakusana, jolla etsitään tapaa avata sama yritystili selaimessa. Kyse on yhä sovelluksen chat-ikkunasta eikä integraatiosta: mitään ei ole kytketty kauppoihin, tehtäviin tai raportteihin.
- WhatsApp Business API (Cloud API). Ohjelmointirajapinta. Numero rekisteröidään alustalle, ja keskustelut hoitaa ohjelma, ei puhelin.
Jos sinun tarvitsee vastata vain muutamalle ihmiselle läppäriltä, sovellus ja sen selainversio voivat riittää. Siirry API:hin, kun useampi työntekijä jakaa numeron, kun viestien pitää lähteä automaattisesti tai kun keskustelujen pitää päätyä CRM:ään.
Kuka saa käyttöoikeuden ja mitä tarvitset?
Metan aloitusopas edellyttää Facebook-tiliä tai hallinnoitua Meta-tiliä, rekisteröitymistä kehittäjäksi ja testiviestejä varten laitetta, jossa on WhatsApp. Samassa prosessissa valitset tai luot Metan yritysportfolion, luot sovelluksen WhatsApp-käyttötapauksella ja lisäät puhelinnumeron.
Numerolle on omat sääntönsä, Metan puhelinnumeroita koskevan dokumentaation mukaan:
- Jo WhatsAppissa käytössä olevaa numeroa ei voi rekisteröidä, ennen kuin se on ensin poistettu WhatsAppista.
- Numeron on oltava sinun, siinä on oltava maa- ja suuntanumero, ja sen on pystyttävä vastaanottamaan tekstiviesti tai puhelu vahvistusta varten.
- Näyttönimi vaaditaan rekisteröinnissä. Se näkyy numeron WhatsApp-profiilissa.
Testaamisen aloittamiseen ei tarvita viestimalleja: Metan oma pika-aloitus lähettää valmiin hello_world-viestimallin. Omia hyväksyttyjä viestimalleja tarvitset siitä lähtien, kun kirjoitat asiakkaalle ensin tai vastaat ikkunan jo sulkeuduttua.
Miten 24 tunnin ikkuna toimii?
Kun asiakas kirjoittaa tai soittaa sinulle, avautuu 24 tunnin ikkuna. Jokainen asiakkaan uusi viesti käynnistää sen alusta. Niin kauan kuin ikkuna on auki, voit lähettää vapaamuotoisia viestejä. Kun se sulkeutuu, sallittuja ovat vain viestimallit (sääntö on kirjattu Metan hinnoittelusivulle).
Viestimallit jakautuvat kolmeen luokkaan: markkinointi, hyötyviestit ja tunnistautuminen. Luot ne WhatsApp Managerissa, ja Meta tarkistaa ne; varaudu odottamaan, ennen kuin uusi malli on käytössä.
Miten Meta laskuttaa WhatsApp Business API:sta?
Metan hinnoittelusivun mukaan, tarkistettu 18. marraskuuta 2026:
- Meta on 1. heinäkuuta 2025 alkaen veloittanut jokaisesta toimitetusta viestistä eikä keskustelusta. Hinta riippuu viestiluokasta ja vastaanottajan maatunnuksesta.
- Asiakkaiden sinulle lähettämistä viesteistä ei veloiteta.
- Viestimallit ovat markkinointi-, hyöty- tai tunnistautumisviestejä; ikkunan sisällä ilman mallia lähetetyt vastaukset ovat palveluviestejä. Lisäksi Meta listaa Meta Business Agentin.
- Jokainen yrityksen puhelinnumero saa 1 000 ilmaista palveluviestiä kuukaudessa, ja kiintiö nollautuu joka kuukausi. 1. lokakuuta 2026 alkaen palveluviesteistä veloitetaan 1 001. viestistä lähtien.
- Jos viestitilillä ei ole maksutapaa, Meta toimittaa palveluviestit vain ilmaiskiintiön rajoissa.
- Avoimen ikkunan sisällä lähetetyt hyötyviestimallit olivat ilmaisia 30. syyskuuta 2026 asti, ja niistä veloitetaan 1. lokakuuta 2026 alkaen.
- Jos asiakas kirjoittaa sinulle mobiilisovelluksessa Click to WhatsApp -mainoksesta ja vastaat ikkunan sisällä, avautuu enintään 7 päivän ilmainen sisääntuloikkuna markkinointi-, hyöty-, tunnistautumis- ja palveluviesteille.
Dollarihinnat ovat hinnastotiedostoissa, joihin Meta linkittää samalta sivulta, ja ne vaihtelevat maan ja luokan mukaan. Tarkista omien maidesi tiedosto ennen kuin teet budjetin; tässä ei mainita yhtään hintaa.
Meta laskuttaa maksunsa siltä WhatsApp-tililtä, jonka yhdistät. CRM tai muu ohjelmistotoimittaja veloittaa niiden päälle oman maksunsa.
Voiko sen kautta lähettää markkinointiviestejä ja käyttää botteja?
Kyllä, Metan sääntöjen puitteissa: markkinointiviestimallit ovat oma viestiluokkansa omalla hinnallaan, ja botti on ohjelmisto, joka käyttää samaa API:a samojen ikkuna- ja viestimallisääntöjen mukaan.
Haku ”WhatsApp API send message” tarkoittaa käytännössä kahdenlaista kutsua: vapaamuotoista viestiä ikkunan sisällä tai viestimallia sen ulkopuolella. Asiakkaan viimeisimmän viestin ajankohta ratkaisee, kumpi on käytettävissä.
Miten NeuroCRM liitetään WhatsApp Business API:hin?
NeuroCRM tukee kahta tapaa yhdistää WhatsApp. Laajempi vertailu molemmista on oppaassa WhatsApp CRM: virallinen API vai QR-yhdyskäytävä. Tällä sivulla käydään tarkemmin läpi API-puoli.
Cloud API:n yhdistäminen käsin
Valitse kohdassa Asetukset → Integraatiot WhatsApp Business Cloud API ja täytä neljä kenttää:
- Puhelinnumeron tunnus (Phone Number ID) Metan API Setup -näkymästä.
- Pysyvä pääsytunnus (järjestelmäkäyttäjä), jonka luot kohdassa Business Settings → System Users.
- Sovelluksen salaisuus (App Secret), jolla saapuvien webhookien allekirjoitus tarkistetaan.
- WhatsApp Business -tilin tunnus (WABA ID).
Napsauta sitten ”Vahvista ja yhdistä”. NeuroCRM näyttää takaisinkutsun URL-osoitteen (Callback URL) ja vahvistustunnuksen (Verify Token); liitä molemmat Meta-sovellukseesi kohtaan WhatsApp → Configuration → Webhooks ja tilaa kenttä messages. Voit lisätä useita numeroita.
Yhden napin ratkaisua ei ole. Luot Meta-sovelluksen, järjestelmäkäyttäjän ja tunnuksen itse, joten varaa ensimmäiseen yhdistämiseen aikaa. Tee Metan puolen määritykset valmiiksi ennen kuin aloitat.
Mitä asiakaspalvelijat näkevät
Jokainen WhatsApp-keskustelu tulee samaan viestinäkymään kuin muut kanavasi, ja sen vieressä on yhteystietokortti. NeuroCRM laskee 24 tuntia asiakkaan uusimmasta todellisesta WhatsApp-viestistä ja pitää ikkunaa suljettuna jo viisi minuuttia etuajassa.
Kun ikkuna on kiinni, NeuroCRM lähettää tekstisi sijaan hyväksytyn viestimallin: valitsemasi mallin, tilin oletusmallin tai hyväksytyn mallin, jossa ei ole muuttujia eikä mediaa. Luonnoksesi odottaa vastauskentässä, kunnes asiakas vastaa. Jos hyväksyttyä mallia ei ole, lähetys estetään, ja toinen viestimalli lähtee ennen asiakkaan vastausta vain, jos valitset sen listasta uudelleen.
Säännöt, automaatiot ja tekoäly
- Automaatiot. Ikkunan ulkopuolella automaatio ei lähetä viestiä eikä valitse viestimallia: vaihe merkitään lähettämättömäksi. Kauppojen tapahtumissa viesti menee yhteystiedon varhaisimpaan keskusteluun kanavasta riippumatta.
- Myyntisekvenssit. WhatsApp-vaihe lähettää sen hyväksytyn viestimallin, jonka nimeät kyseisessä vaiheessa.
- Tekoälyvastaukset. AI-yhteyskeskus on maksullinen lisäosa: $200 kuukaudessa ja $0,50 jokaisesta onnistuneesta keskustelusta, omalla tekoälyavaimellasi 0 %:n katteella tai NeuroCRM:n kautta +20 %. 24 tunnin ikkunan ulkopuolella se ei vastaa eikä lähetä viestimallia. Aikoja se ei varaa itse.
GREEN-API-vaihtoehto
GREEN-API on epävirallinen yhdyskäytävä. Liität henkilökohtaisen numeron QR-koodilla GREEN-API:n konsolissa ja syötät sitten NeuroCRM:ään tunnukset idInstance ja apiTokenInstance. Integraation oman vihjeen mukaan se sopii ”tapauksiin, joissa virallinen WhatsApp Business API ei ole saatavilla”. Se ei ole Metan alusta, joten yllä kuvatut viestimalli- ja ikkunasäännöt eivät koske sitä.
Mitä NeuroCRM ei tee WhatsApp Business API:n kanssa?
- Ei yhdistämistä yhdellä napsautuksella. Metan tunnukset syötetään käsin; Metan Embedded Signup -prosessia ei tarjota painikkeena.
- Ei coexistence-käyttöä. Numero, jota käytetään yhtä aikaa WhatsApp Business -sovelluksessa ja API:ssa, ei toimi NeuroCRM:n kautta.
- Metan viestimaksut eivät sisälly käyttäjäpaikan hintaan, eikä NeuroCRM päätä niistä; Meta laskuttaa yhdistämääsi tiliä.
- Automaatiot tai tekoäly eivät valitse viestimallia itse 24 tunnin ikkunan ulkopuolella.
Mitä WhatsAppin käyttö NeuroCRM:ssä maksaa?
Käyttäjäpaikka maksaa $13 käyttäjältä kuukaudessa tai $10,40, kun maksat vuoden kerralla, eikä ilmaista pakettia ole. 14 päivän kokeilussa on kaikki mukana ja käyttäjiä rajattomasti, minkä jälkeen tili muuttuu vain luku -tilaan. Katso hinnat. AI-yhteyskeskus on edellä kuvattu erillinen lisäosa. Metan viestikohtaiset maksut ovat kolmas kuluerä, jonka Meta laskuttaa.
Järjestelmiä voi verrata NeuroCRM:n vertailuissa ja Kommo-vaihtoehtojen oppaassa. Miten WhatsApp toimii muiden kanaviesi rinnalla, kerrotaan yhteistä viestinäkymää käsittelevässä artikkelissa.
Tarkistuslista ennen yhdistämistä
- Valitse numero, joka on sinun ja johon voit vastaanottaa vahvistustekstiviestin tai -puhelun. Jos numero on jo WhatsAppissa, varaudu poistamaan se sieltä ensin.
- Luo Metan yritysportfolio, sovellus WhatsApp-käyttötapauksella ja järjestelmäkäyttäjä pysyvällä tunnuksella.
- Valitse näyttönimi.
- Lisää maksutapa Metan puolelle, muuten ilmaiskiintiön ylittäviä palveluviestejä ei toimiteta.
- Lähetä WhatsApp Managerissa tarkistettavaksi vähintään yksi hyötyviestimalli ja odota Metan hyväksyntää ennen käyttöönottoa.
- Kirjaa ylös Phone Number ID ja WABA ID API Setup -näkymästä.
- Yhdistä NeuroCRM:ssä, kopioi takaisinkutsun URL-osoite ja vahvistustunnus Metaan ja tilaa
messages. - Lähetä itsellesi viesti, vastaa siihen, odota ikkunan sulkeutumista ja testaa viestimalli.
Usein kysyttyä
Onko WhatsApp Business API ilmainen?
Ei kokonaan. Meta veloittaa jokaisesta toimitetusta viestistä; ilmaisia ovat vain asiakkaiden viestit, numeron ensimmäiset 1 000 palveluviestiä kuukaudessa ja ilmaisessa sisääntuloikkunassa lähetetyt viestit.
Mitä eroa on WhatsApp API:lla ja Cloud API:lla?
Uudessa käyttöönotossa ne ovat käytännössä sama asia: Cloud API on versio, jota Meta ylläpitää ja dokumentoi, ja sitä NeuroCRM:n WhatsApp Business Cloud API -integraatio käyttää.
Voinko käyttää WhatsApp Business -sovelluksen numeroa API:n kanssa?
Metan mukaan WhatsAppissa jo käytössä oleva numero on poistettava WhatsAppista ennen rekisteröintiä. NeuroCRM:n kautta saman numeron käyttö yhtä aikaa sovelluksessa ja API:ssa (coexistence) ei toimi.
Miksi viestini ei mennyt asiakkaalle perille?
Kaksi tavallista syytä: 24 tunnin ikkuna oli sulkeutunut eikä viesti ollut viestimalli, tai Meta-tilillä ei ollut maksutapaa, kun ilmaiset palveluviestit loppuivat. Suljetussa ikkunassa NeuroCRM ei lähetä pelkkää tekstiäsi, vaan lähettää ensin hyväksytyn viestimallin ja jättää tekstisi vastauskenttään.
Voiko useampi ihminen vastata samasta API-numerosta?
Kyllä. Yhden numeron keskustelut tulevat NeuroCRM:ssä yhteiseen viestinäkymään, ja voit yhdistää useita numeroita.
Lähteet
- Meta, WhatsApp Business Platformin hinnoittelu — https://developers.facebook.com/docs/whatsapp/pricing (tarkistettu 18. marraskuuta 2026)
- Meta, Cloud API:n aloitusopas — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (tarkistettu 18. marraskuuta 2026)
- Meta, puhelinnumerot — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (tarkistettu 18. marraskuuta 2026)
- WhatsApp Business -sovellus — https://whatsappbusiness.com/products/business-app/ (tarkistettu 18. marraskuuta 2026)
Näin artikkeli on tehty: NeuroCRM-tiimi kirjoitti sen tekoälyn avustuksella; tuotetta koskevat väitteet on tarkistettu NeuroCRM:n koodista ja ohjeista, ja hinnat ovat julkaistusta hinnastosta päivityspäivän mukaan.