---
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."
ui: classic
---

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. VoIP čísla zákazníků nadále podporují kampaně. Čísla ThunderPhone jsou zpočátku pouze pro příchozí hovory; správce organizace může o odchozí volání požádat na stránce Telefonní čísla. ThunderPhone každou žádost posuzuje 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ávané soubory 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 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 vytáčení. ThunderPhone také před každým odchozím hovorem klasifikuje uložený prompt agenta, aby rozhodl, zda má agent procházet telefonní menu. Záhlaví jako `name` a `account_id`, bez ohledu na způsob zápisu, 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é hovory](/cs/guides/call-variables), kde najdete výchozí hodnoty, pravidla pojmenování, limit objektu 32 KB a hodnoty vrácené ve webhookách po 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ě

<Steps>
  <Step title="Klikněte na Nová kampaň">
    Pojmenujte ji, vyberte **hlasového agenta** a zvolte **čísla pro odchozí volání**:
    jedno nebo více čísel s povoleným odchozím voláním. Rozložení hovorů mezi
    několik místních čísel udržuje každé číslo pod limity operátora pro spam
    a lidem zobrazí místní předvolbu. Viz
    [fondy čísel](#number-pools-and-daily-limits).
  </Step>
  <Step title="Nahrajte CSV kontaktů">
    Řádky s neplatným telefonním číslem nebo neplatnými proměnnými jsou jednotlivě zamítnuty
    a vráceny s čísly řádků — ostatní se importují bez problémů.
  </Step>
  <Step title="Nastavte časové okno volání">
    Zvolte **časové pásmo** a okno **denního začátku/konce**; kampaň
    volá pouze v tomto okně. Časové pásmo se určí podle pásma vašeho prvního čísla pro odchozí volání
    (podle předvolby v USA a Kanadě, jinde podle země) nebo, pokud je nelze
    určit z žádného volajícího čísla, podle časového pásma vašeho agenta. U čísel, která pokrývají
    několik pásem, například bezplatných čísel, se použije časové pásmo vašeho agenta,
    nebo vašeho prohlížeče, pokud agent žádné nemá. Nápověda pod polem uvádí,
    které z nich se použije. Výchozí okno je
    9:00–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 pravidla TCPA. Konec před začátkem 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í.
    **Volat v místním čase každého kontaktu** (ve výchozím nastavení zapnuto) spouští okno
    podle místa každého kontaktu určeného jeho předvolbou: 9:00 znamená 9:00 v New Yorku
    pro kontakt z New Yorku a 9:00 v Los Angeles pro kontakt z Los Angeles.
    Kontakty bez předvolby USA nebo Kanady používají výše uvedené časové pásmo
    a na předvolbu, která zahrnuje dvě pásma, se volá pouze tehdy, když jsou obě
    v rámci okna.
    Vypněte tuto možnost, aby se okno pro všechny řídilo časovým pásmem kampaně.
    Volitelně nastavte **začít v** pro naplánování spuštění a
    **skončit v**, po kterém se kampaň automaticky dokončí.
  </Step>
  <Step title="Upravte tempo a opakování">
    - **Souběžná volání** — kolik hovorů tato kampaň provádí najednou
      (1–10, výchozí hodnota 3). Kampaně nezahájí nový hovor, dokud má vaše
      organizace rozpracováno 10 odchozích hovorů, takže souběžné
      kampaně tento limit sdílejí. 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 v
      posledních 10 sekundách kontakt jednoduše čeká na pozdější průchod; jeho
      pokusy se nevyčerpají.
    - **Hovory na číslo za den** — maximální počet odchozích hovorů, které každé
      číslo pro odchozí volání uskuteční během libovolných 24 hodin (1–500, výchozí hodnota 75).
      Vymažte hodnotu pro neomezený počet. Pokud je číslo ve fondu aktuálně označeno středním nebo vysokým
      rizikem spamu, kampaň je přeskočí, dokud označení nezmizí.
    - **Maximální počet pokusů** — kolikrát lze každému kontaktu volat
      (1–10, výchozí hodnota 2).
    - **Prodleva před opakováním (minuty)** — nejkratší čekání před opakováním (alespoň
      30, výchozí hodnota 60).
    - **Načasování opakování** — **Rozložit mezi dny a denní doby** (výchozí
      nastavení) přesune každé opakování na pozdější den a do jiné části
      dne kontaktu: ráno, pak v poledne a poté pozdě odpoledne.
      **Po prodlevě** opakuje hovor přesně po uplynutí prodlevy.
    - **Volat dvakrát při nezvednutí hovoru** — pokud hovor vyzvání bez odpovědi, zavolejte
      ze stejného čísla ještě jednou o 30–60 sekund později. Nevyužije se tím
      žádný pokus. Na iPhonu může druhý hovor během tří minut zazvonit i přes režim Nerušit,
      pokud je zapnutá možnost Povolit opakované hovory. Opakované vytáčení zabírá
      čas, takže kampaň, ve které většina hovorů zůstane bez odpovědi, při zapnuté této možnosti oslovuje nové
      kontakty pomaleji.
    - **Opakovat při** — které výsledky spustí opakování: **bez odpovědi**,
      **hlasová schránka**, **neúspěch** (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.
  </Step>
  <Step title="Vytvořte koncept a poté jej spusťte">
    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*.
  </Step>
</Steps>

<Note>
  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é.
</Note>

## Fondy čísel a denní limity

Telefonní operátoři označují čísla jako spam, když z nich uskutečníte mnoho hovorů za den nebo voláte v dávkách, a lidé častěji zvedají hovory, když vidí místní předvolbu. Kampaň s několika odchozími čísly (jejím fondem) rozloží hovory mezi ně:

- Každému kontaktu se volá z čísla, ze kterého mu bylo voláno naposledy, takže opakované pokusy přicházejí ze stejného ID volajícího. Nový kontakt dostane číslo z fondu se svou předvolbou, jinak číslo ve svém časovém pásmu, případně číslo používané nejméně za posledních 24 hodin. Tabulka kontaktů ukazuje, které číslo volalo jednotlivým kontaktům. Když je zapnuto **Poslat zprávu před voláním**, číslo si ponechává kapacitu pro kontakty, kterým poslalo zprávu, takže po vyčerpání této kapacity může opakovaný pokus přijít z jiného čísla ve fondu.
- **Hovory na číslo za den** započítávají každý odchozí hovor z daného čísla ve vaší organizaci za posledních 24 hodin, včetně dalších kampaní a volání API.
- Číslo ThunderPhone s méně než týdnem odchozích hovorů se postupně zavádí: první den uskuteční maximálně 20 hovorů a limit se rovnoměrně zvyšuje na plnou hodnotu do 7. dne. Čísla od vašeho vlastního operátora zavádění přeskočí.
- Když všechna čísla dosáhnou svého limitu, kontakty čekají. Nic neselže a nevyčerpají se žádné pokusy; stránka kampaně uvádí důvod čekání a volání se samo obnoví, jakmile hovory z posledního dne přestanou být započítávány. Chcete-li postupovat rychleji, pozastavte kampaň a přidejte čísla nebo zvyšte limit.
- Pokud číslo přestane během kampaně fungovat, kampaň pokračuje ve volání z ostatních čísel a pozastaví se pouze tehdy, když nezůstane žádné.

Obecně nastavte velikost fondu tak, aby denní objem seznamu vydělený počtem čísel zůstal pod limitem. Fond slouží k řízení tempa a místní přítomnosti: číslo označené jako spam raději vyřaďte, než abyste přidávali nová čísla, která ho mají skrýt.

## Text před voláním

Lidé s větší pravděpodobností zvednou hovor z čísla, které očekávají. Kampaň může každému kontaktu několik minut před prvním hovorem poslat textovou zprávu s informací, kdo volá a z jakého čísla.

Zapněte ji ve formuláři pro vytvoření nebo úpravu kampaně v části **Text před voláním**: zapněte přepínač, v části **Odesílat textové zprávy z** vyberte číslo, upravte **Zprávu** a nastavte **Minuty před hovorem** (1–60, výchozí hodnota 2).
Prostřednictvím API nastavte v poli
[kampaně](/api-reference/campaigns#text-before-calling) `pre_call_sms_*`.

- Textové zprávy se odesílají z vašeho vlastního čísla Twilio nebo Telnyx. Z čísel ThunderPhone nelze posílat textové zprávy.
- Zpráva může používat proměnné kontaktu a také `{{org_name}}`,
  `{{agent_name}}` a `{{call_from_number}}` (číslo fondu, které bude tomuto kontaktu volat; hovor z něj skutečně přijde). Chybějící proměnná se vynechá, takže kontakt bez křestního jména dostane „Hi, this is …“. Výchozí zpráva:

  ```text
  Hi {{first_name}}, this is {{org_name}}. We'll call you in a few minutes from {{call_from_number}}. Reply STOP to opt out of texts.
  ```
- Textovou zprávu obdrží pouze první hovor; opakované pokusy ji nikdy neobdrží. Kampaně uskutečňují hovory v průchodech každých 5 minut, takže při výchozích 2 minutách se hovor uskuteční přibližně 5 minut po odeslání textové zprávy.
- Nastavte krátký počet minut před hovorem. Kontakt, kterému byla odeslána textová zpráva, drží svůj slot hovoru až do uskutečnění hovoru, takže dlouhý předstih kampaň zpomaluje: při 3 souběžných hovorech a 30 minutách odešle textové zprávy 3 lidem a pak půl hodiny čeká, než jim zavolá. Kontakt s odeslanou textovou zprávou je volán před opakovanými pokusy, které jsou již splatné.
- Textová zpráva se odešle pouze tehdy, když je okno volání otevřené a zůstane otevřené i pro hovor, s rezervou 5 minut. Je-li zapnuto **Volat v místním čase každého kontaktu**, jedná se o vlastní okno kontaktu. V opačném případě kontakt čeká na další okno. Okno musí být alespoň o 12 minut delší než počet minut před hovorem.
- Textová zpráva, jejíž odeslání selže nebo je přeskočeno, hovor nikdy nezdrží: kontakt se vytočí ihned. Pevné linky se přeskakují. Neúspěšně odeslané textové zprávy se neodesílají znovu.

<Warning>
  Odesílání textových zpráv vyžaduje stejný souhlas jako volání; textové zprávy také podléhají pravidlům TCPA a operátorů. Místní číslo v USA musí být na vašem účtu Twilio zaregistrováno pro A2P 10DLC (dokud nebude schváleno, kontaktům se volá bez textové zprávy a kampaň zobrazí upozornění), bezplatné číslo vyžaduje ověření bezplatného čísla a číslo Telnyx vyžaduje profil pro zasílání zpráv. Poplatky operátora vám účtuje váš operátor.
  ThunderPhone zatím nepřijímá odpovědi, takže STOP zpracovává mechanismus odhlášení vašeho operátora. Viz [SMS](/api-reference/sms).
</Warning>

Otevřete kampaň a v sloupci **Textová zpráva** uvidíte výsledek textové zprávy každého kontaktu: doručeno nebo odesláno, neodesláno (s důvodem), přeskočeno nebo neznámé. Prostřednictvím API je to u kontaktu
[`pre_call_sms`](/api-reference/campaigns#contact-object) a každá
textová zpráva se také zobrazí v `GET /v1/sms` s `source: "pre_call"`.

## Přeskakování mobilních čísel

Hovory s hlasem AI na mobilní čísla vyžadují podle TCPA předchozí výslovný souhlas dané osoby. Pokud voláte firmám nebo na pevné linky a nemáte tento souhlas pro mobilní čísla ve svém seznamu, požádejte Zeus, aby kampaň mobilní čísla přeskakovala, nebo prostřednictvím [API](/api-reference/campaigns#number-type-filter) nastavte `line_type_filter` na `skip_mobile`.

- Číslo každého kontaktu se ověřuje těsně před jeho prvním hovorem. Na pevné linky, čísla VoIP a bezplatná čísla se volá; na mobilní čísla a čísla, která ověření nedokáže klasifikovat, se nevolá. `skip_landline` funguje opačně a přeskakuje pouze pevné linky.
- Každé ověření stojí zlomek centu a účtuje se z vašeho zůstatku (viz [ceny](/cs/guides/pricing)). Číslo, které vaše organizace ověřila během posledních 90 dnů, je zdarma a kontakty, kterým se nikdy nevolá, se nikdy neověřují. Zeus se před zapnutím této funkce zeptá.
- Přeskočený kontakt skončí jako *neúspěšný* s výsledkem `skipped_mobile` (nebo `skipped_landline` či `skipped_unknown_line_type`), nikdy se mu nevolá a ve výsledcích kampaně se započítává jako přeskočený.
- Pokud ověření selže, kontakt čeká na další průchod; po třech neúspěšných průchodech skončí s `line_type_check_failed` a nevolá se mu.

Filtr nenahrazuje souhlas pro čísla, na která volá.

## 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é*.

<Note>
  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é.
</Note>

## 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

<CardGroup cols={2}>
  <Card title="Sledujte hovory živě" icon="tower-broadcast" href="/cs/guides/monitor-live-calls">
    Poslouchejte hovory kampaně v reálném čase.
  </Card>
  <Card title="API pro odchozí hovory" icon="phone-arrow-up-right" href="/cs/guides/place-outbound-calls">
    Uskutečňujte jednotlivé hovory programově.
  </Card>
</CardGroup>
