---
title: "Utgående kampanjer"
description: "Last opp en kontaktliste og la en stemmeagent jobbe seg gjennom den – med ringevinduer, nye forsøk og fremdrift i sanntid."
---
Kampanjer ringer en liste med kontakter på dine vegne: velg en agent, last opp en
CSV-fil, angi når det er tillatt å ringe, så går ThunderPhone gjennom listen
— og prøver på nytt ved ubesvarte anrop og talepost etter planen du velger. Du finner
dem under **Engasjement → Kampanjer** (`/dashboard/campaigns`).
For enkeltstående programmatiske anrop bruker du
[API-et for utgående samtaler](/nb/guides/place-outbound-calls) i stedet.
## Forutsetninger
- En distribuert stemmeagent.
- Et telefonnummer med utgående anrop aktivert. Kundens VoIP-numre støtter fortsatt
kampanjer. ThunderPhone-numre starter som kun inngående; en organisasjonsadministrator kan
be om utgående anrop fra siden Telefonnumre. ThunderPhone vurderer
hver forespørsel manuelt, og godkjente numre kan kjøre kampanjer. Se
[Koble til en VoIP-leverandør](/nb/guides/voip-providers).
- Kontakter som en CSV-fil (eller innlimt JSON) med en `phone`- eller
`phone_number`-kolonne. **Opptil 5 000 rader per opplasting**, UTF-8-kodet.
Nye JSON-opplastinger må være flate: ekstra verdier kan være strenger, tall,
boolske verdier eller `null`. Rader som inneholder matriser eller nestede objekter, avvises
enkeltvis med en valideringsmelding. Gyldige rader importeres fortsatt. CSV-celler
er strenger. Godkjente ekstra kolonner beholdes som variabler per kontakt i kampanjens
kontaktoppføringer og oppgis automatisk ved hvert oppringingsforsøk. ThunderPhone
klassifiserer også den lagrede agentinstruksen før hvert utgående anrop for å avgjøre om
agenten skal navigere i en telefonmeny. Overskrifter som `name` og `account_id`
samsvarer med `{{name}}` og `{{account_id}}` i den lagrede agentens instruks. Navnekartlegging kan også kombinere kolonner til `name`. Se
[variabler per anrop](/nb/guides/call-variables) for standardverdier, navngivningsregler,
objektgrensen på 32 KB og verdier som returneres i webhooker ved fullføring.
Eldre kontaktoppføringer kan inneholde nestede metadata fra tidligere JSON-opplastinger.
Disse metadataene blir værende på den lagrede kontakten. Hvert anrop utelater ikke-skalarverdier fra
variabelnyttelasten og logger de ignorerte nøkkelnavnene for det forsøket, uten å
logge verdier. Nye forsøk bruker samme filtrering.
## Opprett en kampanje
Gi den et navn, velg **stemmeagenten**, og velg **avsendernummeret**
(ett av numrene dine som er aktivert for utgående anrop).
Rader med et ugyldig telefonnummer eller ugyldige variabler avvises enkeltvis og
rapporteres tilbake med radnumrene sine — resten importeres uten problemer.
Velg en **tidssone** og et vindu for **daglig start/slutt**; kampanjen
ringer bare innenfor dette. Tidssonen baseres på sonen til avsendernummeret ditt
(retningsnummeret i USA og Canada, landet ellers) eller, for
numre som dekker flere soner, for eksempel gratisnumre, nettleserens
tidssone. Hintet under feltet viser hvilken. Vinduet er som standard
9–17. Et vindu som starter før kl. 08 eller slutter etter kl. 21, viser en
advarsel: samtaler utenfor disse tidene kan bryte regler for ringetider,
som TCPA-reglene. En sluttid som er tidligere enn starttiden, krysser midnatt: 22:00 →
02:00 ringer fra kl. 22 til kl. 02 neste dag, med en advarsel. Vinduet
bruker kampanjens tidssone, ikke hver kontakts, så del opp
kontakter etter tidssone når de er spredt.
Du kan eventuelt angi et **starttidspunkt** for å planlegge oppstarten og et
**sluttidspunkt** som gjør at kampanjen fullføres automatisk.
- **Samtidige samtaler** — hvor mange samtaler denne kampanjen kjører samtidig
(1–10, standard 3). Kampanjer starter ingen nye samtaler mens
organisasjonen din har 10 utgående samtaler pågående, så parallelle
kampanjer deler denne kapasiteten. Hver samtale teller også mot
organisasjonens [grense for samtidige samtaler](/api-reference/introduction#call-limits)
(20 som standard, på tvers av inngående, utgående, nett- og testsamtaler).
Når denne grensen er nådd, eller samme nummer ble ringt opp de
siste 10 sekundene, venter kontakten ganske enkelt til en senere omgang; forsøkene
brukes ikke opp.
- **Maksimalt antall forsøk** — hvor mange ganger hver kontakt kan ringes opp
(1–10, standard 2).
- **Ventetid før nytt forsøk (minutter)** — ventetiden før et nytt forsøk (minst 30,
standard 60).
- **Prøv på nytt ved** — hvilke utfall som utløser et nytt forsøk: **ikke svar**,
**talepost**, **mislyktes** (alle er aktivert som standard).
Trenger du flere forsøk eller kortere intervaller? Kontakt kundestøtte: ansatte kan
øke begge grensene for organisasjonen din.
Kampanjer opprettes som utkast — kontakter kan bare legges til mens en
kampanje er et utkast. Å starte en kampanje krever et uttrykkelig samtykke
til samtalekostnadene. Med et fremtidig **starttidspunkt** blir den
*planlagt*; ellers begynner den å *kjøre* umiddelbart.
Kampanjer som ble lagret før disse grensene, fortsetter å kjøre nøyaktig som konfigurert.
Forsøkene og intervallene deres forblir som lagret gjennom andre endringer.
## Slik fungerer utfall og nye forsøk
Etter hver samtale får kontakten et utfall — vellykkede samtaler
markeres som fullført; en samtale som vurderes som ikke besvart, oppdages som
telefonsvarer eller mislykkes, forsøkes på nytt hvis utfallet er i listen din over **prøv på nytt ved** og
kontakten har forsøk igjen. Kontakter som går tom for forsøk, markeres som
*uttømt*; feil som ikke kan prøves på nytt, markeres som *mislykket*.
Oppringing settes automatisk på pause når kontosaldoen din ikke er i god
stand, og gjenopptas når den er det. Ha
[automatisk påfylling](/nb/guides/billing-and-topups) aktivert for lange kampanjer.
## Overvåk og kontroller
Hvert kampanjekort viser status og fremdrift (f.eks. «173 av 248
fullført»). Åpne en kampanje for statusfordelingen, resultater per kontakt
og nylige samtaler — hver av dem lenker til hele transkripsjonen og
opptaket i samtalehistorikken.
- **Sett på pause / gjenoppta** — å sette på pause stopper nye oppringinger; samtaler som allerede er
i gang, fullføres naturlig. Kampanjer på pause kan redigeres og gjenopptas.
- **Avbryt** — stopper kampanjen permanent.
- En kampanje fullføres automatisk når hver kontakt når en endelig
status eller tidspunktet **avslutt kl.** passeres.
Kampanjestatuser: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Kontaktstatuser: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.
## Neste trinn
Lytt til kampanjesamtaler mens de pågår.
Foreta enkeltsamtaler programmatisk.