---
title: "Kampanie wychodzące"
description: "Prześlij listę kontaktów i pozwól agentowi ją obsłużyć — z oknami połączeń, ponownymi próbami i postępem na żywo."
---
Kampanie dzwonią do listy kontaktów w Twoim imieniu: wybierz agenta, prześlij
plik CSV, ustaw, kiedy połączenia są dozwolone, a ThunderPhone obsłuży listę
— ponawiając próby po braku odpowiedzi i poczcie głosowej zgodnie z wybranym harmonogramem. Znajdziesz
je w **Zaangażowanie → Kampanie** (`/dashboard/campaigns`).
W przypadku jednorazowych połączeń programistycznych użyj zamiast tego
[interfejsu API połączeń wychodzących](/pl/guides/place-outbound-calls).
## Wymagania wstępne
- Wdrożony agent głosowy.
- Numer telefonu z włączoną obsługą połączeń wychodzących. Numery VoIP klienta nadal obsługują
kampanie. Numery ThunderPhone początkowo obsługują tylko połączenia przychodzące; administrator organizacji może
poprosić o włączenie połączeń wychodzących na stronie Numery telefonów. ThunderPhone ręcznie sprawdza
każde zgłoszenie, a zatwierdzone numery mogą prowadzić kampanie. Zobacz
[Połącz dostawcę VoIP](/pl/guides/voip-providers).
- Kontakty jako plik CSV (lub wklejony JSON) z kolumną `phone` lub
`phone_number`. **Do 5 000 wierszy na przesłanie**, kodowanie UTF-8.
Nowe przesłania JSON muszą być płaskie: dodatkowe wartości mogą być ciągami znaków, liczbami,
wartościami logicznymi lub `null`. Wiersze zawierające tablice lub zagnieżdżone obiekty są odrzucane
indywidualnie z komunikatem walidacyjnym; prawidłowe wiersze są nadal importowane. Komórki CSV
są ciągami znaków. Akceptowane dodatkowe kolumny są zachowywane jako zmienne dla poszczególnych kontaktów w
rekordach kontaktów kampanii i automatycznie przekazywane do każdej próby połączenia. ThunderPhone również
klasyfikuje zapisany prompt agenta przed każdym połączeniem wychodzącym, aby zdecydować, czy
agent powinien obsługiwać menu telefoniczne. Nagłówki takie jak `name` i `account_id`
odpowiadają wartościom `{{name}}` i `{{account_id}}` w prompcie zapisanego agenta. Mapowanie nazw może również łączyć kolumny w `name`. Zobacz
[zmienne dla pojedynczego połączenia](/pl/guides/call-variables), aby poznać wartości domyślne, zasady nazewnictwa,
limit obiektu 32 KB oraz wartości zwracane w webhookach zakończenia.
Starsze rekordy kontaktów mogą zawierać zagnieżdżone metadane z wcześniejszych przesłań JSON.
Te metadane pozostają w zapisanym kontakcie. Przy każdym wybieraniu numeru wartości nieskalarne są pomijane w
ładunku zmiennych, a nazwy pominiętych kluczy są rejestrowane dla tej próby bez
rejestrowania wartości. Ponowne próby używają tego samego filtrowania.
## Utwórz kampanię
Nadaj jej nazwę, wybierz **agenta głosowego** i wskaż **numer wychodzący**
(jeden z numerów z włączonymi połączeniami wychodzącymi).
Wiersze z nieprawidłowym numerem telefonu lub nieprawidłowymi zmiennymi są odrzucane pojedynczo
i zgłaszane wraz z ich numerami — pozostałe są importowane poprawnie.
Wybierz **strefę czasową** oraz **codzienny przedział rozpoczęcia/zakończenia**; kampania
wykonuje połączenia wyłącznie w tym przedziale. Strefa czasowa jest domyślnie ustawiana na strefę numeru wychodzącego
(kod kierunkowy w USA i Kanadzie, kraj w pozostałych miejscach) albo, w przypadku
numerów obejmujących kilka stref, takich jak numery bezpłatne, na strefę czasową
przeglądarki. Wskazówka pod polem informuje, która strefa jest używana. Domyślnie przedział
wynosi od 9:00 do 17:00. Przedział rozpoczynający się przed 8:00 lub kończący po 21:00 wyświetla
ostrzeżenie: połączenia poza tymi godzinami mogą naruszać przepisy dotyczące godzin wykonywania połączeń,
takie jak przepisy TCPA. Zakończenie wcześniejsze niż rozpoczęcie przechodzi przez północ: 22:00 →
02:00 oznacza połączenia od 22:00 do 2:00 następnego dnia, z ostrzeżeniem. Przedział
obowiązuje w strefie czasowej kampanii, a nie każdego kontaktu, dlatego podziel
kontakty według stref czasowych, gdy są rozproszone.
Opcjonalnie ustaw **rozpoczęcie o**, aby zaplanować uruchomienie, oraz
**zakończenie o**, po którym kampania zakończy się automatycznie.
- **Równoczesne połączenia** — liczba połączeń wykonywanych jednocześnie przez tę kampanię
(1–10, domyślnie 3). Kampanie nie rozpoczynają nowych połączeń, gdy Twoja
organizacja ma 10 aktywnych połączeń wychodzących, więc równoległe
kampanie współdzielą ten limit. Każde połączenie jest również wliczane do
[limitu równoczesnych połączeń](/api-reference/introduction#call-limits) Twojej organizacji
(domyślnie 20, łącznie dla połączeń przychodzących, wychodzących, internetowych i testowych).
Gdy limit zostanie osiągnięty lub ten sam numer był wybierany w ciągu
ostatnich 10 sekund, kontakt po prostu czeka na kolejny przebieg; jego
próby nie są zużywane.
- **Maksymalna liczba prób** — ile razy można wybrać numer każdego kontaktu
(1–10, domyślnie 2).
- **Odstęp przed ponowieniem (minuty)** — czas oczekiwania przed ponowieniem (co najmniej 30,
domyślnie 60).
- **Ponów przy** — wyniki powodujące ponowienie: **brak odpowiedzi**,
**poczta głosowa**, **niepowodzenie** (wszystkie domyślnie włączone).
Potrzebujesz więcej prób lub krótszych odstępów? Skontaktuj się z pomocą techniczną: pracownicy mogą
zwiększyć oba limity dla Twojej organizacji.
Kampanie są tworzone jako wersje robocze — kontakty można dodawać tylko, gdy
kampania jest wersją roboczą. Uruchomienie kampanii wymaga wyraźnej zgody
na koszty połączeń. Przy przyszłym ustawieniu **rozpoczęcie o** staje się
*zaplanowana*; w przeciwnym razie od razu staje się *w toku*.
Kampanie zapisane przed wprowadzeniem tych limitów działają nadal dokładnie zgodnie z konfiguracją.
Ich liczba prób i odstępy pozostają zapisane mimo innych zmian.
## Jak działają wyniki i ponowienia
Po każdym połączeniu kontakt otrzymuje wynik — udane połączenia są
oznaczane jako ukończone; połączenie zaklasyfikowane jako brak odpowiedzi,
wykryte jako poczta głosowa lub nieudane jest ponawiane, jeśli ten wynik
znajduje się na liście **ponawiaj przy** i kontakt ma pozostałe próby. Kontakty,
którym skończą się próby, są oznaczane jako *wyczerpane*; błędy, których nie
można ponowić, są oznaczane jako *nieudane*.
Wybieranie numerów jest automatycznie wstrzymywane, gdy stan rozliczeń
na koncie nie jest prawidłowy, i wznawiane, gdy znów jest prawidłowy. Włącz
[automatyczne doładowanie](/pl/guides/billing-and-topups) w przypadku długich kampanii.
## Monitorowanie i kontrola
Każda karta kampanii pokazuje jej status i postęp (np. „173 z 248
ukończonych”). Otwórz kampanię, aby zobaczyć podział statusów, wyniki dla
poszczególnych kontaktów i ostatnie połączenia — każde z nich prowadzi do
pełnej transkrypcji i nagrania w Historii połączeń.
- **Wstrzymaj / wznów** — wstrzymanie zatrzymuje nowe wybieranie numerów;
połączenia już trwające kończą się naturalnie. Wstrzymane kampanie można
edytować i wznawiać.
- **Anuluj** — trwale zatrzymuje kampanię.
- Kampania kończy się automatycznie, gdy każdy kontakt osiągnie stan końcowy
lub minie czas **zakończ o**.
Statusy kampanii: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Statusy kontaktów: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Kolejne kroki
Słuchaj połączeń kampanii w trakcie ich trwania.
Wykonuj pojedyncze połączenia programowo.