---
title: "Odchozí kampaně"
description: "Nahrajte seznam kontaktů a nechte agenta jej postupně zpracovat — s časovými okny pro volání, opakovanými pokusy a živým přehledem průběhu."
---
Kampaně vaším jménem vytáčejí seznam kontaktů: vyberte agenta, nahrajte
CSV, nastavte, kdy je volání povoleno, a ThunderPhone zpracuje seznam
— opakuje volání při nezvednutí hovoru a hlasové schránce podle vámi zvoleného plánu. Najdete je v nabídce **Interakce → Kampaně** (`/dashboard/campaigns`).
Pro jednorázové programově řízené hovory použijte místo toho
[API pro odchozí hovory](/cs/guides/place-outbound-calls).
## Předpoklady
- Nasazený hlasový agent.
- Telefonní číslo s povoleným odchozím voláním. Zákaznická čísla VoIP nadále podporují
kampaně. Čísla ThunderPhone začínají pouze s příchozím voláním; správce organizace může
požádat o odchozí volání na stránce Telefonní čísla. ThunderPhone každou žádost
kontroluje ručně a schválená čísla mohou spouštět kampaně. Viz
[Připojení poskytovatele VoIP](/cs/guides/voip-providers).
- Kontakty jako soubor CSV (nebo vložený JSON) se sloupcem `phone` nebo
`phone_number`. **Až 5 000 řádků na nahrání**, kódování UTF-8.
Nová nahrání JSON musí být plochá: další hodnoty mohou být řetězce, čísla,
booleovské hodnoty nebo `null`. Řádky obsahující pole nebo vnořené objekty jsou
jednotlivě odmítnuty s validační zprávou; platné řádky se i přesto importují. Buňky CSV
jsou řetězce. Přijaté další sloupce se uchovávají jako proměnné jednotlivých kontaktů v
záznamech kontaktů kampaně a automaticky se předávají při každém volání. ThunderPhone také
před každým odchozím voláním klasifikuje uložený prompt agenta, aby rozhodl, zda má
agent procházet telefonní menu. Záhlaví jako `name` a `account_id`
odpovídají `{{name}}` a `{{account_id}}` v promptu uloženého agenta. Mapování jména může také kombinovat sloupce do `name`. Viz
[proměnné pro jednotlivá volání](/cs/guides/call-variables), kde najdete výchozí hodnoty, pravidla pojmenování,
limit objektu 32 KB a hodnoty vrácené ve webhookách dokončení.
Starší záznamy kontaktů mohou obsahovat vnořená metadata z dřívějších nahrání JSON.
Tato metadata zůstávají u uloženého kontaktu. Každé vytáčení vynechá neskalární hodnoty ze
své datové části proměnných a pro daný pokus zaznamená ignorované názvy klíčů, aniž by
zaznamenávalo hodnoty. Opakované pokusy používají stejné filtrování.
## Vytvoření kampaně
Pojmenujte ji, vyberte **hlasového agenta** a zvolte **výchozí číslo**
(jedno z vašich čísel s povoleným odchozím voláním).
Řádky s neplatným telefonním číslem nebo neplatnými proměnnými jsou jednotlivě odmítnuty a
vráceny s čísly řádků — ostatní se importují správně.
Vyberte **časové pásmo** a denní okno **začátku/konce**; kampaň
volá pouze v jeho rámci. Časové pásmo se nejprve určí podle pásma vašeho výchozího čísla
(jeho předvolby v USA a Kanadě, jinde podle země) nebo u
čísel, která pokrývají několik pásem, například bezplatných čísel, podle
vašeho prohlížeče. Nápověda pod polem uvádí, které platí. Ve výchozím nastavení je okno
od 9:00 do 17:00. Okno, které začíná před 8:00 nebo končí po 21:00, zobrazí
upozornění: hovory mimo tyto hodiny mohou porušovat pravidla pro dobu volání,
například TCPA. Konec dříve než začátek přechází přes půlnoc: 22:00 →
02:00 volá od 22:00 do 2:00 následujícího dne a zobrazí upozornění. Okno
platí v časovém pásmu kampaně, nikoli každého kontaktu, proto kontakty rozdělte
podle časového pásma, pokud jsou rozptýlené.
Volitelně nastavte **začít v** pro naplánování spuštění a
**ukončit v**, po kterém se kampaň automaticky dokončí.
- **Souběžné hovory** — kolik hovorů tato kampaň provádí najednou
(1–10, výchozí hodnota 3). Kampaně nezahájí nový hovor, dokud vaše
organizace má 10 probíhajících odchozích hovorů, takže paralelní
kampaně sdílejí tento limit. Každý hovor se také započítává do
[limitu souběžných hovorů](/api-reference/introduction#call-limits) vaší organizace
(výchozí hodnota 20 napříč příchozími, odchozími, webovými a testovacími hovory).
Po dosažení tohoto limitu nebo pokud bylo na stejné číslo voláno během
posledních 10 sekund kontakt jednoduše čeká na další průchod; jeho
pokusy se nevyčerpají.
- **Maximální počet pokusů** — kolikrát lze volat každému kontaktu
(1–10, výchozí hodnota 2).
- **Prodleva opakování (minuty)** — čekání před opakováním (alespoň 30,
výchozí hodnota 60).
- **Opakovat při** — které výsledky spustí opakování: **bez odpovědi**,
**hlasová schránka**, **selhání** (vše je ve výchozím nastavení zapnuto).
Potřebujete více pokusů nebo kratší rozestupy? Kontaktujte podporu: její pracovníci mohou
zvýšit oba limity pro vaši organizaci.
Kampaně se vytvářejí jako koncepty — kontakty lze přidávat pouze, dokud je
kampaň konceptem. Spuštění kampaně vyžaduje výslovný souhlas
s poplatky za hovory. S budoucím nastavením **začít v** bude
*naplánovaná*; jinak se okamžitě začne *spouštět*.
Kampaně uložené před zavedením těchto limitů běží nadále přesně podle konfigurace.
Jejich počet pokusů a rozestupy zůstávají při dalších úpravách uložené.
## Jak fungují výsledky a opakované pokusy
Po každém hovoru kontakt získá výsledek — úspěšné hovory jsou
označeny jako dokončené; hovor vyhodnocený jako bez odpovědi, rozpoznaný jako hlasová schránka nebo
neúspěšný se opakuje, pokud je tento výsledek ve vašem seznamu **opakovat při** a kontaktu zbývají pokusy. Kontakty, kterým dojdou pokusy, jsou označeny jako
*vyčerpané*; neopakovatelné neúspěšné hovory jsou označeny jako *neúspěšné*.
Vytáčení se automaticky pozastaví, dokud zůstatek na vašem účtu není v pořádku,
a obnoví se, jakmile v pořádku bude. U dlouhých kampaní ponechte
[automatické dobíjení](/cs/guides/billing-and-topups) zapnuté.
## Sledování a ovládání
Každá karta kampaně zobrazuje její stav a postup (např. „173 z 248
dokončeno“). Otevřete kampaň, abyste zobrazili rozpis stavů, výsledky jednotlivých kontaktů
a poslední hovory — každý z nich odkazuje na úplný přepis a
nahrávku v historii hovorů.
- **Pozastavit / obnovit** — pozastavením se zastaví nové vytáčení; již
probíhající hovory se dokončí přirozeně. Pozastavené kampaně lze upravovat a obnovit.
- **Zrušit** — trvale zastaví kampaň.
- Kampaň se dokončí automaticky, když každý kontakt dosáhne konečného
stavu nebo uplyne čas **ukončit v**.
Stavy kampaně: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Stavy kontaktu: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Další kroky
Poslouchejte hovory kampaně v reálném čase.
Uskutečňujte jednotlivé hovory programově.