> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lähteviä kampanjoita

> Lataa yhteystietoluettelo ja anna agentin käsitellä se — soittoikkunoiden, uudelleenyritysten ja reaaliaikaisen edistymisen avulla.

Kampanjat soittavat yhteystietoluettelolle puolestasi: valitse agentti, lataa
CSV-tiedosto, määritä milloin soittaminen on sallittua, ja ThunderPhone käy luettelon läpi
— yrittäen uudelleen vastaamattomia puheluita ja vastaajapuheluita valitsemasi aikataulun mukaisesti. Löydät
ne kohdasta **Sitoutuminen → Kampanjat** (`/dashboard/campaigns`).

Kertaluonteisiin ohjelmallisiin puheluihin käytä sen sijaan
[lähtevien puheluiden APIa](/fi/guides/place-outbound-calls).

## Vaatimukset

* Käyttöönotettu puheagentti.
* Organisaatioosi yhdistetty **VoIP-puhelinnumero**, josta soitetaan —
  demonumerot ovat vain saapuvia puheluita varten, eikä niillä voi soittaa kampanjapuheluita. Katso
  [VoIP-palveluntarjoajan yhdistäminen](/fi/guides/voip-providers).
* Yhteystiedot CSV-tiedostona (tai liitettynä JSONina), jossa on `phone`- tai
  `phone_number`-sarake. **Enintään 5 000 riviä latausta kohden**, UTF-8-koodattuna.
  Kaikki lisäsarakkeet säilytetään yhteystietokohtaisina muuttujina kampanjan
  yhteystietotietueissa.

## Luo kampanja

<Steps>
  <Step title="Napsauta Uusi kampanja">
    Nimeä kampanja, valitse **puheagentti** ja valitse **lähtönumero**
    (yksi VoIP-numeroistasi).
  </Step>

  <Step title="Lataa yhteystietojen CSV-tiedosto">
    Rivit, joilla on virheellinen puhelinnumero, hylätään yksitellen ja
    niistä ilmoitetaan rivinumeroineen — muut rivit tuodaan normaalisti.
  </Step>

  <Step title="Määritä soittoikkuna">
    Valitse **aikavyöhyke** ja **päivittäinen alkamis-/päättymisikkuna**; kampanja
    soittaa vain sen aikana. Ikkunat voivat jatkua yli keskiyön (esim. 22:00 → 02:00).
    Voit halutessasi määrittää **aloitusajan** ajoittaaksesi käynnistyksen sekä
    **päättymisajan**, jonka jälkeen kampanja päättyy automaattisesti.
  </Step>

  <Step title="Säädä tahtia ja uudelleenyrityksiä">
    * **Samanaikaiset puhelut** — kuinka monta puhelua tämä kampanja soittaa kerralla
      (1–10, oletus 3). Organisaatiosi enimmäisraja on myös **10
      samanaikaista lähtevää puhelua** kaikissa toiminnoissa, joten rinnakkaiset
      kampanjat jakavat tämän kapasiteetin.
    * **Enimmäisyritykset** — kuinka monta kertaa kullekin yhteystiedolle voidaan soittaa
      (oletus 2).
    * **Uudelleenyrityksen viive (minuutteina)** — odotusaika ennen uudelleenyritystä (oletus 60).
    * **Yritä uudelleen, jos** — mitkä lopputulokset käynnistävät uudelleenyrityksen: **ei vastausta**,
      **vastaaja**, **epäonnistui** (kaikki oletuksena käytössä).
  </Step>

  <Step title="Luo luonnos ja käynnistä">
    Kampanjat luodaan luonnoksina — yhteystietoja voi lisätä vain, kun
    kampanja on luonnos. Kampanjan käynnistäminen edellyttää nimenomaista suostumusta
    puhelumaksuihin. Tulevalla **aloitusajalla** kampanjasta tulee
    *ajastettu*; muussa tapauksessa se alkaa *käynnissä* välittömästi.
  </Step>
</Steps>

## Miten lopputulokset ja uudelleenyritykset toimivat

Jokaisen puhelun jälkeen yhteystieto saa lopputuloksen — onnistuneet puhelut
merkitään suoritetuiksi; puhelu, joka luokitellaan vastaamattomaksi, tunnistetaan vastaajaksi tai
epäonnistuu, yritetään uudelleen, jos kyseinen lopputulos on **yritä uudelleen, jos** -luettelossasi ja
yhteystiedolla on yrityksiä jäljellä. Yhteystiedot, joilta yritykset loppuvat, merkitään
*käytetyiksi*; epäonnistumiset, joita ei voi yrittää uudelleen, merkitään *epäonnistuneiksi*.

<Note>
  Soittaminen keskeytetään automaattisesti, kun tilisi saldo ei ole riittävä,
  ja sitä jatketaan, kun saldoa on taas riittävästi. Pidä
  [automaattinen täydennys](/fi/guides/billing-and-topups) käytössä pitkissä kampanjoissa.
</Note>

## Seuraa ja hallitse

Jokaisessa kampanjakortissa näkyy sen tila ja edistyminen (esim. "173 / 248
valmis"). Avaa kampanja nähdäksesi tilojen erittelyn, yhteystietokohtaiset
tulokset ja viimeisimmät puhelut — jokainen linkittää puheluhistorian koko
litterointiin ja tallenteeseen.

* **Keskeytä / jatka** — keskeyttäminen estää uudet soitot; jo
  käynnissä olevat puhelut päättyvät normaalisti. Keskeytettyjä kampanjoita voi muokata ja jatkaa.
* **Peruuta** — pysäyttää kampanjan pysyvästi.
* Kampanja päättyy itsestään, kun jokainen yhteystieto saavuttaa lopputilan
  tai **päättymisaika** ohitetaan.

Kampanjan tilat: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Yhteystiedon tilat: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

## Seuraavat vaiheet

<CardGroup cols={2}>
  <Card title="Seuraa puheluita reaaliajassa" icon="tower-broadcast" href="/fi/guides/monitor-live-calls">
    Kuuntele kampanjapuheluita niiden aikana.
  </Card>

  <Card title="Lähtevien puheluiden API" icon="phone-arrow-up-right" href="/fi/guides/place-outbound-calls">
    Soita yksittäisiä puheluita ohjelmallisesti.
  </Card>
</CardGroup>