Helpparibotti Kirjaudu sisään

Käyttöohjeet

Tässä oppaassa kerrotaan, miten luot botin, rakennat tietopohjan ja otat botin käyttöön — verkkosivun widgetinä, sähköpostitse, Telegramissa, Slackissa tai oman järjestelmäsi REST API:n kautta.

1. Aloitus

Kirjaudu palveluun osoitteessa helpparibotti.fi ja luo ensimmäinen botti "Luo uusi botti" -painikkeella.

Pikaopas — kolme vaihetta käyttöönottoon
1 Luo botti
2 Lisää tietopohja
3 Asenna widget

2. Botin luominen

Paina "Luo uusi botti" -painiketta ja täytä asetukset. Alla on selitys jokaisesta kentästä.

Nimi
Näkyy widgetin ylätunnisteessa asiakkaille. Käytä esimerkiksi yrityksesi nimeä tai "Asiakaspalvelu".
Tervehdysviesti
Ensimmäinen viesti, joka näytetään automaattisesti kun asiakas avaa chatin. Esimerkki: "Hei! Miten voin auttaa sinua tänään?"
System prompt
Botin persoonallisuus ja rajoitukset. Kirjoita tähän ohjeet siitä, miten botti käyttäytyy — esimerkiksi "Olet Yritys Oy:n asiakaspalvelubotti. Vastaa vain yrityksen tuotteisiin liittyviin kysymyksiin."
Widget-väri
Widgetin brändiväri. Valitse valmiista väreistä tai syötä oma hex-arvo.
Sallitut verkkotunnukset
Turvaominaisuus: botti vastaa vain näiltä verkkotunnuksilta tuleviin pyyntöihin. Jätä tyhjäksi kehitysvaiheessa — lisää ennen tuotantoon siirtymistä (esim. yritys.fi, www.yritys.fi).
Malli
Haiku — nopea ja edullinen. Sonnet — laadukkaampi, suositellaan monimutkaiseen tietoon.
Sähköpostiosoite
Tarvitaan sähköpostikanavaa varten. Ks. osio 5.

3. Tietopohja

Tietopohja on kokoelma artikkeleita, joista botti hakee vastauksia. Mitä kattavampi tietopohja, sitä tarkempia vastaukset. Lisää sisältöä kolmella eri tavalla:

Manuaalinen artikkeli

Lisää artikkeli antamalla sille otsikko ja kirjoittamalla tai liittämällä sisältö suoraan. Sopii parhaiten FAQ-osioille, toimitusehdoille ja hinnastoille.

URL-tuonti

Kirjoita verkkosivun URL — järjestelmä hakee sivun tekstisisällön automaattisesti. Nopea tapa lisätä yksittäinen sivu tietopohjaan.

Sivustocrawlaus

Anna verkkosivustosi juuriURL (esim. https://yritys.fi) — järjestelmä käy automaattisesti läpi enintään 50 sivua ja tallentaa niiden sisällön tietopohjaan. Crawlaus tapahtuu taustalla; edistyminen näkyy sivun yläpalkissa.

Artikkelin voi laittaa tilapäisesti pois käytöstä Julkaistu/Pois-vaihtokytkimellä ilman että se poistetaan tietopohjasta.

4. Widget-asennus

Widget on pieni JavaScript-tiedosto, joka lisää chat-painikkeen sivustollesi. Asennus vie alle minuutin.

  1. Kopioi koodi

    Siirry botin "Widget-koodi"-välilehdelle ja kopioi annettu script-tagi.

  2. Liitä koodi sivustollesi

    Lisää koodi jokaisen sivun HTML:ään juuri ennen sulkevaa </body>-tagia.

Esimerkki — lisää ennen </body>
<script src="https://helpparibotti.fi/widget.js" data-bot-id="SINUN-BOT-ID" defer ></script>
Muista lisätä tuotantotunnukset Sallitut verkkotunnukset -kenttään ennen julkaisua, esimerkiksi yritys.fi, www.yritys.fi.

5. Sähköpostikanava

Botti voi vastata automaattisesti saapuviin sähköposteihin samassa viestiketjussa.

  1. Aseta sähköpostiosoite

    Syötä botin sähköpostiosoite Asetukset-välilehdellä olevaan kenttään.

  2. Ohjaa saapuvat viestit webhookille

    Konfiguroi Euromail tai vastaava sähköpostipalvelu lähettämään saapuvat viestit seuraavaan osoitteeseen:

Webhook-osoite
POST https://helpparibotti.fi/api/webhook/inbound-email

Botti vastaa sähköpostikeskusteluihin automaattisesti ja pitää vastaukset samassa viestiketjussa.

6. Telegram-integraatio

Yhdistä botti Telegram-kanavaan tai -ryhmään neljässä vaiheessa.

  1. Luo Telegram-botti BotFatherilla

    Avaa Telegram ja kirjoita @BotFather-botille komento /newbot. Saat Bot Token -tunnisteen.

  2. Syötä Bot Token Integraatiot-välilehdelle

    Avaa botin Integraatiot-välilehti hallintapaneelissa ja liitä saamasi Bot Token kenttään.

  3. Luo Webhook Secret

    Luo vähintään 8 merkin mittainen salainen avain (esim. satunnainen merkkijono). Tallenna se Integraatiot-välilehdelle.

  4. Rekisteröi webhook Telegramille

    Aja seuraava komento komentorivillä — korvaa arvot omillasi:

Webhook-rekisteröinti (komentorivi)
curl "https://api.telegram.org/bot<TOKEN>/setWebhook?url=<WEBHOOK-URL>&secret_token=<SECRET>"
Webhook-URL:n näet Integraatiot-välilehdellä, kun olet tallentanut Telegram-integraation.

7. Slack-integraatio

Botti vastaa Slack-työtilan viesteihin. Vastaus tulee samaan viestiketjuun (thread), joten kanava pysyy siistinä. Botti vastaa sekä suoriin viesteihin (DM) että viesteihin, joissa se mainitaan @botti.

  1. Luo Slack-sovellus

    Mene osoitteeseen api.slack.com/apps ja paina "Create New App" → "From scratch". Valitse työtila.

  2. Lisää oikeudet (scopes)

    Kohdassa "OAuth & Permissions" → "Bot Token Scopes" lisää chat:write ja app_mentions:read. Lisää im:history suoria viestejä ja channels:history kanavaviestejä varten.

  3. Asenna sovellus ja kopioi tokenit

    Paina "Install to Workspace". Kopioi Bot User OAuth Token (alkaa xoxb-) ja Signing Secret (kohdasta "Basic Information").

  4. Tallenna tokenit Integraatiot-välilehdelle

    Avaa botin Integraatiot-välilehti, liitä Bot User OAuth Token ja Signing Secret Slack-osioon ja paina "Ota käyttöön". Kopioi näkyviin tuleva Request URL.

  5. Aseta Request URL ja tilaa tapahtumat

    Slackissa kohdassa "Event Subscriptions" laita "Enable Events" päälle ja liitä Request URL. Tilaa botin tapahtumat (Subscribe to bot events): message.im ja app_mention. Tallenna.

Request URL (Event Subscriptions)
https://helpparibotti.fi/api/webhook/slack/<BOTIN-SLUG>
Tallenna integraatio Integraatiot-välilehdellä ennen Request URL:n asettamista Slackiin — Slack vahvistaa osoitteen heti, ja vahvistus onnistuu vain jos Signing Secret on jo tallennettu.

8. REST API

REST API sopii omiin integraatioihin sekä Zapier- ja n8n-työnkulkuihin. API-avain tarvitaan kaikissa pyynöissä.

  1. Luo API-avain

    Siirry botin Integraatiot-välilehdelle ja paina "Luo API-avain". Avain näytetään vain kerran — tallenna se heti.

  2. Lähetä viesti API:n kautta

    Käytä alla olevaa esimerkkiä ensimmäisen viestin lähettämiseen.

Esimerkki — viestin lähetys
curl -X POST https://helpparibotti.fi/api/v1/chat \ -H "Authorization: Bearer <API-AVAIN>" \ -H "Content-Type: application/json" \ -d '{"message": "Mitä tuotteitanne on saatavilla?"}'
Vastauksen muoto
{ "answer": "Meillä on seuraavat tuotteet...", "conversation_id": "uuid" }
Jatkoviestit samaan keskusteluun: lisää "conversation_id" seuraaviin pyyntöihin.

9. Tilastot ja palautteet

Seuraa botin toimintaa Yleiskatsaus- ja Training-välilehdiltä.

Yleiskatsaus-välilehti

Näyttää reaaliajassa: viestit tänään, viikon keskustelut, kaikki keskustelut sekä asiakastyytyväisyysprosentin.

Asiakaspalaute

Jokaisen bottivastaukseen käyttäjä voi antaa peukku ylös tai peukku alas -palautteen. Palautteet kertyvät tilastoihin ja näkyvät tyytyväisyysprosenttina.

Training-välilehti

Palautteiden pohjalta järjestelmä ehdottaa kysymys-vastauspareja, jotka voit hyväksyä suoraan tietopohjaan tai hylätä. Hyväksytyt parit parantavat botin vastaustarkkuutta.

10. Usein kysytyt kysymykset

Kuinka monta bottia voin luoda?
Ei rajoitusta — voit luoda niin monta bottia kuin tarvitset.
Missä data sijaitsee?
Kaikki tiedot tallennetaan Cloudflaren EU-datakeskuksiin. Viestit lähetetään Anthropicin rajapintaan AI-vastausten generoimiseen.
Voiko botti vastata väärin?
Kyllä, kuten kaikki tekoälyt. Rakenna tietopohja huolellisesti ja testaa botti perusteellisesti ennen julkaisua.
Miten saan botin vastaamaan vain yritykseeni liittyviin kysymyksiin?
Lisää system promptiin selkeä ohje, esimerkiksi: "Vastaa vain tuotteisiimme liittyviin kysymyksiin. Jos kysymys ei liity toimintaamme, kerro kohteliaasti ettet voi auttaa siinä."
Onko viestimäärille rajaa?
Widgettiin on sisäänrakennettu roskapostisuoja: enintään 20 viestiä tunnissa per käyttäjä ja 100 viestiä tunnissa per IP-osoite.
Mihin kanaviin botin voi liittää?
Sama botti ja sama tietopohja toimii kaikilla kanavilla: verkkosivun widget, sähköposti, Telegram, Slack ja REST API. Otat käyttöön vain ne kanavat, joita tarvitset — ohjeet osioista 4–8.
Voiko sama botti palvella montaa kanavaa yhtä aikaa?
Kyllä. Jokainen keskustelu kirjautuu omalle kanavalleen, mutta botti käyttää kaikissa samaa tietopohjaa ja system promptia. Keskustelut näkyvät hallintapaneelin Keskustelut-välilehdellä kanavan mukaan eriteltyinä.