> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Campagne in uscita

> Carica un elenco di contatti e lascia che un agente lo gestisca, con finestre di chiamata, tentativi ripetuti e avanzamento in tempo reale.

Le campagne chiamano un elenco di contatti per tuo conto: scegli un agente, carica un
CSV, imposta quando è consentito chiamare e ThunderPhone procede con l'elenco
— ritentando in caso di mancata risposta e segreteria telefonica secondo la pianificazione che scegli. Le trovi in **Engagement → Campaigns** (`/dashboard/campaigns`).

Per chiamate programmatiche una tantum, usa invece l'
[API per le chiamate in uscita](/it/guides/place-outbound-calls).

## Prerequisiti

* Un voice agent distribuito.
* Un **numero di telefono VoIP** collegato alla tua organizzazione da cui chiamare —
  i numeri demo sono solo per le chiamate in entrata e non possono effettuare chiamate delle campagne. Vedi
  [Collega un provider VoIP](/it/guides/voip-providers).
* Contatti in un file CSV (o JSON incollato) con una colonna `phone` o
  `phone_number`. **Fino a 5.000 righe per caricamento**, con codifica UTF-8.
  Tutte le colonne aggiuntive vengono mantenute come variabili per contatto nei record
  dei contatti della campagna.

## Crea una campagna

<Steps>
  <Step title="Fai clic su Nuova campagna">
    Assegnale un nome, scegli il **voice agent** e il **numero di origine**
    (uno dei tuoi numeri VoIP).
  </Step>

  <Step title="Carica il CSV dei contatti">
    Le righe con un numero di telefono non valido vengono rifiutate singolarmente e
    segnalate con i relativi numeri di riga — le altre vengono importate correttamente.
  </Step>

  <Step title="Imposta la finestra di chiamata">
    Scegli un **fuso orario** e una finestra **giornaliera di inizio/fine**; la campagna
    chiama solo al suo interno. Le finestre possono estendersi oltre la mezzanotte (ad es. 22:00 → 02:00).
    Facoltativamente, imposta un orario **inizia il** per programmare l'avvio e un orario
    **termina il** dopo il quale la campagna si completa automaticamente.
  </Step>

  <Step title="Regola ritmo e tentativi">
    * **Chiamate simultanee** — quante chiamate questa campagna esegue contemporaneamente
      (1–10, valore predefinito 3). La tua organizzazione ha inoltre un limite di **10
      chiamate in uscita simultanee** complessive, quindi le campagne parallele
      condividono questo limite.
    * **Numero massimo di tentativi** — quante volte è possibile chiamare ciascun contatto
      (valore predefinito 2).
    * **Intervallo tra i tentativi (minuti)** — l'attesa prima di un nuovo tentativo (valore predefinito 60).
    * **Riprova in caso di** — quali esiti attivano un nuovo tentativo: **nessuna risposta**,
      **segreteria telefonica**, **non riuscita** (tutti attivi per impostazione predefinita).
  </Step>

  <Step title="Crea bozza, poi avvia">
    Le campagne vengono create come bozze — i contatti possono essere aggiunti solo quando una
    campagna è in bozza. L'avvio di una campagna richiede un consenso esplicito
    agli addebiti delle chiamate. Con un valore futuro di **inizia il**, diventa
    *programmata*; altrimenti passa immediatamente a *in esecuzione*.
  </Step>
</Steps>

## Come funzionano esiti e tentativi

Dopo ogni chiamata, al contatto viene assegnato un esito — le chiamate riuscite sono
contrassegnate come completate; una chiamata classificata come senza risposta, rilevata come segreteria telefonica o
non riuscita viene ritentata se l'esito è nell'elenco **riprova in caso di** e il
contatto ha ancora tentativi disponibili. I contatti che esauriscono i tentativi vengono contrassegnati come
*esauriti*; gli errori non ritentabili vengono contrassegnati come *non riusciti*.

<Note>
  La composizione si interrompe automaticamente quando il saldo del tuo account non è in
  regola e riprende quando torna a esserlo. Mantieni attiva la
  [ricarica automatica](/it/guides/billing-and-topups) per le campagne lunghe.
</Note>

## Monitora e controlla

Ogni scheda della campagna mostra lo stato e l'avanzamento (ad es. "173 di 248
completati"). Apri una campagna per visualizzare la suddivisione degli stati, i risultati per contatto
e le chiamate recenti — ciascuna rimanda alla trascrizione completa e alla
registrazione nella cronologia chiamate.

* **Metti in pausa / riprendi** — la pausa interrompe le nuove composizioni; le chiamate già
  in corso terminano naturalmente. Le campagne in pausa possono essere modificate e riprese.
* **Annulla** — interrompe definitivamente la campagna.
* Una campagna si completa automaticamente quando ogni contatto raggiunge uno stato
  finale o quando trascorre l'orario **termina il**.

Stati della campagna: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Stati del contatto: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

## Passaggi successivi

<CardGroup cols={2}>
  <Card title="Ascolta le chiamate in diretta" icon="tower-broadcast" href="/it/guides/monitor-live-calls">
    Ascolta le chiamate della campagna mentre avvengono.
  </Card>

  <Card title="API per chiamate in uscita" icon="phone-arrow-up-right" href="/it/guides/place-outbound-calls">
    Effettua singole chiamate in modo programmatico.
  </Card>
</CardGroup>
