Rekisteröityminen

Luo tili Tekojärjen rekisteröitymissivulla osoitteessa voice.tekojarki.com/admin. Tarvitset nimen, sähköpostiosoitteen, salasanan ja tilauspaketin valinnan.

Sähköpostin vahvistus

Rekisteröitymisen jälkeen saat sähköpostiisi vahvistuslinkin. Tili aktivoituu vasta kun linkki on avattu. Jos viestiä ei näy, tarkista roskapostikansio.

Voit pyytää uuden vahvistuslinkin kirjautumissivulta kohdasta Lähetä vahvistusviesti uudelleen.

Maksuton paketti

Ilmainen Kokeile-paketti ei vaadi luottokorttia. Se antaa pääsyn chat-kanavalle yhden agentin kanssa. Voit päivittää paketin koska tahansa admin-paneelista.

Admin-paneelin yleiskatsaus

Admin-paneeli löytyy osoitteesta voice.tekojarki.com/admin. Vasemmassa sivupalkissa on päänavigaatio.

Sivupalkin osiot

• Dashboard — puhelutilastot, pikavastauswidget, SMS-pikasend
• Agentit — agenttien luonti, muokkaus ja poisto
• Puhelinnumerot — numerot agenteille, alustan numeropankki
• Kontaktit — yhteystietolista, CSV-tuonti, tagit
• Kampanjat — massasoitto- ja SMS-kampanjat
• Ajastetut tehtävät — kertaluontoiset automatisointitehtävät
• Integraatiot — Google Workspace, hakutyökalut, MCP
• Puheluhistoria — kaikki puhelut, chätit ja SMS-sessiot
• Tilaus & laskutus — paketti, SMS-krediitit, laskutustiedot
• Käyttäjät — näkyy vain admin-roolin käyttäjille

Ensimmäisen agentin luominen

1. Avaa Agentit-sivu ja paina Uusi agentti.
2. Anna agentille nimi (esim. "Asiakaspalvelu" tai "Ajanvaraus").
3. Kirjoita System prompt — kuvaa agentin rooli, yrityksen nimi, käyttäytymissäännöt ja mitä agentti saa tai ei saa tehdä.
4. Valitse ääni ja kieli puhekanavaa varten.
5. Tallenna agentti.

System promptin kirjoittaminen

Hyvä system prompt sisältää vähintään:

• Yrityksen nimi ja toimiala
• Agentin tehtävä (esim. "otat ajanvarauksia", "vastaat tuotetiedusteluihin")
• Mitä ei saa sanoa tai tehdä
• Mihin ohjata asiakas jos agentti ei osaa auttaa

Ohjeet ja kanavakohtaiset promptit

Agentilla on yksi pääohje (System prompt) sekä valinnaiset kanavakohtaiset ohjeet chat- ja SMS-kanaville.

Tärkeysjärjestys

SMS käyttää ensisijaisesti SMS-ohjetta. Jos sitä ei ole asetettu, se käyttää chat-ohjetta. Jos chat-ohjettakaan ei ole, se käyttää yleistä system promptia. Sama logiikka pätee chat-kanavaan.

Kanavakohtaiset vinkit

Puhelin

• Ohjeista agentti puhumaan luontevasti ja pitämään vastaukset lyhyinä
• Muistuta vahvistamaan sähköpostiosoitteet ääneen
• Vältä listoja — puheessa ne kuulostavat oudoilta

Chat

• Markdown-muotoilu (lihavointi, listat) toimii chat-widgetissä
• Voit ohjeistaa agentin käyttämään hymiöitä brändin mukaisesti

SMS

• Ohjeista agentti pitämään vastaukset alle 160 merkissä
• Yksi asia per viesti, ei pitkiä listoja
• Markdown ei toimi SMS:ssä

Agentin työkalut

Työkalut antavat agentille mahdollisuuden tehdä toimintoja — varata kalenterista, lähettää SMS:n, hakea tietoa verkosta ja paljon muuta. Työkalut otetaan käyttöön agentin asetuksissa Työkalut-välilehdellä.

Saatavilla olevat työkalut

• end_call — lopettaa puhelun ohjelmoituun tilanteeseen (esim. kun asiakas on hyvästellyt)
• transfer_call — siirtää puhelun toiselle numerolle
• send_sms — lähettää SMS-viestin asiakkaalle puhelun aikana
• google_calendar — lukee ja luo kalenteritapahtumia (vaatii Google-integraation)
• google_gmail — lähettää sähköpostia (vaatii Google-integraation)
• google_sheets / google_docs — lukee ja kirjoittaa Google-dokumentteihin
• web_search — hakee tietoa verkosta reaaliajassa (vaatii hakuintegraation)
• memory — tallentaa ja hakee agentin muistiin tietoa soittajasta
• knowledge_search — hakee tietoa tietopankista (vaatii Business-paketin ja tietopankin)

Käyttöönotto

Avaa agentin muokkausnäkymä → Työkalut-välilehti → aktivoi halutut työkalut. Integraatioita vaativat työkalut toimivat vasta kun integraatio on myös kytketty agentille.

Tietopankki (RAG)

Tietopankki mahdollistaa agenteille dokumenttipohjaisen tiedonhaun. Agentti osaa etsiä vastauksia omista dokumenteistasi automaattisesti ennen kuin vastaa asiakkaalle.

Tuetut tiedostomuodot

• PDF, Word (.docx), tekstitiedostot (.txt)
• CSV-taulukot
• Verkkosivut URL-osoitteen kautta

Käyttöönotto

1. Avaa agentin asetukset → Tietopankki-välilehti.
2. Lisää lähde: lataa tiedosto tai anna URL.
3. Odota indeksoinnin valmistumista (kestää muutamia sekunteja–minuutteja tiedoston koosta riippuen).
4. Varmista, että knowledge_search-työkalu on aktivoitu agentin Työkalut-välilehdellä.

Agentti hakee tietopankista automaattisesti silloin, kun asiakkaan kysymys näyttää vaativan taustatietoa.

IVR-reititys

IVR (Interactive Voice Response) mahdollistaa puhelujen ohjaamisen eri agenteille soittajan painaman näppäimen perusteella. Esimerkiksi: "Paina 1 ajanvaraukseen, paina 2 asiakaspalveluun."

Käyttöönotto

1. Luo jokaiselle valikkovaihtoehdolle oma agentti (esim. "Ajanvaraus-agentti", "Asiakaspalvelu-agentti").
2. Avaa jokaisen agentin asetukset → aseta IVR-avain (numero 1–9) ja IVR-etiketti (teksti joka luetaan ääneen).
3. Kytke puhelinnumero sille agentille, jonka haluat toimivan päävalikkona tai ensimmäisenä vastaajana — tämä agentti lukee valinnat ääneen.

Saapuvat puhelut

Saapuvat puhelut ohjataan automaattisesti agentille puhelinnumeron asetusten mukaan.

Puhelinnumeron kytkeminen agenttiin

1. Avaa Puhelinnumerot-sivu.
2. Valitse numero tai hanki uusi alustan numeropankista.
3. Valitse numero-riviltä, mille agentille puhelut ohjataan.
4. Sama numero voi käyttää eri agenttia SMS-viesteille — valittavissa samassa näkymässä.

Puheluominaisuudet

• Reaaliaikainen transkriptio
• Agentin työkalukutsut kirjataan puhelulokin yhteyteen
• IVR-reititys useammalle agentille (ks. IVR-reititys)

Lähtevät puhelut

Tekojärki voi soittaa asiakkaille kolmella tavalla: manuaalisesti dashboardista, automaattisesti kampanjalla tai API-kutsulla.

Pikäsoitto dashboardista

Avaa Dashboard → Soita-widget. Syötä puhelinnumero ja valitse agentti. Puhelu yhdistetään välittömästi.

Kampanjalla

Kampanjat mahdollistavat satojen kontaktien soittamisen automaattisesti. Ks. Kampanjoiden luominen.

API-kutsulla

Lähtevän puhelun voi käynnistää myös REST API:lla:

• Endpoint: POST /api/v1/call
• Header: X-API-Key: tk_...
• Body: {"to": "+358401234567", "agent_id": "..."}

API-avain löytyy admin-paneelista kohdasta Asetukset → API-avain.

Web chat -widget

Chat-widget on upotettava chat-ikkuna, jonka voit lisätä omalle verkkosivustollesi yhdellä koodirivillä.

Upottaminen

Lisää seuraava koodi verkkosivusi <body>-tagin loppuun:

<script src="https://voice.tekojarki.com/chat/widget.js"
  data-agent-id="AGENTIN-ID"></script>

Korvaa AGENTIN-ID oikealla agentin tunnuksella. Agentin ID löytyy admin-paneelin agentit-sivulta.

Widgetin asetukset

Chat-widgetin ulkoasua ja käyttäytymistä voi muokata agentin asetuksissa Chat-välilehdellä:

• Teemaväri
• Tervetuloviesti
• Widgetin sijainti (oikea/vasen alakulma)
• Agentin näytettävä nimi

Testaaminen

Voit testata chat-widgetiä suoraan admin-paneelissa agentin asetussivulta tai avaamalla chat-URL:n selaimessa lisäämällä ?debug=true parametrin.

SMS-kanava

SMS-kanava mahdollistaa sekä saapuvien tekstiviestien vastaanottamisen että lähtevien SMS-viestien lähettämisen agentin kautta.

Saapuvat SMS-viestit

Saapuvat tekstiviestit vastaanottaa se agentti, joka on kytketty puhelinnumeron SMS-agentiksi Puhelinnumerot-sivulla. Agentti voi olla eri kuin puhekanavin agentti.

Jokainen asiakaskeskustelu on oma istuntonsa, joka säilyy aktiivisena 24 tuntia viimeisestä viestistä. Tämän jälkeen seuraava viesti aloittaa uuden istunnon.

Lähtevät SMS-viestit

Agentti voi lähettää SMS:n puhelun tai chat-session aikana, jos send_sms-työkalu on käytössä. Lähtevän SMS:n voi lähettää myös manuaalisesti dashboardin SMS-widgetistä tai API:lla (POST /api/v1/sms).

SMS-krediitit

Ks. SMS-krediitit.

Puheluhistoria ja transkriptio

Puheluhistoria-sivulla näet kaikki palvelun kautta tapahtuneet asiakaskohtaamiset — puhelut, chat-sessiot ja SMS-sessiot.

Suodattimet

• Kanava: puhelin, web chat, SMS
• Suunta: saapuva, lähtevä
• Status: completed, failed, in-progress

Puhelun tiedot

Klikkaamalla puhelua näet:

• Alkamis- ja päättymisaika, kesto
• Soittajan numero
• Agentti ja kanava
• Koko transkriptio tekstimuodossa
• Agentin käyttämät työkalut ja niiden tulokset

Google Workspace -integraatio

Google Workspace -integraation avulla agentti voi lukea ja kirjoittaa kalenteriin, lähettää sähköpostia, sekä käyttää Google Sheets- ja Docs-dokumentteja.

Yhdistäminen

1. Avaa Integraatiot-sivu.
2. Paina Lisää Google Workspace ja kirjaudu Google-tilillesi.
3. Hyväksy tarvittavat oikeudet.

Integraatio on käyttäjäkohtainen. Jokainen käyttäjä yhdistää oman Google-tilinsä erikseen.

Kytkeminen agentille

Integraation lisäämisen jälkeen se pitää kytkeä agentille:

1. Avaa agentin asetukset → Integraatiot-välilehti.
2. Valitse lisätty Google-integraatio.
3. Aktivoi haluamasi Google-työkalut Työkalut-välilehdeltä.

Verkkohaku

Verkkohaku-integraatio antaa agentille mahdollisuuden etsiä tietoa internetistä reaaliajassa. Tämä on hyödyllinen esimerkiksi hintavertailuihin, uutisiin tai tietoihin joita ei löydy tietopankista.

Käyttöönotto

1. Avaa Integraatiot-sivu → lisää hakutyökalu (DuckDuckGo, Tavily tai Brave Search).
2. Kytke integraatio halutulle agentille.
3. Aktivoi web_search-työkalu agentin Työkalut-välilehdellä.

DuckDuckGo ei vaadi API-avainta. Tavily ja Brave tarjoavat tarkemmat tulokset mutta vaativat oman API-avaimen.

API-avaimet

API-avaimen avulla voit käynnistää puheluita ja lähettää SMS-viestejä omista järjestelmistäsi ilman kirjautumista.

Avaimen luominen

1. Avaa admin-paneeli → Asetukset → API-avain.
2. Paina Luo uusi avain. Avain alkaa etuliitteellä tk_.
3. Kopioi avain talteen — se näytetään vain kerran.

Käyttö

Lisää avain jokaiseen API-kutsuun headeriin:

X-API-Key: tk_xxxxxxxxxxxxxxxx

Saatavilla olevat endpointit

• POST /api/v1/call — käynnistä lähtevä puhelu
• POST /api/v1/sms — lähetä SMS-viesti

Kampanjoiden luominen

Kampanjoilla voit soittaa tai lähettää SMS-viestejä automaattisesti suurelle joukolle kontakteja. Kampanja luodaan nelivaiheisella wizardilla.

Vaihe 1: Perustiedot

Anna kampanjalle nimi ja valitse tyyppi: puhelu tai SMS.

Vaihe 2: Agentti ja numero

Valitse agentti, joka hoitaa puhelut tai SMS-viestit, sekä lähtevä puhelinnumero.

Vaihe 3: Kontaktit

Valitse vastaanottajat kontaktilistalta. Voit suodattaa tagien perusteella.

Vaihe 4: Ajastus ja rajoitukset

• Ajastus: milloin kampanja käynnistetään
• Soittoikkuna: mihin kellonaikoihin soitetaan (esim. 09:00–17:00)
• Nopeusrajoitus: kuinka monta puhelua per minuutti
• Samanaikaiset puhelut: rinnakkain käynnissä olevien puhelujen maksimimäärä

Kontaktit ja CSV-tuonti

Kontaktilista on kampanjoiden perusta. Kontakteja voi lisätä yksitellen tai tuoda CSV-tiedostosta.

CSV-tuonti

CSV-tiedostossa pitää olla vähintään phone-sarake. Tuetut sarakkeet:

• phone — puhelinnumero, pakollinen (kansainvälinen muoto, esim. +358401234567)
• name — nimi
• email — sähköposti
• tags — tagit pilkulla erotettuna (esim. asiakas,helsinki)

Avaa Kontaktit-sivu → Tuo CSV → valitse tiedosto → vahvista tuonti.

Tagit

Tagien avulla voit kohdistaa kampanjat vain tiettyihin kontaktiryhmiin. Tageja voi lisätä ja muokata yksittäisille kontakteille tai CSV-tuonnin yhteydessä.

Ajastetut tehtävät ja triggerit

Ajastetut tehtävät

Ajastettu tehtävä on kertaluontoinen toiminto, jonka haluat agentin suorittavan tiettynä hetkenä. Esimerkiksi: "Soita asiakkaalle huomenna klo 10 ja muistuta huollosta."

Tehtävä luodaan Ajastetut tehtävät -sivulla. Täytä tehtäväkuvaus, valitse agentti, aseta ajankohta ja tallenna.

Triggerit

Triggerit mahdollistavat automaation ilman manuaalista käynnistystä. Agentti seuraa lähteitä (sähköposti, kalenteri) ja käynnistää toiminnon automaattisesti kun ehto täyttyy.

Triggerityypit

• Sähköposti-triggeri — reagoi saapuvaan sähköpostiin (vaatii Gmail-integraation)
• Kalenteri-triggeri — reagoi kalenteritapahtumaan (vaatii Google Calendar -integraation)
• Webhook-triggeri — reagoi ulkoiseen HTTP-kutsuun

Evaluointitavat

• Säännöt — tarkistaa avainsanoja tai ehtoja suoraan
• LLM — tekoäly arvioi, täyttääkö tapahtuma ehdon
• Molemmat — säännöt ensin, epäselvät tapaukset LLM:lle

Tilaukset ja paketit

Tekojärjen paketit ovat Kokeile (0 €/kk), Starter (29 €/kk), Pro (99 €/kk) ja Business (249 €/kk). Kaikki hinnat alv 0 %.

Pakettien vertailu

• Kokeile — 1 agentti, vain chat, 10 viestiä/kk
• Starter — chat + puhelin, 1 numero, 30 min/kk
• Pro — kaikki kanavat, 3 agenttia, 200 min/kk, 50 SMS/kk, integraatiot
• Business — kaikki ominaisuudet, rajaton chat, 500 min/kk, 200 SMS/kk, tietopankki

Täydellinen vertailu löytyy hinnoittelusivulta.

Paketin muuttaminen

Avaa Tilaus & laskutus -sivu ja valitse uusi paketti. Stripe käsittelee muutoksen ja laskuttaa eron välittömästi tai hyvittää seuraavalle laskulle.

Peruuttaminen

Tilauksen voi peruuttaa koska tahansa. Palvelu jatkuu laskutuskauden loppuun saakka. Ei sidosaikaa.

SMS-krediitit

Pro-paketti sisältää 50 SMS/kk ja Business 200 SMS/kk. Lisä-SMS:iä voi ostaa prepaid-paketteina.

Prepaid-paketit

• 50 SMS — 5 €
• 200 SMS — 18 €
• 500 SMS — 40 €

Osta krediittejä: Tilaus & laskutus → SMS-krediitit → valitse paketti → Stripe checkout.

Kulutusjärjestys

1. Ensin kulutetaan pakettiin sisältyvät SMS:t (kuukausittain nollautuvat)
2. Sen jälkeen prepaid-saldo
3. Jos molemmat on käytetty, lähetys estetään

Saldon tarkistaminen

Nykyinen saldo ja kulutusloki näkyvät Tilaus & laskutus -sivun SMS-krediitit-osiossa.

Tietoturva ja tietosuoja

Data Suomessa

Kaikki asiakasdata — puhelutranskriptiot, kontaktit, agenttiasetukset ja käyttäjätiedot — tallennetaan Suomessa sijaitsevalle palvelimelle. Data ei siirry EU:n ulkopuolelle.

Salaus

• Kaikki liikenne salataan TLS-yhteydellä
• Integraatioiden arkaluonteiset tiedot (API-avaimet, OAuth-tokenit) salataan Fernet-salauksella tietokantaan
• Käyttäjien salasanat ja API-avaimet tallennetaan bcrypt-tiivisteinä

Autentikointi

• Kirjautuminen käyttää JWT-tokenia (voimassa 24 h)
• Ulkoinen API-integraatio käyttää tk_-etuliitteistä API-avainta
• Uuden laitteen kirjautuminen vaatii sähköpostin vahvistuksen

GDPR

Tekojärki noudattaa EU:n yleistä tietosuoja-asetusta (GDPR). Tietosuojaseloste löytyy osoitteesta www.tekojarki.com/tietosuoja.

Asiakastiedot voidaan poistaa pyynnöstä. Ota yhteyttä: [email protected].

Usein kysyttyä

Kuinka nopeasti agentti vastaa puheluun?

Yleensä alle sekunnissa. Viive riippuu verkkoyhteydestä ja OpenAI:n vasteajasta. Puheagentti käyttää suoratoistotekniikkaa, joten vasteaika on tyypillisesti 0,5–1,5 sekuntia.

Voiko agentti muistaa soittajan tietoja seuraavaan puheluun?

Kyllä, jos memory-työkalu on kytketty agentille. Muistit tallentuvat agentti- ja soittajakohtaisesti ja ovat käytettävissä myöhemmissä puheluissa.

Mistä saan suomalaisen puhelinnumeron?

Puhelinnumerot löytyvät Puhelinnumerot-sivulta. Voit hankkia numeron alustan numeropankista tai ostaa uuden. Numerot ovat suomalaisia (+358) Twilio-numeroita.

Toimiiko agentti muilla kielillä?

Kyllä. Agentin voi asettaa toimimaan millä tahansa kielellä muuttamalla language-asetus ja kirjoittamalla system promptin haluamallaan kielellä. Yleisimmät eurooppalaiset kielet toimivat hyvin.

Mitä tapahtuu jos puhelussa yhteys katkeaa?

Tekojärki kirjaa puhelun failed-tilaan ja tallentaa kaiken siihenastisen transkription puheluhistoriaan.

Voinko käyttää useita Google-tilejä?

Jokainen käyttäjä voi yhdistää yhden Google-tilin. Jos tarvitset useampia tilejä, luo useampi Tekojärki-käyttäjä ja kytke heille eri integraatiot.

Mistä saan apua?

Lähetä sähköpostia: [email protected]