Tässä oppaassa näytetään, miten integroit Quickchat AI Agentin WhatsAppiin. Prosessi on jaettu 2 yksinkertaiseen vaiheeseen:
- Vaihe 0 - Edellytykset
- Vaihe 1 - Yhdistä WhatsApp
Jos sinulla on ongelmia integraation kanssa tai tarvitset apua, siirry osioon Vianmääritys ja UKK tai ota meihin yhteyttä.
Katso video
Vaihe 0 - Edellytykset
A. Yrityksen puhelinnumero
Päätä, mitä puhelinnumeroa käytät WhatsAppissa. Voit lukea lisää WhatsAppin dokumentaatiosta tai seurata alla olevia UKK-kohtia:
Mitä numeroa voi käyttää WhatsApp Cloud APIssa?
- Sinun on käytettävä erillistä yrityksen puhelinnumeroa, joka voi vastaanottaa tekstiviestejä tai äänipuheluita vahvistusta varten.
- Numeron on oltava voimassa, sinun omistamasi, ja siinä on oltava maa- ja suuntanumero.
Voinko käyttää numeroa, joka on jo käytössä WhatsApp Messengerissä?
- Et. Voit jatkaa tämän numeron käyttöä puheluihin ja tekstiviesteihin, mutta et WhatsApp Messengerissä.
- Jos numero on jo käytössä WhatsApp Messengerissä, poista se ensin. Muista varmuuskopioida WhatsApp-keskusteluhistoriasi.
- Estetyt numerot on poistettava estosta ennen rekisteröintiä.
Voinko käyttää numeroa, joka on jo käytössä WhatsApp Business Appissa?
- Kyllä. Jos numerosi on tällä hetkellä käytössä WhatsApp Business Appissa, voit ehkä ottaa sen käyttöön Cloud APIssa poistamatta sovelluksen tiliä. Lue lisää Coexistence-käyttöönotosta Metan dokumentaatiosta.
Voinko käyttää uutta puhelinnumeroa?
- Kyllä, jos et halua käyttää nykyistä numeroasi, hanki uusi numero (fyysinen SIM tai virtuaalinumero). Voit ostaa virtuaalisen puhelinnumeron palveluista, kuten Hushed.
B. Yrityksen tiedot
Pidä nämä tiedot valmiina (syötät ne Meta-integraation työnkulun aikana):
- Yrityksen nimi
- Yrityksen verkkosivusto
- Yrityksen toimiala
- Yrityksen kuvaus
Vaikka jotkin kentät vaikuttavat valinnaisilta, täytä ne tarkasti. Puuttuvat tai epätarkat tiedot voivat viivästyttää hyväksyntää tai aiheuttaa tilirajoituksia.
Vaihe 1 - Yhdistä WhatsApp
Viimeisimmän päivityksemme jälkeen yhdistäminen vaatii yhden klikkauksen. Erillistä toista vaihetta ei enää ole: Metan oma Embedded Signup -ohjattu toiminto opastaa sinua uuden WhatsApp Business Accountin ja numeron luomisessa tai jo olemassa olevan valinnassa, ja Quickchat AI hoitaa loput.
Avaa Quickchat AI App → External Apps → WhatsApp → klikkaa Connect WhatsApp -painiketta ja seuraa Metan ponnahdusikkunaa:
- Kirjaudu Meta (Facebook) -tilillesi.
- Tarkista käyttöoikeudet, jotka jaat Quickchat AI:n kanssa (WhatsApp Business -tilin käyttöoikeus ja Business portfolio -käyttöoikeus), ja jatka.
- Anna tarkat yritystiedot (Business Portfolio, Business Name, Business Website, Country jne.).
- Luo tai valitse WhatsApp Business Account.
- Valitse WhatsApp Business -näyttönimi ja kategoria.
- Lisää yrityksen puhelinnumero ja vahvista se tekstiviestillä tai äänipuhelulla ohjeiden mukaisesti.
- Klikkaa Confirm, jotta Quickchat AI saa tarvittavat käyttöoikeudet.
- Kun Meta vahvistaa, että määritys on valmis, klikkaa Finish. Ponnahdusikkunassa näkyy Quickchat AI:n vahvistus siitä, että WhatsApp-tilisi on yhdistetty, ja ikkuna sulkeutuu automaattisesti.
Takaisin Quickchat AI Appissa WhatsApp-paneeli näyttää tilan Connecting your WhatsApp account ja päivittyy tilaan Connected noin 30 sekunnissa. Jos näin ei tapahdu, klikkaa paneelissa Refresh Status. Muussa tapauksessa palaa yllä olevaan Edellytykset-osioon varmistaaksesi, että annoit yrityksen puhelinnumeron ja tiedot oikein.
Connected tarkoittaa, että Quickchat AI saa yhteyden WhatsApp Business Accountiisi. Heti sen alla paneeli näyttää, mitä vielä tarvitaan ennen kuin asiakkaat saavat vastauksia:
Connected-paneeli listaa jäljellä olevat asiat: tässä ensimmäinen viesti
- Waiting for your first message: lähetä WhatsApp-viesti näytettyyn numeroon toisesta puhelimesta ja klikkaa sitten Refresh. Kun viesti on saapunut, paneelissa näkyy Messages Received kohtien Webhook Active ja Admin Assigned vieressä.
- Display name: jokaisella paneelin alempana listatulla numerolla on Metasta tuleva näyttönimen tila (Approved, Pending review, Declined, Expired tai No display name). Käynnissä oleva tarkistus ei vaadi sinulta toimia ja valmistuu yleensä muutamassa päivässä. Hylätty, vanhentunut tai puuttuva näyttönimi edellyttää, että lähetät sellaisen WhatsApp Managerissa.
- Meta test number: jos aktiivinen numero on Metan tarjoama +1 555 -numero, paneeli kertoo sen. Nämä numerot on tarkoitettu kokeiluun, eikä niitä voi siirtää toiselle tilille. Lisää oma numerosi WhatsApp Managerissa, jotta voit siirtyä tuotantokäyttöön.
Kun paneelissa näkyy Messages Received, olet tuotantokäytössä. 🎉 Asiakkaat voivat lähettää viestin WhatsApp-numeroosi, ja AI Agent vastaa automaattisesti.
Integraation viimeiseksi tarkistukseksi lähetä tekstiviesti juuri yhdistämääsi WhatsApp-numeroon ja klikkaa sitten paneelissa Refresh. Waiting for your first message muuttuu tilaksi Messages Received, sinun pitäisi saada vastaus AI Agentiltasi, ja keskustelun pitäisi näkyä Quickchat AI App Inboxissa. Jos jätät jonkin Metan määritysvaiheen kesken, Quickchat AI lähettää myös tilin omistajalle muistutussähköpostin jäljellä olevista vaiheista.
Vianmääritys ja UKK
Miten WhatsApp Business API:n hinnoittelu toimii?
- Vastauksia käyttäjän aloittamiin (saapuviin) asiakaskyselyihin WhatsApp käsittelee Service messages -viesteinä. Näiden viestien avulla yritykset voivat hallita saapuvia asiakaskyselyitä joko ihmisagentin tai keskustelevaa tekoälyä käyttävän botin kautta.
- Kun käyttäjät lähettävät yritykselle viestin, se avaa 24 tunnin asiakaspalveluikkunan, jonka aikana yritykset voivat vastata palveluviesteillä maksutta. Tämä ikkuna nollautuu jokaisesta käyttäjän viestistä.
- 24 tunnin jälkeen sinun on käytettävä hyväksyttyjä Message Templates -viestipohjia (Marketing, Utility, Authentication jne.) ja maksettava viestikohtaisesti WhatsApp Business Platform Message Rates -hinnoittelun mukaisesti.
- Meta luokittelee ja laskuttaa keskustelut. Varmista, että WhatsApp Business Accountillasi on voimassa oleva maksutapa yrityksen aloittamia tai mallipohjaisia viestejä varten.
Connect WhatsApp -painike ei toimi. En näe Metan ponnahdusikkunaa.
- Jos selaimesi estää ponnahdusikkunan, sovellus näyttää viestin, jossa pyydetään sallimaan ponnahdusikkunat. Poista selaimestasi käytöstä ponnahdusikkunoiden ja seurannan estot, päivitä verkkosivusto ja yritä uudelleen. Jos se ei auta, kokeile toista selainta.
Numeron vahvistus epäonnistui.
- Varmista, että numero voi vastaanottaa tekstiviestejä tai äänipuheluita eikä sitä estä aktiivinen rekisteröintipolku, jota Meta ei salli rinnakkaiskäyttöön. Jos numero on käytössä Business Appissa, kokeile käyttöönottoa Coexistence-toiminnon kautta.
Meta sanoo, että määritykseni ei ole valmis, tai paneelissa näkyy varoitus.
- Lue ensin Connected-kohdan alla oleva kortti: siinä nimetään numero, johon AI Agentisi vastaa, ja kerrotaan, tarkistaako Meta vielä sen näyttönimeä, onko se Meta-testinumero vai eikö ensimmäinen viesti ole vielä saapunut. Jokainen kortti linkittää oikeaan paikkaan WhatsApp Managerissa.
- Jos varoitus koskee itse yhteyttä, klikkaa paneelissa Reconnect WhatsApp. Tämä ratkaisee useimmat tapaukset.
- Jos se ei auta, numerosi voi olla yhdistetty toiseen palveluntarjoajaan (Meta sallii vain yhden kumppanin WhatsApp-tiliä kohti kerrallaan). Lisää Quickchat AI kumppaniksi Meta Business -asetuksissa näytön ohjeiden mukaisesti ja klikkaa sitten Refresh Status.
Yhdistin väärän tilin.
- Reconnect säilyttää tilin, joka on jo yhdistetty. Vaihda tili klikkaamalla WhatsApp-paneelissa Disconnect, sitten uudelleen Connect WhatsApp ja valitsemalla oikea Meta Business -tili ja WhatsApp Account Metan ikkunassa.
Viestit eivät näy Quickchat AI Inboxissa.
- Vahvista, että ponnahdusikkuna näytti lopullisen vahvistuksen siitä, että WhatsApp-tilisi yhdistettiin.
- Tarkista vielä, että linkitit aiotun WhatsApp Accountin ja että oikea AI Agent on valittuna.
- Waiting for your first message -kortti nimeää numeron, johon AI Agentisi vastaa. Varmista, että lähetit viestin juuri tähän numeroon ja että se on kytketty päälle paneelissa, ja klikkaa sitten Refresh.
- Jos lähetät viestejä 24 tunnin jälkeen ilman käyttäjän viestiä, käytä hyväksyttyjä viestipohjia ja varmista, että WhatsApp Managerissa on määritetty maksutapa.
AI:n WhatsApp-vastaukseni eivät lähde.
- Quickchat AI näyttää WhatsApp-paneelissa “WhatsApp replies are failing” -hälytyksen ja ilmoituksen dashboardissa. Yleiset korjaukset: viimeistele näyttönimen hyväksyntä WhatsApp Managerissa; jos yhteys vanheni tai peruutettiin, klikkaa Reconnect; jos Meta rajoitti numeroasi laadun tai käytännön vuoksi, tarkista sen tila WhatsApp Managerissa. Hälytys poistuu, kun vastaus lähetetään jälleen onnistuneesti.
Mallipohja- tai yrityksen aloittamat viestit epäonnistuvat.
- Varmista, että Message Templates ovat hyväksyttyjä ja maksutapasi on aktiivinen WhatsApp Managerissa.
- Uudet lähettäjät aloittavat viestirajoilla, jotka skaalautuvat laadun ja vahvistuksen perusteella. Jos saavutat yrityksen aloittamien viestien rajat, tutustu Metan Messaging Limits -ohjeisiin.
- Tarkista viestirajat ja laatuluokitus WhatsApp Managerissa, jos toimitusta rajoitetaan.
Miten luon oman WhatsApp-linkin ja “Chat on WhatsApp” -painikkeen?
- Seuraa tätä WhatsApp-ohjetta.
Miten luon oman WhatsApp QR -koodin?
- Siirry WhatsApp Manageriin → Phone numbers → valitse yrityksen puhelinnumerosi → Message links → Create Message Link.
- Vaihtoehtoisesti löydät sen WhatsApp Business -mobiilisovelluksestasi. Seuraa tätä WhatsApp-ohjetta.
Tarvitsetko apua?
Keskustele Quickchatin Support AI:n kanssa WhatsAppissa:
📱 +1 302-405-9992: Aloita keskustelu
Tai skannaa QR-koodi:
