Skip to content

Lanciare una Campagna

Le campagne ti permettono di avviare chiamate automatiche verso una lista di contatti, con regole avanzate di scheduling e retry.

WARNING

Le campagne richiedono un'abbonamento attivo. Verifica il tuo piano nella sezione Settings → Subscription.

Accedere alle campagne

Dalla dashboard, clicca su Campaigns nella barra laterale. Qui vedrai l'elenco delle campagne esistenti con il loro stato:

StatoSignificato
DraftBozza, non ancora avviata
ScheduledProgrammata per una data futura
RunningIn esecuzione
PausedMessa in pausa
CompletedCompletata
CancelledAnnullata

Creare una campagna

La creazione di una campagna segue un processo guidato in 5 step.

Step 1: Agente e numero di origine

  1. Clicca su Crea campagna.
  2. Seleziona l'agente AI che gestirà le chiamate.
  3. Seleziona il numero di telefono di origine da cui partiranno le chiamate.

Step 2: Lista dei numeri

Inserisci i numeri da chiamare in uno dei due modi:

  • Inserimento manuale — Aggiungi i numeri uno per uno nella tabella, compilando eventuali variabili aggiuntive per ciascun contatto.
  • Upload CSV — Carica un file CSV con i numeri e le variabili. La tabella verrà compilata automaticamente.

TIP

Se l'agente usa variabili dinamiche nel prompt (es. ), puoi aggiungere colonne corrispondenti nella tabella per personalizzare ogni chiamata.

Numeri alternativi per contatto (opzionale)

Se per un contatto vuoi provare più numeri o persone (ad esempio referente e assistente della stessa azienda), puoi aggiungere numeri alternativi per quella riga:

  • Nell'interfaccia, abilita i numeri alternativi e aggiungi uno o più numeri (e variabili opzionali) per contatto.
  • Nel CSV usa suffissi _2, _3, … per il tentativo 2, 3, ecc. Esempio: phone_number, name, phone_number_2, name_2.

In caso di retry, il worker sceglie il numero di destinazione in base al tentativo: numero principale al tentativo 1, alternativi dal tentativo 2 in poi. In Regole avanzate imposta la strategia numeri alternativi quando hai meno alternativi dei tentativi totali (1 + tentativi massimi):

StrategiaComportamento
RollingRuota ciclicamente tra gli alternativi definiti
ClampUsa ogni alternativo in ordine, poi ripete l'ultimo
CustomUsa ogni alternativo una volta, poi torna al numero principale

Step 3: Mappatura variabili

Se hai inserito colonne aggiuntive nella tabella o nel CSV, mappa ciascuna colonna alla variabile corretta dell'agente:

  • Seleziona la variabile di destinazione per ogni colonna
  • Le variabili disponibili vengono estratte automaticamente dal prompt dell'agente

Step 4: Regole avanzate

Configura il comportamento della campagna:

ParametroDescrizioneDefault
Nome campagnaNome identificativo
DescrizioneDescrizione opzionale
Tentativi massimiQuante volte riprovare una chiamata fallita0
Ritardo tra tentativiMinuti di attesa tra un retry e l'altro
Giorni di chiamataGiorni della settimana in cui chiamareLun–Ven
Finestra orariaOrario di inizio e fine delle chiamate09:00–19:00
Fuso orarioTimezone di riferimento
Chiamate contemporaneeNumero massimo di chiamate parallele
Slot liberi per inboundRiserva capacità per chiamate in entrata

Se i tentativi massimi sono maggiori di zero, compaiono due opzioni aggiuntive:

Caller ID per tentativo di chiamata

Puoi usare numeri in uscita diversi per ogni tentativo (chiamata iniziale più ogni retry). Aggiungi uno o più numeri e scegli una strategia di rotazione:

StrategiaComportamento
RollingRuota i numeri (A, B, A, B…) se hai meno numeri dei tentativi
ClampUsa ogni numero in ordine, poi ripete l'ultimo
CustomAssegna un numero specifico a ogni slot di tentativo

Il worker risolve il caller ID quando accoda ogni chiamata.

Strategia numeri alternativi

Definisce come usare i numeri alternativi del contatto (step 2) quando sono meno dei tentativi totali. Stesse tre strategie della tabella sopra (rolling, clamp, custom).

Step 5: Riepilogo e conferma

  1. Rivedi il riepilogo della campagna: lista contatti, variabili mappate, regole configurate.
  2. Clicca su Crea campagna per salvarla.

La campagna verrà creata in stato Draft. Potrai avviarla manualmente o programmarla.

Gestire una campagna in corso

Dalla lista campagne puoi:

  • Avviare una campagna in bozza
  • Mettere in pausa una campagna in esecuzione
  • Riprendere una campagna in pausa
  • Annullare una campagna

Prossimo passo

Per monitorare l'andamento delle chiamate e delle campagne, consulta la guida sulle analitiche.

Replicer API Documentation