# Viber Yhdistä oma **Viber-bottisi**, jotta Viber-keskustelusi virtaavat sovellukseen ja tekoälyagentti voi vastata niihin. Yhdistäminen tapahtuu liittämällä yksi arvo (bottisi todennustunnus), ja me hoidamme loput asetukset puolestasi. --- ## Mikä on Viber-integraatio? Viber-integraatio yhdistää omistamasi **Viber-botin** alustaan käyttämällä Viberin virallista Bot API -rajapintaa, joka on Viberin oma järjestelmä viestien lähettämiseen ja vastaanottamiseen automaattisesti sen sijaan, että kirjoittaisit ne käsin. Botin ja sitä seuraavien ihmisten väliset keskustelut tulevat saataville sovelluksessa, ja tekoälyagentti sekä jaettu postilaatikko toimivat niiden päällä. Tämä on **virallinen** integraatio, joten se on vakaa ja Viberin sääntöjen mukainen. > **Saatavuus.** Viber on laajimmassa käytössä Filippiineillä, Vietnamissa ja muissa osissa Kaakkois-Aasiaa sekä Itä-Euroopassa ja Kreikassa. --- ## Ennen kuin aloitat **Tarvitset oman Viber-botin, ja Viber myöntää botteja vain maksullisissa yrityspaketeissa.** Helmikuusta 2024 alkaen Viber ei enää luo ilmaisia botteja. Määrität tilin suoraan Viberin kanssa, ja kyseinen tili sekä sen maksut pysyvät sinun ja Viberin välisinä. Emme jälleenmyy sitä, lisää siihen katetta tai ota osuutta, emmekä voi luoda bottia puolestasi. Tätä kirjoitettaessa Viber veloittaa kuukausimaksun per botti sekä viestikohtaisen maksun botin aloittamista viesteistä (katso [Kustannukset](#cost) alta). Tarkista Viberin ajantasaiset ehdot rekisteröityessäsi, sillä he voivat muuttaa hinnoitteluaan. Itsepalvelurekisteröitymislomaketta ei ole. Viber tarkistaa jokaisen chatbot-sovelluksen käsin, ja voit hakea yhdellä kahdesta tavasta: - **Vahvistetun Viber-kumppanin kautta**, mikä on Viberin suosittelema ja yleensä nopeampi reitti. - **Suoraan Viberin kautta** lähettämällä sähköpostia osoitteeseen `partners@viber.com`. Jos teet jo yhteistyötä Viberin kanssa, yrityksesi asiakkuusvastaava voi aloittaa prosessin puolestasi. Kun hakemuksesi on hyväksytty, allekirjoitat Viberin sopimuksen ja hyväksyt heidän kaupalliset ehtonsa, minkä jälkeen bottisi luodaan. Tämän jälkeen löydät tunnisteen Viber-sovelluksesta kohdasta **Lisää → Asetukset → Botit → Muokkaa tietoja → Sovellusavaimesi**. Viber kutsuu sitä *sovellusavaimeksi* (app key); heidän API-dokumentaationsa kutsuu samaa arvoa *todennustunnisteeksi* (authentication token), ja bottien ylläpitäjät näkevät sen myös Viberin omassa hallintapaneelissa. Riippumatta siitä, millä nimellä se on merkitty, se on se yksi arvo, jota tämä sovellus pyytää. Tämä tunniste on ainoa asia, jonka tarvitset Viberiltä. Käyttöönotto täällä vie noin minuutin. --- ## Viberin käyttöönotto ### Vaihe 1: Kopioi bottisi todennustunnus Nopein tapa löytää se on käyttää puhelimesi Viber-sovellusta. 1. Avaa Viber puhelimella, jonka tili omistaa botin. 2. Siirry kohtaan **Lisää → Asetukset → Botit**. 3. Valitse bottisi ja napauta **Muokkaa tietoja**. 4. Kopioi kohdassa **Sovellusavaimesi** näkyvä arvo. Se on tunniste. > Pidä tämä tunniste yksityisenä. Kuka tahansa, jolla se on, voi lähettää viestejä bottinasi. ### Vaihe 2: Yhdistä Viber sovelluksessa 1. Napsauta vasemmassa sivupalkissa alareunan lähellä olevaa **Asetukset**-kohtaa. 2. Napsauta Asetusten vasemmassa reunassa kohdan **Kanavat** alla olevaa **Kanavat**-vaihtoehtoa. 3. Etsi **Viber**-kortti ja napsauta **Yhdistä**. 4. Liitä **todennustunnuksesi** (auth token). 5. Napsauta **Yhdistä**. 6. Sovellus tarkistaa tunnuksen Viberin kanssa ja näyttää tekstin **"Yhdistetty: \"**. **Webhookia ei tarvitse määrittää.** Toisin kuin useimpien muiden kanavien kohdalla, rekisteröimme kaiken puolestasi Viberissä osana yhdistämisprosessia, joten mitään ei tarvitse kopioida toiseen konsoliin. Yhdistetty-näkymä näyttää osoitteen, johon viestisi saapuvat, vain siksi, että voit jakaa sen tuen kanssa, jos tarvitset apua. ### Vaihe 3: Testaa bottia 1. Avaa Viber toisella puhelimella ja **seuraa bottiasi** (etsi se tai käytä sen linkkiä). 2. **Lähetä sille viesti.** 3. Avaa sovellus ja siirry kohtaan **Keskustelut**. Saapuva viesti näkyy keskusteluluettelossa. 4. Jos tekoälyagentti käsittelee tätä kanavaa, näet sen **vastaavan automaattisesti**. Kun yhteys on muodostettu, Viber-bottisi näkyy **Yhdistetty**-tilassa Kanavat-sivulla ja tekoäly vastaa saapuviin viesteihin. --- ## Kenelle bottisi voi lähettää viestejä Tämä on tärkein asia ymmärtää Viberistä, ja se eroaa kaikista muista kanavista: **Bottisi voi lähettää viestejä vain sitä seuraaville henkilöille.** Jonkun on löydettävä bottisi ja alettava seurata sitä, ennen kuin voit lähettää hänelle mitään. Viber-käyttäjälle, joka ei ole ensin seurannut bottiasi, ei ole mahdollista lähettää viestiä. Jos joku lopettaa bottisi seuraamisen tai estää sen, et voi lähettää hänelle viestejä uudelleen, ennen kuin hän seuraa sitä ja lähettää sinulle viestin. Kun näin tapahtuu, sovellus merkitsee keskustelun niin, että se lakkaa yrittämästä, ja lähettämäsi vastaus näkyy epäonnistuneena selityksen kera sen sijaan, että se katoaisi hiljaisesti. Tämän vuoksi Viber toimii erittäin hyvin **tuki- ja vastauskanavana** (joku lähettää sinulle viestin, tekoäly vastaa) ja huonosti kylmäkontaktointikanavana. --- ## Kustannukset Viber on sovelluksessa **ilmainen** kanava: ei viestikohtaista maksua eikä meidän perimäämme kuukausittaista yhteysmaksua. Kustannukset tulevat **Viberiltä** omalle tilillesi: - **Kuukausimaksu per botti** (noin 100 € tätä kirjoitettaessa). - **Vastaukset jonkun aloittamaan keskusteluun ovat ilmaisia ja rajoittamattomia.** Tämä kattaa lähes kaiken, mitä tekoälyagentti tekee. - **Bottisi aloittamat viestit**, jotka tapahtuvat keskustelun ulkopuolella, laskutetaan viestikohtaisesti vastaanottajan maan mukaan. Käytännön johtopäätös: ihmisille vastaaminen ei maksa sinulle mitään kuukausimaksun lisäksi. Lähetykset ja ennakoivat yhteydenotot ovat niitä, jotka kerryttävät kustannuksia. --- ## Mediatiedostot Saapuvat valokuvat, videot, tiedostot, tarrat, sijainnit ja jaetut yhteystiedot tunnistetaan, jotta tekoäly tietää median tulleen (keskusteluun lisätään lyhyt huomautus). Lähtevät tekoälyvastaukset ovat tässä versiossa **tekstiä ja kuvia**. Pitkät vastaukset lyhennetään automaattisesti Viberin 7 000 merkin rajaan. --- ## Istuntojen hallinta ### Yhteyden tilan tarkistaminen Viber-yhteytesi tila näkyy **Viber**-kortissa **Kanavat**-sivulla: | Tila | Merkitys | |---|---| | **Yhdistetty** | Viber-botti on linkitetty tähän tiliin | | **Yhdistetty, vaatii toimia** | Jokin muu on ottanut bottisi hallintaansa; viestit eivät tavoita meitä | | **Ei yhdistetty** | Yhteyttä ei ole määritetty | Kortti tarkistaa bottisi tilan aina, kun avaat Kanavat-sivun. **Viber-botti voi lähettää viestejä vain yhteen paikkaan kerrallaan**, joten jos yhdistät saman botin toiseen työkaluun, kyseinen työkalu ottaa vallan ja viestisi lakkaavat saapumasta tänne ilman Viberin varoitusta. Tätä **"Yhdistetty, vaatii toimia"** tarkoittaa. Avaa kortti ja yhdistä uudelleen ottaaksesi sen takaisin hallintaasi. ### Yhteyden katkaiseminen Avaa **Viber**-kortti ja napsauta **Hallitse**, napsauta sitten **Katkaise yhteys** ja vahvista **Poistetaanko Viber?**. Tämä estää meitä vastaanottamasta botin viestejä ja poistaa sen tililtäsi. Itse botti pysyy sinun omistuksessasi. Viber-tililläsi ei tapahdu muutoksia. --- ## Rajoitukset - **Vain seuraajat.** Bottisi voi lähettää viestejä vain sitä seuraaville henkilöille. Katso [Kenelle bottisi voi lähettää viestejä](#who-your-bot-can-message). - **Tarvitset oman maksullisen Viber-botin.** Emme voi tarjota sellaista. - **Yksi botti per yhteys.** Yhdistä jokainen botti erikseen; botti voi olla linkitetty vain yhteen tiliin. - **Tekstin ja kuvien lähettäminen.** Tekoäly vastaa tekstillä ja kuvilla; karuselleja ja rich card -kortteja ei lähetetä tässä versiossa. - **Ei tervetuloviestiä.** Kun joku avaa bottisi ensimmäistä kertaa eikä ole vielä seurannut sitä, Viber sallii yhden välittömän tervehdyksen. Tämä versio ei lähetä sellaista. Keskustelu alkaa, kun he lähettävät ensimmäisen viestinsä. --- ## Vianmääritys ### Tunniste hylättiin yhdistettäessä - Varmista, että kopioit arvon Viber-sovelluksen kohdasta **Edit Info → Your app key**, etkä jotain muuta tunnusta. - Tarkista, että bottisi on edelleen aktiivinen Viber-tililläsi. - Yhdistäminen tarkistaa myös, että Viber saa yhteyden meihin. Jos tunniste on varmasti oikein ja se epäonnistuu silti, odota minuutti ja yritä uudelleen, ja ota sitten yhteyttä tukeen. ### "Tämä Viber-botti on jo yhdistetty toiseen tiliin" Sama botti on linkitetty sovelluksessa eri tiliin. Katkaise yhteys siellä ensin tai käytä toista bottia. ### Botti ei vastaa - Varmista, että kortissa lukee **Yhdistetty**, ei **Yhdistetty, vaatii toimia**. - Varmista, että henkilö, jonka kanssa testaat, on **seurannut bottiasi**. Viber toimittaa viestejä vain seuraajilta. - Tarkista, että tekoälyagentti on määritetty tälle kanavalle. ### Viestien saapuminen lakkasi Tämä on lähes aina sama hallinnan kaappausongelma, joka on kuvattu kohdassa [Yhteyden tilan tarkistaminen](#checking-connection-status): sama botti on yhdistetty toiseen työkaluun. Avaa **Viber**-kortti ja yhdistä uudelleen. ### Vastaus epäonnistui virheellä "Not Subscribed" Henkilö on lopettanut botin seuraamisen tai estänyt sen. Et voi lähettää heille viestejä, ennen kuin he seuraavat bottia uudelleen ja lähettävät sinulle viestin ensin. --- ## Parhaat käytännöt - **Keskity tukeen, älä yhteydenottoihin.** Keskustelun sisällä lähetetyt vastaukset ovat ilmaisia ja rajoittamattomia; itse aloittamasi viestit ovat maksullisia ja tavoittavat vain seuraajat. - **Tee botin seuraamisesta helppoa.** Lisää sen linkki sivustollesi, sähköpostiallekirjoitukseesi ja muihin kanaviisi. Seuraaminen on ainoa tapa, jolla ihmiset voivat tavoittaa botin. - **Pidä todennustunnisteesi turvassa.** Kuka tahansa, jolla se on, voi lähettää viestejä bottisi nimissä. Luo se uudelleen Viber-sovelluksessa, jos se vuotaa, ja yhdistä sitten uudelleen täällä. - **Älä yhdistä samaa bottia kahteen työkaluun.** Jälkimmäinen ottaa vallan hiljaisesti.