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

# Kampanjer

> **Info**
>
> Reglerna för utgående samtal skiljer sig åt mellan länder, delstater och branscher, så rätt
> samtalstider och gränser för antal försök beror på vem du ringer och varför. Du ansvarar för att
> följa reglerna för utgående samtal, inklusive samtycken, vad agenten säger och hanteringen av
> nästa steg, samt för att ange gränser som stämmer överens med reglerna där dina kontakter bor. Se
> [ElevenAgents villkor](https://elevenlabs.io/agents-terms) och [TCPA-vägledningen](/docs/sv/eleven-agents/legal/tcpa)
> för mer information.

## Översikt

Kampanjer hanterar utgående kommunikation för dina agenter. Du skickar in en lista med mottagare, och kampanjen kontaktar dem genom återförsök, återuppringningar, vidarekopplingar och samtalsfönster tills varje mottagare når ett slutligt resultat som du styr. Kampanjer ersätter batchsamtal.

### Vad används kampanjer till?

Använd kampanjer för kontakt som kräver mer än ett samtal:

* **Uppföljningar som drivs av samtalet.** En mottagare ber om att bli uppringd klockan 16, eller ber dig prova en kollegas nummer. Kampanjen läser samtalsanalysen och schemalägger rätt nästa samtal.
* **Samtalsfönster.** Samtal rings bara inom de fönster du definierar, utvärderade i den tidszon du angett. Det enda undantaget är en återuppringning vid en tid som mottagaren har begärt, som rings vid den tidpunkten.
* **Begränsad uthållighet.** Misslyckade samtal och samtal utan svar försöks igen enligt ett schema, upp till gränser som du styr.
* **Insyn för operatörer.** Du kan se varje mottagare, varje samtal och varför varje beslut fattades, och du kan pausa eller avbryta när som helst.

## Kampanjpolicy

En kampanjs policy definierar hur uthållig den är och när den får ringa. Du anger en standardpolicy för din arbetsyta, och varje kampanj tar en ögonblicksbild av den när den skapas. Om du senare ändrar arbetsytans policy påverkar det bara kampanjer som skapas därefter.

```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"
    }
  }
}
```

### Gränser för återförsök

| Fält                                  | Beskrivning                                                                                                                                                                             |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `retry_delay_seconds`                 | Fördröjning före ett kort återförsök efter ett misslyckat samtal, ett samtal utan svar eller ett röstmeddelande.                                                                        |
| `max_total_calls`                     | Hård gräns för antal försök per mottagare, inklusive det första samtalet. En mottagare rings aldrig fler gånger än detta. Standard är 6, maximalt är 30.                                |
| `max_short_retries`                   | Korta återförsök som tillåts i varje samtalsfönster innan återförsöket flyttas till nästa fönster.                                                                                      |
| `max_callbacks`, `max_redirects`      | Gränser för återuppringningar och vidarekopplingar som en mottagare kan begära. Budgetarna för återförsök och återuppringningar återställs per nummer när ett samtal vidarekopplas.     |
| `max_consecutive_failures_per_number` | Valfritt. Antal misslyckanden i följd för ett nummer innan mottagaren flyttas till nästa registrerade nummer (upp till fem per mottagare), eller avslutas om det inte finns något.      |
| `interval_placement`                  | Var ett samtal placeras när det flyttas till ett framtida fönster: i början av fönstret, vid en slumpmässig tid inom det eller roterat för att undvika tider som redan har misslyckats. |

### Samtalsfönster

`calling_periods` definierar de veckovisa fönster då samtal kan ringas. Veckodagar numreras från 0 till 6, där måndag är 0. Tider är lokala `HH:MM` i policyns `timezone`, och intervall på samma veckodag får inte överlappa.

Återuppringningar vid en exakt tid är det enda undantaget. När en mottagare ber om att bli uppringd vid en specifik tid rings samtalet vid den tiden, även om den ligger utanför dina fönster. Ange max_callbacks med detta i åtanke.

En policy har en enda `timezone`. Om dina kontakter finns i flera tidszoner skapar du en separat kampanj för varje zon, med egna `timezone` och samtalsfönster, så att varje samtal sker under tillåtna tider där mottagaren bor.

### Mappning av dynamiska variabler

Kampanjer kopplar standardobjekten för datainsamling till din agent med ett klick, vilket möjliggör återuppringningar, vidarekopplingar och att sluta ringa.

Du kan också mappa ytterligare analysresultat till [dynamiska variabler](/docs/sv/eleven-agents/customization/personalization/dynamic-variables) för uppföljningssamtal, så att ett återförsök eller en återuppringning kan börja med det som framkom i det föregående samtalet.

### Kontext för uppföljning

Använd dessa variabler i agentens prompt för att göra återuppringningar sammanhängande.

| Variabel                             | Innehåller                                                                                    |
| ------------------------------------ | --------------------------------------------------------------------------------------------- |
| `campaign__call_type`                | Om samtalet är en första kontakt, ett återförsök, en återuppringning eller en vidarekoppling. |
| `campaign__previous_conversation_id` | ID:t för den föregående konversationen med mottagaren.                                        |
| `campaign__previous_summary`         | Sammanfattningen av den föregående konversationen.                                            |
| `campaign__previous_transcript`      | Transkriptionen av den föregående konversationen.                                             |

## Kanaler

| Kanal    | Läge | Anmärkningar                                                                                                                                                     |
| -------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Telefon  | Röst | Fullständigt stöd för återförsök, återuppringningar och vidarekopplingar.                                                                                        |
| WhatsApp | Röst | En enda behörighetsförfrågan skickas per mottagare, följt av återförsök och återuppringningar. Se [utgående WhatsApp](/docs/sv/eleven-agents/whatsapp/outbound). |
| WhatsApp | Text | Skickar en godkänd WhatsApp-mall för meddelanden till varje mottagare. Återförsök gäller inte. Se [utgående WhatsApp](/docs/sv/eleven-agents/whatsapp/outbound). |

E-post- och SMS-kanaler kommer snart.

## Skapa en kampanj

#### Öppna Kampanjer

I navigeringen för ElevenAgents väljer du **Kampanjer**.

#### Spara din arbetsytepolicy

Öppna **Inställningar**, definiera din tidszon, gränser för återförsök och samtalsfönster och spara sedan. Se
[Kampanjpolicy](#campaign-policy).

#### Skapa kampanjen

Välj **Ny kampanj**, välj en agent, en kanal och ett telefonnummer och ladda sedan upp dina
mottagare. Ladda upp en CSV-fil eller skicka in mottagare via API:et med samma begärandeformat som för ett
batchsamtal. Varje mottagare kan ha upp till fem telefonnummer (`phone_number` till
`phone_number_5` i CSV-filen).

#### Aktivera avancerade funktioner

Aktivera **Avancerade kontroller** för att använda återförsök, återuppringningar och uppföljningar inom angivna
samtalsfönster. Dessa hämtas automatiskt från dina arbetsyteinställningar, eller så kan du
justera dem här för varje kampanj.

#### Följ förloppet

Följ förloppet på fliken **Analys**.

Samtal köas när du skapar en kampanj och rings när de hamnar inom ett samtalsfönster.

> **Warning**
>
> Kampanjer är inte tillgängliga för arbetsytor eller agenter som använder [Zero Retention Mode](/docs/sv/eleven-agents/customization/privacy/zrm). Beslut om uppföljning beror på beständig samtalsstatus
> och konversationsanalys, så begäranden från arbetsytor med zero retention och inskick för
> agenter med zero retention avvisas.

## Samtidighet

Kampanjsamtal räknas mot samtidighetsgränserna för din arbetsyta och agent. Som standard använder en kampanj det lägre av 50 % av arbetsytans samtidighet eller 70 % av agentens samtidighet. Du kan ange en lägre gräns för en enskild kampanj.

## API

Skapande, hantering och analys av kampanjer är tillgängligt via ElevenLabs API, så att du kan integrera kampanjer i dina befintliga workflows och applikationer. Se [API-referensen](/docs/sv/api-reference/introduction) för tillgängliga slutpunkter.

## Bästa praxis

* **Börja i liten skala.** Testa med en kort lista och ett försiktigt `max_total_calls` innan du lanserar för hela målgruppen.
* **Ange fönster med eftertanke.** Samtalsfönster är din främsta kontroll för att respektera lokala samtalstider. Ange `timezone` för platsen där dina mottagare finns och håll fönstren väl inom tillåtna tider.
* **Samla in signaler för uppföljning.** Kampanjer hanterar bara återuppringningar, vidarekopplingar och begäranden om att inte bli uppringd om agenten registrerar dem. Ange i agentens prompt när var och en ska registreras.
* **Använd kontext för uppföljning.** Referera till `campaign__previous_summary` i din prompt så att ett återförsök eller en återuppringning fortsätter där det senaste samtalet slutade i stället för att upprepa inledningen.
* **Håll gränserna låga.** Uthållighet är en kostnad både för dina mottagare och för dig. Föredra några väl tajmade försök framför många.

## Vanliga frågor

#### Kan jag ändra policyn för en pågående kampanj?

Nej. En kampanjs policy är fast när den skapas. Ändringar av arbetsytans policy gäller för
kampanjer som du skapar därefter. Om du vill ändra en pågående kampanj stoppar du den och skapar en ny.

#### Kan en mottagare vara med i fler än en kampanj?

Varje kampanj spårar sina egna leads, och statusen för att inte bli uppringd tillhör kampanjen. Dubblettkontrollera
mottagare mellan kampanjer innan du skapar dem om du behöver undvika att kontakta någon två gånger.

## Nästa steg

* [Datainsamling](/docs/sv/eleven-agents/customization/agent-analysis/data-collection): Samla in signalerna som din agent agerar på.
* [Dynamiska variabler](/docs/sv/eleven-agents/customization/personalization/dynamic-variables): Anpassa varje mottagares samtal.
* [Skyddsräcken](/docs/sv/eleven-agents/best-practices/guardrails): Håll din utgående agent till ämnet och varumärket.