---
title: "Johdanto"
description: "Dokumentaatio tuotantokäytön puheagenttien ajamiseen oikeissa puheluissa ja upotettavissa verkkowidgeteissä: pika-aloitukset, oppaat ja täydellinen ThunderPhone API -viite."
---

ThunderPhoneilla voit rakentaa AI-puheagentteja, jotka soittavat ja vastaanottavat
oikeita puheluita sekä mahdollistavat mikrofonipohjaisia keskusteluja verkkosivustollasi.
Dokumentaatio on jaettu neljään välilehteen:

<CardGroup cols={2}>
  <Card title="Oppaat" icon="book" href="/fi/quickstart-dashboard">
    Pika-aloitukset, käsitteet ja ohjeet hallintapaneelia ja APIa varten.
    **Aloita tästä**, jos olet uusi käyttäjä.
  </Card>
  <Card title="API-viite" icon="code" href="/api-reference/introduction">
    Jokainen päätepiste, pyyntökenttä ja vastausrakenne.
  </Card>
  <Card title="Widget" icon="window-maximize" href="/fi/widget/overview">
    Upotettava verkkowidget — React-komponentti, headless-hook ja
    CDN-skriptitagi.
  </Card>
  <Card title="Webhookit" icon="bolt" href="/fi/webhooks/overview">
    Reaaliaikaiset tapahtumat, allekirjoitus ja toimitussemantiikka.
  </Card>
</CardGroup>

## Mitä voit rakentaa

<CardGroup cols={2}>
  <Card title="Saapuvien puheluiden tuki" icon="phone">
    Vastaa omistamaasi numeroon tuleviin puheluihin AI-puheagentilla, joka noudattaa
    kehotettasi, käyttää työkalujasi ja siirtää puhelun ihmiselle tarvittaessa.
  </Card>
  <Card title="Lähtevät kampanjat" icon="arrow-up-right">
    Soita ohjelmallisia puheluita koodistasi — kysely-, seuranta- tai
    vahvistusprosesseja varten.
  </Card>
  <Card title="Puhe selaimessa" icon="microphone">
    Lisää upotettava [verkkowidget](/fi/guides/embed-web-widget) sivustollesi,
    jotta asiakkaat voivat klikata ja puhua. Puhelinnumeroa ei tarvita.
  </Card>
  <Card title="Testiohjatut agentit" icon="flask">
    Suorita ennalta määritettyjä tilanteita agentillasi [erissä](/api-reference/test-calls),
    jotta regressiot havaitaan ennen kuin asiakkaat kuulevat ne.
  </Card>
</CardGroup>

## Kaksi tapaa aloittaa

**Hallintapaneelissa** (suositellaan ensimmäiselle puheagentillesi) — rekisteröidy, niin
hallintapaneeli opastaa sinut viisivaiheisen asennusavustajan läpi: luo
agentti, määritä laskutus, lisää puhelinnumero, suorita simulointi ja tarkista
puhelu. [Hallintapaneelin pika-aloitus](/fi/quickstart-dashboard) vastaa
tätä avustajaa vaihe vaiheelta.

**Päätteestäsi** — [API-pika-aloitus](/fi/quickstart) tekee
saman ensimmäisen puhelun neljällä REST-kutsulla.

<Steps>
  <Step title="Selaa käsitteitä">
    [Käsitteet](/fi/guides/concepts) — kartta jokaisesta objektista, jota käytät,
    ja siitä, missä kukin sijaitsee hallintapaneelissa.
  </Step>
  <Step title="Suorita pika-aloitus">
    [Hallintapaneelin pika-aloitus](/fi/quickstart-dashboard) tai
    [API-pika-aloitus](/fi/quickstart) — tee ensimmäinen puhelusi AI-puheagentilla.
  </Step>
  <Step title="Valitse opas">
    Seuraa tilanteeseesi sopivaa [toimintaohjetta](/fi/guides/build-an-agent)
    tai tutustu
    [API-viitteeseen](/api-reference/introduction).
  </Step>
</Steps>

## Selaa oppaita

<CardGroup cols={2}>
  <Card title="Hallintapaneelin käyttäminen" icon="table-columns" href="/fi/guides/build-an-agent">
    Luo agentti, lisää sille saldoa, hanki numero, simuloi ja tarkista puhelut.
  </Card>
  <Card title="Yhdistä työkalut ja data" icon="plug" href="/fi/guides/connect-apps">
    OAuth-sovellukset, mukautetut APIt, MCP-palvelimet ja VoIP-palveluntarjoajat.
  </Card>
  <Card title="Analysoi ja paranna" icon="chart-line" href="/fi/guides/reports">
    Raportit, havainnoitavuus, kokeilut, ongelmat ja hälytykset.
  </Card>
  <Card title="Tiimi ja tili" icon="users" href="/fi/guides/invite-your-team">
    Kutsut ja roolit, API-avaimet, tietoturva ja SSO.
  </Card>
</CardGroup>

## Perus-URL

```
https://api.thunderphone.com/v1
```

Todennuksessa käytetään tavallista OAuth 2.0 Bearer -mallia
`sk_live_`-organisaation API-avaimella. Avaimesi tunnistaa kohdeorganisaation
automaattisesti — URL-poluissa ei ole organisaatiotunnusta. Lisätietoja on kohdassa
[Todennus](/api-reference/introduction).

<Note>
  Tarvitsetko apua? Lähetä sähköpostia osoitteeseen [support@thunderphone.com](mailto:support@thunderphone.com).
</Note>