--- title: "Campagne in uscita" description: "Carica un elenco di contatti e lascia che un agente lo gestisca, con finestre di chiamata, tentativi e avanzamento in tempo reale." --- Le campagne chiamano un elenco di contatti per tuo conto: scegli un agente, carica un CSV, imposta quando sono consentite le chiamate e ThunderPhone procede nell'elenco — ritentando le chiamate senza risposta e le segreterie telefoniche secondo la pianificazione scelta. Le trovi in **Engagement → Campagne** (`/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 abilitato alle chiamate in uscita. I numeri VoIP del cliente continuano a supportare le campagne. I numeri ThunderPhone sono inizialmente solo per le chiamate in entrata; un amministratore dell'organizzazione può richiedere le chiamate in uscita dalla pagina Phone Numbers. ThunderPhone esamina manualmente ogni richiesta e i numeri approvati possono eseguire campagne. Vedi [Connettere un provider VoIP](/it/guides/voip-providers). - Contatti come file CSV (o JSON incollato) con una colonna `phone` o `phone_number`. **Fino a 5.000 righe per caricamento**, con codifica UTF-8. I nuovi caricamenti JSON devono essere piatti: i valori aggiuntivi possono essere stringhe, numeri, booleani o `null`. Le righe contenenti array o oggetti nidificati vengono rifiutate singolarmente con un messaggio di convalida; le righe valide vengono comunque importate. Le celle CSV sono stringhe. Le colonne aggiuntive accettate vengono mantenute come variabili per contatto nei record dei contatti della campagna e fornite automaticamente a ogni chiamata. ThunderPhone inoltre classifica il prompt dell'agente salvato prima di ogni chiamata in uscita per decidere se l'agente deve navigare in un menu telefonico. Le intestazioni come `name` e `account_id` corrispondono a `{{name}}` e `{{account_id}}` nel prompt dell'agente salvato. La mappatura del nome può anche combinare colonne in `name`. Vedi [variabili per chiamata](/it/guides/call-variables) per i valori predefiniti, le regole di denominazione, il limite dell'oggetto di 32 KB e i valori restituiti nei webhook di completamento. I record di contatto meno recenti possono contenere metadati annidati provenienti da caricamenti JSON precedenti. Tali metadati rimangono nel contatto memorizzato. Ogni chiamata omette i valori non scalari dal payload delle variabili e registra i nomi delle chiavi ignorate per quel tentativo, senza registrarne i valori. I tentativi ripetuti usano lo stesso filtraggio. ## Crea una campagna Assegnale un nome, seleziona l'**agente vocale** e scegli il **numero di partenza** (uno dei tuoi numeri abilitati alle chiamate in uscita). Le righe con un numero di telefono o variabili non validi vengono rifiutate singolarmente e segnalate con i relativi numeri di riga; le altre vengono importate correttamente. Scegli un **fuso orario** e una finestra di **inizio/fine giornaliera**; la campagna effettua chiamate solo al suo interno. Il fuso orario iniziale corrisponde a quello del tuo numero di partenza (il prefisso negli Stati Uniti e in Canada, il paese altrove) oppure, per numeri che coprono più fusi come quelli verdi, a quello del tuo browser. Il suggerimento sotto il campo indica quale. Per impostazione predefinita, la finestra è dalle 9:00 alle 17:00. Una finestra che inizia prima delle 8:00 o termina dopo le 21:00 mostra un avviso: le chiamate al di fuori di questi orari potrebbero violare le regole sugli orari di chiamata, come quelle del TCPA. Un orario di fine precedente all'inizio attraversa la mezzanotte: 22:00 → 02:00 effettua chiamate dalle 22:00 fino alle 2:00 del giorno successivo, con un avviso. La finestra usa il fuso orario della campagna, non quello di ciascun contatto, quindi dividi i contatti per fuso orario quando sono distribuiti su più fusi. Facoltativamente, imposta un'**ora di inizio** per programmare l'avvio e un' **ora di fine** dopo la quale la campagna si completa automaticamente. - **Chiamate simultanee** — quante chiamate questa campagna esegue contemporaneamente (1–10, valore predefinito 3). Le campagne non avviano nuove chiamate mentre la tua organizzazione ha 10 chiamate in uscita in corso, quindi le campagne parallele condividono questa capacità. Ogni chiamata conta anche ai fini del [limite di chiamate simultanee](/api-reference/introduction#call-limits) della tua organizzazione (20 per impostazione predefinita, tra chiamate in entrata, in uscita, web e di test). Quando viene raggiunto tale limite, oppure se lo stesso numero è stato chiamato negli ultimi 10 secondi, il contatto attende semplicemente un passaggio successivo; i suoi tentativi non vengono consumati. - **Tentativi massimi** — quante volte può essere chiamato ciascun contatto (1–10, valore predefinito 2). - **Attesa prima del nuovo tentativo (minuti)** — l'attesa prima di un nuovo tentativo (almeno 30, valore predefinito 60). - **Riprova in caso di** — quali esiti attivano un nuovo tentativo: **nessuna risposta**, **segreteria telefonica**, **non riuscita** (tutti attivi per impostazione predefinita). Servono più tentativi o intervalli più brevi? Contatta l'assistenza: il personale può aumentare entrambi i limiti per la tua organizzazione. Le campagne vengono create come bozze; i contatti possono essere aggiunti solo mentre una campagna è una bozza. L'avvio di una campagna richiede un consenso esplicito agli addebiti delle chiamate. Con una futura **ora di inizio**, diventa *programmata*; altrimenti inizia subito *in esecuzione*. Le campagne salvate prima di questi limiti continuano a essere eseguite esattamente come configurate. I relativi tentativi e intervalli rimangono quelli salvati anche dopo altre modifiche. ## Come funzionano gli esiti e i tentativi Dopo ogni chiamata, al contatto viene assegnato un esito: le chiamate riuscite vengono contrassegnate come completate; una chiamata classificata come senza risposta, rilevata come segreteria telefonica o non riuscita viene ritentata se tale esito è nell'elenco **ritenta su** e al contatto restano tentativi. I contatti che esauriscono i tentativi vengono contrassegnati come *esauriti*; gli errori non ritentabili vengono contrassegnati come *non riusciti*. La composizione si mette automaticamente in pausa 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 campagne lunghe. ## Monitora e controlla Ogni scheda della campagna mostra lo stato e l'avanzamento (ad esempio, "173 su 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 normalmente. 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 supera l'orario **termina alle**. Stati della campagna: `draft`, `scheduled`, `running`, `paused`, `completed`, `cancelled`. Stati del contatto: `pending`, `scheduled`, `calling`, `completed`, `failed`, `exhausted`. ## Passaggi successivi Ascolta le chiamate della campagna mentre avvengono. Effettua singole chiamate in modo programmatico.