# Campaigner Il Campaigner ti permette di creare e gestire campagne automatizzate di chiamate in uscita: pianifica chiamate in blocco verso le tue liste di contatti e lascia che i tuoi agenti IA configurati le lavorino. > **Prerequisiti:** Il tuo piano deve includere le [chiamate in uscita](https://docs.voicelogica.ai/it/outbound-calls/), ti serve almeno un [agente IA](https://docs.voicelogica.ai/it/getting-started/your-first-agent/) e un [telefono o SIP trunk](https://docs.voicelogica.ai/it/telephony/introduction/) da cui chiamare — la pagina Campaigns ti segnala se manca ancora un SIP trunk o un agente. ## Creare una campagna 1. **Avvia una nuova campagna** Apri la [pagina Campaigns](https://app.voicelogica.ai/campaigns) e fai clic su **"New Campaign"**. ![Pagina Campaigns](https://docs.voicelogica.ai/assets/outbound-calls/campaign-list.png) 2. **Configura le impostazioni di base** Dai alla campagna un **nome** descrittivo (e una descrizione facoltativa), scegli l'**agente IA** che parlerà — i suoi prompt e la sua voce si applicano a ogni chiamata — e il **telefono** usato per effettuare le chiamate, cioè il caller ID che i destinatari vedono. La maggior parte dei campi ha valori predefiniti sensati che puoi regolare in seguito. 3. **Imposta le proprietà di analisi** Le **Agent Analysis Properties** definiscono quali dati strutturati vengono estratti da ogni chiamata risposta — fai clic su **Manage Properties** per personalizzare i dati da raccogliere. I risultati compaiono nelle analitiche della campagna. ![Proprietà di analisi dell'agente](https://docs.voicelogica.ai/assets/outbound-calls/agent-analysis-properties.png) 4. **Configura i tentativi e la pianificazione** Imposta il **numero massimo di tentativi** e il **ritardo tra i tentativi** per le chiamate senza risposta. Nella scheda **Schedule**, imposta il ritmo (l'intervallo **"Run next calls in campaign every"**), il **fuso orario** (per impostazione predefinita quello della tua azienda) e uno o più **giorni di pianificazione**, ciascuno con orari operativi (formato 24 ore, ad es. 09:00–20:00). Le chiamate vengono effettuate solo dentro quelle finestre — così resti conforme e chiami a orari locali ragionevoli. ![Pianificazione della campagna](https://docs.voicelogica.ai/assets/outbound-calls/campaign-schedule.png) > **Le campagne girano solo da Active:** Una campagna nasce come **Draft**. Imposta il suo stato su **Active** perché le chiamate inizino — puoi metterla in **Pause** in qualsiasi momento, e si completa automaticamente quando la lista è esaurita. ## Aggiungere i lead Una volta salvata la campagna, aggiungi i contatti che il tuo agente chiamerà. Il percorso più rapido è il template di Google Sheets: 1. **Apri il template e crea la tua copia** Nella sezione **Leads** della campagna fai clic su **"Open Template"**, poi in Google Sheets fai clic su **"USE TEMPLATE"** per copiarlo nel tuo Drive. ![Aggiungi nuovi lead](https://docs.voicelogica.ai/assets/outbound-calls/new-leads.png) ![Usa il template](https://docs.voicelogica.ai/assets/outbound-calls/use-template.png) 2. **Compila le tue colonne** Le colonne **`phone`** ed **`email`** del template sono obbligatorie — non eliminarle. Tutto il resto è a tua discrezione: togli `client_name`/`client_last_name` se non li usi, o aggiungi colonne personalizzate (`company`, `appointment_date`, `previous_interaction`, …) — ogni colonna personalizzata diventa una **variabile dinamica** che il tuo agente può usare. ![Colonne del template](https://docs.voicelogica.ai/assets/outbound-calls/leads.png) 3. **Copia le righe — inclusa la riga di intestazione** Seleziona i tuoi lead **insieme alla prima riga** (i nomi delle colonne) e copia. ![Copia i lead con l'intestazione](https://docs.voicelogica.ai/assets/outbound-calls/copy-leads.png) 4. **Incolla in Voice Logica e conferma** Incolla nell'area dei lead, controlla la tabella di anteprima e fai clic su **"Add Leads"**. I lead compaiono nella tabella della campagna, pronti per essere chiamati secondo la pianificazione. ![Incolla i lead](https://docs.voicelogica.ai/assets/outbound-calls/paste-leads.png) ![Rivedi e aggiungi i lead](https://docs.voicelogica.ai/assets/outbound-calls/add-leads.png) ![Tabella dei lead della campagna](https://docs.voicelogica.ai/assets/outbound-calls/campaign-leads.png) ## Personalizzare le chiamate con le variabili dinamiche Le tue colonne di lead personalizzate diventano **variabili dinamiche** per le istruzioni dell'agente — a ogni chiamata vengono sostituiti automaticamente i valori di quel lead: ``` You are calling {{client_name}} {{client_last_name}} about their {{appointment_date}} appointment. ``` Le variabili disponibili compaiono nell'interfaccia della campagna dopo l'importazione dei lead. ![Variabili dinamiche nelle istruzioni dell'agente](https://docs.voicelogica.ai/assets/outbound-calls/calling-lead.png) ## Rivedere i risultati Dopo una chiamata risposta, le proprietà di analisi vengono popolate con i dati estratti dalla conversazione — le chiamate senza risposta seguono invece le tue impostazioni di ripetizione. ![Risultati dell'analisi dopo una chiamata](https://docs.voicelogica.ai/assets/outbound-calls/after-call.png) Per regolare **cosa** viene estratto, apri l'editor dell'agente e vai su **After the call → Call results** — le proprietà di analisi configurate lì guidano l'estrazione. ## Risoluzione dei problemi **La mia campagna non effettua alcuna chiamata** - Lo stato deve essere **Active** — una Draft non parte mai. - Controlla di essere dentro una finestra di giorno/orario pianificata (e nel fuso orario giusto). - Verifica che il piano includa le chiamate in uscita e che il tuo account telefonico abbia crediti. **Le proprietà di analisi tornano vuote** Le proprietà vengono estratte solo dalle chiamate **risposte**. Per chiamate risposte con risultati vuoti, rivedi le definizioni delle proprietà nella scheda **After the call → Call results** dell'agente.