> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Kampanie

> **Info**
>
> Połączenia wychodzące podlegają różnym regulacjom zależnie od kraju, stanu i branży, dlatego odpowiednie godziny dzwonienia
> oraz limity prób zależą od tego, do kogo i w jakim celu dzwonisz. To ty odpowiadasz za zgodność
> połączeń wychodzących z przepisami, w tym za zgody, treść wypowiedzi agenta i zarządzanie kolejnymi krokami, a także za ustawienie
> limitów zgodnych z zasadami obowiązującymi w miejscu zamieszkania twoich kontaktów. Szczegóły znajdziesz w [warunkach ElevenAgents](https://elevenlabs.io/agents-terms) oraz [wytycznych TCPA](/docs/pl/eleven-agents/legal/tcpa).

## Przegląd

Kampanie realizują komunikację wychodzącą dla twoich agentów. Przesyłasz listę odbiorców, a kampania kontaktuje się z nimi przez ponowienia prób, oddzwonienia, przekierowania i okna dzwonienia, aż każdy odbiorca osiągnie określony przez ciebie końcowy wynik. Kampanie zastępują połączenia wsadowe.

### Do czego służą kampanie

Używaj kampanii do działań wymagających więcej niż jednego połączenia:

* **Dalszy kontakt zależny od rozmowy.** Odbiorca prosi o oddzwonienie o 16:00 albo o próbę pod numerem współpracownika. Kampania odczytuje analizę rozmowy i planuje właściwe kolejne połączenie.
* **Okna dzwonienia.** Połączenia są wykonywane tylko w określonych przez ciebie oknach, ocenianych w wybranej strefie czasowej. Jedynym wyjątkiem jest oddzwonienie o czasie wskazanym przez odbiorcę — jest wykonywane właśnie wtedy.
* **Ograniczona wytrwałość.** Nieudane i nieodebrane połączenia są ponawiane zgodnie z harmonogramem, do limitów, które ustalasz.
* **Widoczność dla operatora.** Możesz zobaczyć każdego odbiorcę, każde połączenie i powód każdej decyzji, a także w każdej chwili wstrzymać lub anulować kampanię.

## Polityka kampanii

Polityka kampanii określa, jak wytrwała jest kampania i kiedy może dzwonić. Ustawiasz domyślną politykę dla workspace'u, a każda kampania otrzymuje jej migawkę podczas tworzenia. Późniejsza zmiana polityki workspace'u wpływa tylko na kampanie utworzone później.

```json
{
  "policy": {
    "timezone": "America/New_York",
    "retry": {
      "retry_delay_seconds": 600,
      "max_short_retries": 1,
      "max_total_calls": 6,
      "max_callbacks": 2,
      "max_redirects": 2,
      "interval_placement": "start"
    },
    "calling_periods": [
      {
        "weekdays": [0, 1, 2, 3, 4],
        "intervals": [
          { "start": "10:00", "end": "12:00" },
          { "start": "16:00", "end": "18:00" }
        ]
      }
    ],
    "data_collection": {
      "callback_time": "__system_data_collection_callback_time",
      "redirect_phone_number": "__system_data_collection_redirect_phone_number",
      "stop": "__system_data_collection_do_not_call"
    }
  }
}
```

### Limity ponownych prób

| Pole                                  | Opis                                                                                                                                                                           |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `retry_delay_seconds`                 | Opóźnienie przed szybką ponowną próbą po nieudanym, nieodebranym połączeniu lub poczcie głosowej.                                                                              |
| `max_total_calls`                     | Twardy limit prób na odbiorcę, w tym pierwszego połączenia. Odbiorca nigdy nie otrzyma więcej połączeń. Domyślnie 6, maksymalnie 30.                                           |
| `max_short_retries`                   | Liczba szybkich ponownych prób dozwolonych w każdym oknie dzwonienia, zanim próba zostanie przeniesiona do następnego okna.                                                    |
| `max_callbacks`, `max_redirects`      | Limity oddzwonień i przekierowań, o które może poprosić odbiorca. Budżety ponownych prób i oddzwonień resetują się dla każdego numeru po przekierowaniu rozmowy.               |
| `max_consecutive_failures_per_number` | Opcjonalne. Liczba kolejnych niepowodzeń na jednym numerze, po której odbiorca przechodzi do następnego zapisanego numeru (do pięciu na odbiorcę) lub kończy, jeśli go nie ma. |
| `interval_placement`                  | Miejsce połączenia po przeniesieniu do przyszłego okna: początek okna, losowy czas w jego obrębie lub rotacja, by uniknąć godzin, które już nie zadziałały.                    |

### Okna dzwonienia

`calling_periods` określają tygodniowe okna, w których można wykonywać połączenia. Dni tygodnia są numerowane od 0 do 6, gdzie poniedziałek to 0. Godziny są lokalne, w formacie `HH:MM`, w strefie czasowej `timezone` polityki, a przedziały tego samego dnia tygodnia nie mogą się nakładać.

Oddzwonienia o dokładnej godzinie są jedynym wyjątkiem. Gdy odbiorca prosi o telefon o konkretnej porze, połączenie jest wykonywane wtedy, nawet jeśli wypada poza twoimi oknami. Ustaw `max_callbacks`, mając to na uwadze.

Polityka ma jedną `timezone`. Jeśli twoje kontakty są w kilku strefach czasowych, utwórz osobną kampanię dla każdej strefy, z własną `timezone` i oknami dzwonienia, aby każde połączenie odbyło się w dozwolonych godzinach w miejscu zamieszkania odbiorcy.

### Dynamiczne mapowanie zmiennych

Kampanie jednym kliknięciem dodają do twojego agenta domyślne elementy zbierania danych, co umożliwia oddzwonienia, przekierowania i zatrzymanie połączeń.

Możesz też mapować dodatkowe wyniki analizy na [zmienne dynamiczne](/docs/pl/eleven-agents/customization/personalization/dynamic-variables) dla kolejnych połączeń, aby ponowna próba lub oddzwonienie mogły zacząć się od informacji zebranych podczas poprzedniej rozmowy.

### Kontekst kolejnego kontaktu

Odwołuj się do tych zmiennych w prompcie agenta, aby oddzwonienia sprawiały wrażenie ciągłości.

| Zmienna                              | Zawiera                                                                                             |
| ------------------------------------ | --------------------------------------------------------------------------------------------------- |
| `campaign__call_type`                | Informację, czy rozmowa jest pierwszym kontaktem, ponowną próbą, oddzwonieniem czy przekierowaniem. |
| `campaign__previous_conversation_id` | ID poprzedniej rozmowy z odbiorcą.                                                                  |
| `campaign__previous_summary`         | Podsumowanie poprzedniej rozmowy.                                                                   |
| `campaign__previous_transcript`      | Transkrypcję poprzedniej rozmowy.                                                                   |

## Kanały

| Kanał    | Tryb  | Uwagi                                                                                                                                                                                        |
| -------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Telefon  | Głos  | Pełna obsługa ponownych prób, oddzwonień i przekierowań.                                                                                                                                     |
| WhatsApp | Głos  | Do każdego odbiorcy wysyłana jest jedna prośba o zgodę, po której następują ponowne próby i oddzwonienia. Zobacz [połączenia wychodzące WhatsApp](/docs/pl/eleven-agents/whatsapp/outbound). |
| WhatsApp | Tekst | Wysyła do każdego odbiorcy zatwierdzony szablon wiadomości WhatsApp. Ponowne próby nie mają zastosowania. Zobacz [połączenia wychodzące WhatsApp](/docs/pl/eleven-agents/whatsapp/outbound). |

Kanały e-mail i SMS będą dostępne wkrótce.

## Utwórz kampanię

#### Otwórz kampanie

W nawigacji ElevenAgents wybierz **Kampanie**.

#### Zapisz politykę workspace'u

Otwórz **Ustawienia**, określ strefę czasową, limity ponownych prób i okna dzwonienia, a następnie zapisz. Zobacz
[Polityka kampanii](#campaign-policy).

#### Utwórz kampanię

Wybierz **Nowa kampania**, wybierz agenta, kanał i numer telefonu, a następnie prześlij
odbiorców. Prześlij plik CSV lub dodaj odbiorców przez API, używając tej samej struktury żądania co dla
połączenia wsadowego. Każdy odbiorca może mieć do pięciu numerów telefonu (`phone_number` do
`phone_number_5` w pliku CSV).

#### Włącz zaawansowane funkcje

Włącz **Zaawansowane ustawienia**, aby aktywować ponowne próby, oddzwonienia i kolejne kontakty w określonych
oknach dzwonienia. Ustawienia zostaną automatycznie pobrane z ustawień workspace'u lub możesz
dostosować je tutaj dla każdej kampanii.

#### Monitoruj postęp

Śledź postęp na karcie **Analityka**.

Połączenia są kolejkowane podczas tworzenia kampanii i wykonywane, gdy znajdą się w oknie dzwonienia.

> **Warning**
>
> Kampanie nie są dostępne dla workspace'ów ani agentów korzystających z [trybu Zero Retention Mode](/docs/pl/eleven-agents/customization/privacy/zrm). Decyzje o kolejnych kontaktach zależą od trwałego stanu połączeń
> i analizy rozmów, dlatego żądania z workspace'ów z zerową retencją oraz zgłoszenia dla
> agentów z zerową retencją są odrzucane.

## Współbieżność

Połączenia kampanii wliczają się do limitów współbieżności workspace'u i agenta. Domyślnie kampania wykorzystuje niższą z wartości: 50% współbieżności workspace'u lub 70% współbieżności agenta. Możesz ustawić niższy limit dla pojedynczej kampanii.

## API

Tworzenie kampanii, zarządzanie nimi i analityka są dostępne przez API ElevenLabs, dzięki czemu możesz zintegrować kampanie z obecnymi workflow i aplikacjami. Dostępne endpointy znajdziesz w [dokumentacji API](/docs/pl/api-reference/introduction).

## Dobre praktyki

* **Zacznij od małej skali.** Przetestuj kampanię na krótkiej liście i z zachowawczym `max_total_calls`, zanim uruchomisz ją dla całej grupy odbiorców.
* **Świadomie ustaw okna.** Okna dzwonienia to główne narzędzie do przestrzegania lokalnych godzin kontaktu. Ustaw `timezone` zgodnie z lokalizacją odbiorców i trzymaj okna wyraźnie w granicach dozwolonych godzin.
* **Zbieraj sygnały do kolejnego kontaktu.** Kampanie obsługują oddzwonienia, przekierowania i prośby o zaprzestanie połączeń tylko wtedy, gdy agent je zarejestruje. W prompcie agenta określ, kiedy ma zapisywać każdą z tych informacji.
* **Korzystaj z kontekstu kolejnego kontaktu.** Odwołaj się w prompcie do `campaign__previous_summary`, aby ponowna próba lub oddzwonienie kontynuowały poprzednią rozmowę, zamiast powtarzać wstęp.
* **Utrzymuj niskie limity.** Wytrwałość wiąże się z kosztem zarówno dla odbiorców, jak i dla ciebie. Lepiej wykonać kilka dobrze zaplanowanych prób niż wiele.

## FAQ

#### Czy mogę zmienić politykę trwającej kampanii?

Nie. Polityka kampanii jest stała od momentu jej utworzenia. Zmiany w polityce workspace'u dotyczą
kampanii utworzonych później. Aby zmienić trwającą kampanię, zatrzymaj ją i utwórz nową.

#### Czy odbiorca może być w więcej niż jednej kampanii?

Każda kampania śledzi własne leady, a stan zakazu połączeń należy do kampanii. Usuń duplikaty
odbiorców między kampaniami przed ich utworzeniem, jeśli chcesz uniknąć dwukrotnego kontaktu z tą samą osobą.

## Kolejne kroki

* [Zbieranie danych](/docs/pl/eleven-agents/customization/agent-analysis/data-collection): Rejestruj sygnały, na podstawie których działa twój agent.
* [Zmienne dynamiczne](/docs/pl/eleven-agents/customization/personalization/dynamic-variables): Personalizuj rozmowę z każdym odbiorcą.
* [Bariery ochronne](/docs/pl/eleven-agents/best-practices/guardrails): Dbaj o to, by agent wychodzący trzymał się tematu i stylu marki.