---
title: "Lähtevät kampanjat"
description: "Lataa yhteystietoluettelo ja anna agentin käydä se läpi — puheluikkunoiden, uudelleenyritysten ja reaaliaikaisen etenemisen 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 vastaajaviestejä valitsemallasi aikataululla. Löydät
ne kohdasta **Sitouttaminen → Kampanjat** (`/dashboard/campaigns`).
Kertaluonteisiin ohjelmallisiin puheluihin käytä sen sijaan
[lähtevien puheluiden APIa](/fi/guides/place-outbound-calls).
## Vaatimukset
- Käyttöönotettu puheagentti.
- Lähteville puheluille käytössä oleva puhelinnumero. Asiakkaan VoIP-numerot tukevat edelleen
kampanjoita. ThunderPhone-numerot ovat aluksi vain saapuville puheluille; organisaation järjestelmänvalvoja voi
pyytää lähtevien puheluiden käyttöönottoa Puhelinnumerot-sivulta. ThunderPhone tarkistaa
jokaisen pyynnön manuaalisesti, ja hyväksytyillä numeroilla voi toteuttaa kampanjoita. Katso
[Yhdistä VoIP-palveluntarjoaja](/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.
Uusien JSON-latausten on oltava litteitä: lisäarvot voivat olla merkkijonoja, numeroita,
totuusarvoja tai `null`. Taulukoita tai sisäkkäisiä objekteja sisältävät rivit hylätään
yksitellen validointiviestillä; kelvolliset rivit tuodaan silti. CSV-solut
ovat merkkijonoja. Hyväksytyt lisäsarakkeet säilytetään kontaktikohtaisina muuttujina kampanjan
yhteystietotietueissa ja välitetään automaattisesti jokaiseen soittoon. ThunderPhone myös
luokittelee tallennetun agenttikehotteen ennen jokaista lähtevää puhelua päättääkseen, pitäisikö
agentin käsitellä puhelinvalikkoa. Otsikot, kuten `name` ja `account_id`,
vastaavat tallennetun agentin kehotteessa olevia muuttujia `{{name}}` ja `{{account_id}}`. Nimikartoitus voi myös yhdistää sarakkeita muuttujaan `name`. Katso
[puhelukohtaiset muuttujat](/fi/guides/call-variables), jos haluat lisätietoja oletusarvoista, nimeämissäännöistä,
32 KB:n objektiliitistä ja valmistumisen webhookeissa palautettavista arvoista.
Vanhemmat yhteystietotietueet voivat sisältää aiemmista JSON-latauksista peräisin olevia sisäkkäisiä metatietoja.
Nämä metatiedot säilyvät tallennetussa yhteystiedossa. Jokainen puhelu jättää ei-skalaariset arvot pois
muuttujakuormastaan ja kirjaa kyseisen yrityksen ohitettujen avainten nimet ilman
arvojen kirjaamista. Uudelleenyritykset käyttävät samaa suodatusta.
## Luo kampanja
Nimeä kampanja, valitse **puheagentti** ja **soittonumero**
(jokin lähteville puheluille käyttöön otetuista numeroistasi).
Rivitet, joilla on virheellinen puhelinnumero tai virheellisiä muuttujia, hylätään yksitellen ja
niistä ilmoitetaan rivinumeroineen — muut rivit tuodaan onnistuneesti.
Valitse **aikavyöhyke** ja **päivittäinen alkamis-/päättymisaika**; kampanja
soittaa vain niiden aikana. Aikavyöhyke perustuu ensin soittonumerosi vyöhykkeeseen
(Yhdysvalloissa ja Kanadassa suuntanumeroon, muualla maahan) tai usean vyöhykkeen kattavien
numeroiden, kuten maksuttomien numeroiden, kohdalla selaimesi aikavyöhykkeeseen.
Kentän alla oleva vihje kertoo, kumpaa käytetään. Oletusikkuna on
klo 9–17. Ikkuna, joka alkaa ennen klo 8:a tai päättyy klo 21:n jälkeen, näyttää
varoituksen: näiden aikojen ulkopuolella soittaminen voi rikkoa soittoaikoja koskevia sääntöjä,
kuten TCPA:ta. Alkuaikaa aiempi päättymisaika ylittää keskiyön: 22:00 →
02:00 soittaa klo 22:sta seuraavan päivän klo 2:een varoituksen kera. Ikkuna
noudattaa kampanjan aikavyöhykettä, ei kunkin yhteystiedon aikavyöhykettä, joten jaa
yhteystiedot aikavyöhykkeittäin, kun ne ovat hajallaan.
Voit halutessasi määrittää **alkamisajan** ajastaaksesi käynnistyksen ja
**päättymisajan**, jonka jälkeen kampanja päättyy automaattisesti.
- **Samanaikaiset puhelut** — kuinka monta puhelua kampanja soittaa yhtä aikaa
(1–10, oletus 3). Kampanjat eivät aloita uusia puheluita, kun organisaatiollasi
on käynnissä 10 lähtevää puhelua, joten rinnakkaiset
kampanjat jakavat tämän kapasiteetin. Jokainen puhelu lasketaan myös organisaatiosi
[samanaikaisten puheluiden enimmäismäärään](/api-reference/introduction#call-limits)
(oletuksena 20 kaikissa saapuvissa, lähtevissä, verkko- ja testipuheluissa).
Kun tämä raja saavutetaan tai samaan numeroon on soitettu viimeisten
10 sekunnin aikana, yhteystieto odottaa seuraavaa kierrosta; sen
yrityksiä ei kuluteta.
- **Yritysten enimmäismäärä** — kuinka monta kertaa kuhunkin yhteystietoon voidaan soittaa
(1–10, oletus 2).
- **Uudelleenyrityksen viive (minuutit)** — odotusaika ennen uudelleenyritystä (vähintään 30,
oletus 60).
- **Yritä uudelleen, kun** — mitkä lopputulokset käynnistävät uudelleenyrityksen: **ei vastausta**,
**vastaaja**, **epäonnistui** (kaikki ovat oletuksena käytössä).
Tarvitsetko enemmän yrityksiä tai lyhyemmän välin? Ota yhteyttä tukeen: henkilöstö voi
nostaa organisaatiosi molempia rajoja.
Kampanjat luodaan luonnoksina — yhteystietoja voi lisätä vain, kun
kampanja on luonnos. Kampanjan käynnistäminen edellyttää nimenomaista suostumusta
puhelumaksuihin. Tulevalla **alkamisajalla** kampanjasta tulee
*ajoitettu*; muussa tapauksessa se alkaa *käynnissä* heti.
Ennen näitä rajoja tallennetut kampanjat jatkavat toimintaansa täsmälleen tallennettujen asetusten mukaisesti.
Niiden yritysmäärät ja välit säilyvät tallennettuina muiden muokkausten yhteydessä.
## Miten lopputulokset ja uudelleenyritykset toimivat
Jokaisen puhelun jälkeen yhteyshenkilö saa lopputuloksen — onnistuneet puhelut
merkitään suoritetuiksi; puhelu, jonka tulokseksi on arvioitu vastaamaton, joka
on tunnistettu vastaajaksi tai joka epäonnistui, yritetään uudelleen, jos kyseinen
lopputulos on **yritä uudelleen, kun** -luettelossasi ja yhteyshenkilöllä on
yrityksiä jäljellä. Yhteyshenkilöt, joilta yritykset loppuvat, merkitään
*yritykset käytetty*; epäonnistumiset, joita ei yritetä uudelleen, merkitään
*epäonnistuneiksi*.
Soittaminen keskeytyy automaattisesti, kun tilisi saldo ei ole kunnossa,
ja jatkuu, kun se on taas kunnossa. Pidä
[automaattinen saldon lisäys](/fi/guides/billing-and-topups) käytössä pitkissä kampanjoissa.
## Seuraa ja hallitse
Jokaisessa kampanjakortissa näkyvät sen tila ja eteneminen (esim. "173/248
valmis"). Avaa kampanja nähdäksesi tilojen erittelyn, yhteyshenkilökohtaiset
tulokset ja viimeisimmät puhelut — jokainen niistä linkittää puheluhistorian
koko transkriptioon ja tallenteeseen.
- **Keskeytä / jatka** — keskeyttäminen estää uudet soitot; jo käynnissä
olevat puhelut päättyvät luonnollisesti. Keskeytettyjä kampanjoita voi muokata ja jatkaa.
- **Peruuta** — pysäyttää kampanjan pysyvästi.
- Kampanja valmistuu automaattisesti, kun jokainen yhteyshenkilö saavuttaa lopullisen
tilan tai **päättyy klo** -aika ohitetaan.
Kampanjoiden tilat: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Yhteyshenkilöiden tilat: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Seuraavat vaiheet
Kuuntele kampanjapuheluita niiden aikana.
Soita yksittäisiä puheluita ohjelmallisesti.