---
title: "Väljuvad kampaaniad"
description: "Laadi üles kontaktide loend ja lase häälagendil see läbi töötada — koos helistamisakende, korduskatsete ja reaalajas edenemise jälgimisega."
---

Kampaaniad valivad sinu nimel kontaktide loendist numbreid: vali agent, laadi üles
CSV, määra, millal helistamine on lubatud, ning ThunderPhone töötleb loendi läbi
— proovides vastamata kõnesid ja kõneposti uuesti sinu valitud ajakava järgi. Leia
need jaotisest **Kaasamine → Kampaaniad** (`/dashboard/campaigns`).

Ühekordsete programmiliste kõnede jaoks kasuta selle asemel
[väljuvate kõnede API-t](/et/guides/place-outbound-calls).

## Eeltingimused

- Juurutatud häälagent.
- Sinu organisatsiooniga ühendatud **VoIP-telefoninumber**, millelt helistada —
  ThunderPhone'i numbrid on ainult sissetulevate kõnede jaoks ega saa kampaaniakõnesid teha. Vaata
  [VoIP-pakkuja ühendamist](/et/guides/voip-providers).
- Kontaktid CSV-failina (või kleebitud JSON-ina), millel on veerg `phone` või
  `phone_number`. **Kuni 5000 rida üleslaadimise kohta**, UTF-8 kodeeringus.
  Uued JSON-i üleslaadimised peavad olema tasapinnalise struktuuriga: lisaväärtused võivad olla stringid, arvud,
  tõeväärtused või `null`. Massiive või pesastatud objekte sisaldavad read lükatakse
  valideerimisteatega eraldi tagasi; sobivad read imporditakse siiski. CSV-lahtrid
  on stringid. Lubatud lisaveerud säilitatakse kampaania kontaktikirjetes kontaktipõhiste muutujatena ja
  edastatakse automaatselt iga numbri valimisega. Päised nagu
  `name` ja `account_id` vastavad salvestatud agendi viibas olevatele muutujatele `{{name}}` ja `{{account_id}}`.
  Nime vastendamine võib ühendada veerge ka väljaks `name`. Vaata
  [kõnepõhiseid muutujaid](/et/guides/call-variables), et saada teavet vaikeväärtuste, nimereeglite,
  32 KB objektipiirangu ja lõpetamise webhook'ides tagastatavate väärtuste kohta.

Vanemad kontaktikirjed võivad sisaldada varasematest JSON-i üleslaadimistest pärit pesastatud metaandmeid.
Need metaandmed jäävad salvestatud kontaktikirjele alles. Iga numbri valimise katse jätab mitteskalaarsed väärtused
oma muutujate andmekoormusest välja ja logib selle katse jaoks eiratud võtmete nimed, ilma
väärtusi logimata. Korduskatsed kasutavad sama filtreerimist.

## Loo kampaania

<Steps>
  <Step title="Klõpsa valikul Uus kampaania">
    Pane sellele nimi, vali **häälagent** ja **lähtev number**
    (üks sinu VoIP-numbritest).
  </Step>
  <Step title="Laadi üles kontaktide CSV">
    Kehtetu telefoninumbri või kehtetute muutujatega read lükatakse eraldi tagasi ja
    tagastatakse koos nende reanumbritega — ülejäänud imporditakse probleemideta.
  </Step>
  <Step title="Määra helistamisaken">
    Vali **ajavöönd** ja **päevane algus-/lõpuaeg**; kampaania
    valib numbreid ainult selle ajavahemiku sees. Aken võib ulatuda üle südaöö (nt 22:00 → 02:00).
    Soovi korral määra **algusaeg**, et käivitamine ajastada, ning
    **lõpuaeg**, mille järel kampaania lõpetatakse automaatselt.
  </Step>
  <Step title="Seadista kõnetempo ja korduskatsed">
    - **Samaaegsed kõned** — mitu kõnet see kampaania korraga teeb
      (1–10, vaikimisi 3). Sinu organisatsioonis on kõigi kampaaniate peale samuti ülempiir **10
      samaaegset väljuvat kõnet**, seega jagavad paralleelsed
      kampaaniad seda mahtu.
    - **Maksimaalne katsete arv** — mitu korda võib iga kontakti numbrit valida
      (vaikimisi 2).
    - **Korduskatse viivitus (minutites)** — ooteaeg enne korduskatset (vaikimisi 60).
    - **Proovi uuesti, kui** — millised tulemused käivitavad korduskatse: **vastamata**,
      **kõnepost**, **nurjunud** (kõik on vaikimisi lubatud).
  </Step>
  <Step title="Loo mustand, seejärel käivita">
    Kampaaniad luuakse mustanditena — kontakte saab lisada ainult siis, kui
    kampaania on mustand. Kampaania käivitamiseks tuleb selgesõnaliselt nõustuda
    kõnetasudega. Tulevikus oleva **algusajaga** muutub see
    *ajastatuks*; muul juhul alustab see kohe olekus *käimas*.
  </Step>
</Steps>

## Kuidas tulemused ja korduskatsed toimivad

Pärast iga kõnet saab kontakt tulemuse — edukad kõned
märgitakse lõpetatuks; vastamata kõneks hinnatud, kõnepostina tuvastatud või
nurjunud kõnet proovitakse uuesti, kui see tulemus on sinu loendis **proovi uuesti, kui** ja
kontaktil on katseid alles. Kontaktid, kelle katsed saavad otsa, märgitakse
*ammendunuks*; mittekorratavad tõrked märgitakse *nurjunuks*.

<Note>
  Numbrite valimine peatub automaatselt, kui sinu konto saldo ei ole korras,
  ning jätkub, kui see on taas korras. Hoia pikaajaliste kampaaniate jaoks
  [automaatne saldo täiendamine](/et/guides/billing-and-topups) sisse lülitatuna.
</Note>

## Jälgi ja halda

Iga kampaaniakaart näitab selle olekut ja edenemist (nt „173 248-st
lõpetatud“). Ava kampaania, et näha olekute jaotust, kontaktipõhiseid
tulemusi ja hiljutisi kõnesid — igaüks neist viitab kõneajaloo täielikule
transkriptile ja salvestisele.

- **Peata / jätka** — peatamine lõpetab uute numbrite valimise; juba
  käimas olevad kõned lõppevad loomulikult. Peatatud kampaaniaid saab muuta
  ja jätkata.
- **Tühista** — peatab kampaania jäädavalt.
- Kampaania lõpeb automaatselt, kui iga kontakt jõuab lõppolekusse või
  möödub **lõpeta kell** aeg.

Kampaania olekud: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Kontakti olekud: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

## Järgmised sammud

<CardGroup cols={2}>
  <Card title="Jälgi kõnesid reaalajas" icon="tower-broadcast" href="/et/guides/monitor-live-calls">
    Kuula kampaaniakõnesid nende toimumise ajal.
  </Card>
  <Card title="Väljuvate kõnede API" icon="phone-arrow-up-right" href="/et/guides/place-outbound-calls">
    Tee üksikuid kõnesid programmiliselt.
  </Card>
</CardGroup>