> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Campagne > **Info** > > Le chiamate in uscita sono regolamentate in modo diverso a seconda del Paese, dello Stato e del settore, quindi gli orari > e i limiti di tentativi appropriati dipendono da chi chiami e dal motivo. Sei responsabile della conformità > delle chiamate in uscita, inclusi i consensi, ciò che dice l'agente e la gestione dei passaggi successivi, nonché dell'impostazione > di limiti conformi alle norme vigenti nel luogo in cui vivono i tuoi contatti. Consulta i [Termini di ElevenAgents](https://elevenlabs.io/agents-terms) e le [linee guida TCPA](/docs/it/eleven-agents/legal/tcpa) > per i dettagli. ## Panoramica Le campagne gestiscono le comunicazioni in uscita per i tuoi agenti. Invi un elenco di destinatari e la campagna li contatta tramite tentativi, richiamate, reindirizzamenti e fasce orarie di chiamata finché ogni destinatario non raggiunge un esito finale da te definito. Le campagne sostituiscono le chiamate in batch. ### A cosa servono le campagne Usa le campagne per attività di contatto che richiedono più di una chiamata: * **Follow-up basati sulla conversazione.** Un destinatario chiede di essere richiamato alle 16:00 oppure di provare il numero di un collega. La campagna legge l'analisi della chiamata e pianifica la chiamata successiva appropriata. * **Fasce orarie di chiamata.** Le chiamate vengono effettuate esclusivamente nelle fasce da te definite, valutate nel fuso orario specificato. L'unica eccezione è una richiamata all'orario richiesto dal destinatario, che viene effettuata in quel momento. * **Persistenza limitata.** Le chiamate non riuscite o senza risposta vengono ritentate secondo una pianificazione, fino ai limiti da te controllati. * **Visibilità per gli operatori.** Puoi vedere ogni destinatario, ogni chiamata e il motivo di ogni decisione; inoltre puoi mettere in pausa o annullare in qualsiasi momento. ## Policy della campagna La policy di una campagna definisce quanto è persistente e quando può chiamare. Imposti una policy predefinita per il tuo workspace e ogni campagna ne acquisisce un'istantanea al momento della creazione. Le modifiche successive alla policy del workspace influiscono solo sulle campagne create in seguito. ```json { "policy": { "timezone": "America/New_York", "retry": { "retry_delay_seconds": 600, "max_short_retries": 1, "max_total_calls": 6, "max_callbacks": 2, "max_redirects": 2, "interval_placement": "start" }, "calling_periods": [ { "weekdays": [0, 1, 2, 3, 4], "intervals": [ { "start": "10:00", "end": "12:00" }, { "start": "16:00", "end": "18:00" } ] } ], "data_collection": { "callback_time": "__system_data_collection_callback_time", "redirect_phone_number": "__system_data_collection_redirect_phone_number", "stop": "__system_data_collection_do_not_call" } } } ``` ### Limiti dei tentativi | Campo | Descrizione | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `retry_delay_seconds` | Ritardo prima di un breve nuovo tentativo dopo una chiamata non riuscita, senza risposta o che ha raggiunto la segreteria telefonica. | | `max_total_calls` | Limite massimo assoluto di tentativi per destinatario, inclusa la prima chiamata. Un destinatario non viene mai chiamato più di questo numero di volte. Predefinito 6, massimo 30. | | `max_short_retries` | Brevi tentativi consentiti in ciascuna fascia oraria di chiamata prima che il tentativo venga spostato alla fascia successiva. | | `max_callbacks`, `max_redirects` | Limiti massimi di richiamate e reindirizzamenti che un destinatario può richiedere. I budget per tentativi e richiamate vengono reimpostati per numero quando una chiamata viene reindirizzata. | | `max_consecutive_failures_per_number` | Facoltativo. Numero di insuccessi consecutivi su un numero prima che il destinatario passi al numero successivo registrato (fino a cinque per destinatario), oppure termini se non ce ne sono altri. | | `interval_placement` | Posizione di una chiamata quando viene spostata in una fascia futura: all'inizio della fascia, in un momento casuale al suo interno oppure a rotazione per evitare orari in cui ci sono già stati insuccessi. | ### Fasce orarie di chiamata `calling_periods` definisce le fasce settimanali in cui è possibile effettuare chiamate. I giorni della settimana sono numerati da 0 a 6, dove lunedì è 0. Gli orari sono nel formato locale `HH:MM` nel `timezone` della policy e gli intervalli dello stesso giorno della settimana non possono sovrapporsi. Le richiamate a un orario preciso sono l'unica eccezione. Quando un destinatario chiede di essere richiamato a un'ora specifica, la chiamata viene effettuata a quell'ora, anche se è al di fuori delle tue fasce. Imposta max_callbacks tenendo conto di questo aspetto. Una policy ha un unico `timezone`. Se i tuoi contatti si trovano in più fusi orari, crea una campagna separata per ogni fuso, con il proprio `timezone` e le proprie fasce orarie di chiamata, così ogni chiamata avverrà durante gli orari consentiti nel luogo in cui vive il destinatario. ### Mappatura delle variabili dinamiche Con un clic, le campagne collegano gli elementi predefiniti di raccolta dati al tuo agente, abilitando richiamate, reindirizzamenti e l'interruzione delle chiamate. Puoi anche mappare risultati di analisi aggiuntivi nelle [variabili dinamiche](/docs/it/eleven-agents/customization/personalization/dynamic-variables) per le chiamate di follow-up, così un tentativo o una richiamata può iniziare da ciò che è stato appreso nella chiamata precedente. ### Contesto di follow-up Fai riferimento a queste variabili nel prompt dell'agente per rendere continue le richiamate. | Variabile | Contiene | | ------------------------------------ | --------------------------------------------------------------------------------------- | | `campaign__call_type` | Se la chiamata è un primo contatto, un tentativo, una richiamata o un reindirizzamento. | | `campaign__previous_conversation_id` | L'ID della conversazione precedente con il destinatario. | | `campaign__previous_summary` | Il riepilogo della conversazione precedente. | | `campaign__previous_transcript` | La trascrizione della conversazione precedente. | ## Canali | Canale | Modalità | Note | | -------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Telefono | Voce | Comportamento completo per tentativi, richiamate e reindirizzamenti. | | WhatsApp | Voce | Viene inviata una singola richiesta di autorizzazione per destinatario, seguita da tentativi e richiamate. Consulta [WhatsApp in uscita](/docs/it/eleven-agents/whatsapp/outbound). | | WhatsApp | Testo | Invia a ciascun destinatario un template di messaggio WhatsApp approvato. I tentativi non si applicano. Consulta [WhatsApp in uscita](/docs/it/eleven-agents/whatsapp/outbound). | I canali email e SMS saranno disponibili a breve. ## Crea una campagna #### Apri Campagne Nella navigazione di ElevenAgents, seleziona **Campagne**. #### Salva la policy del workspace Apri **Impostazioni**, definisci il fuso orario, i limiti di tentativi e le fasce orarie di chiamata, quindi salva. Consulta [Policy della campagna](#campaign-policy). #### Crea la campagna Seleziona **Nuova campagna**, scegli un agente, un canale e un numero di telefono, quindi carica i destinatari. Carica un CSV oppure invia i destinatari tramite l'API con la stessa struttura della richiesta di una chiamata in batch. Ogni destinatario può avere fino a cinque numeri di telefono (`phone_number` fino a `phone_number_5` nel CSV). #### Abilita le funzionalità avanzate Attiva **Controlli avanzati** per abilitare tentativi, richiamate e follow-up nelle fasce orarie di chiamata specificate. Queste impostazioni verranno propagate automaticamente dalle impostazioni del workspace, oppure puoi modificarle qui per ogni campagna. #### Monitora l'avanzamento Segui l'avanzamento nella scheda **Analytics**. Le chiamate vengono messe in coda quando crei una campagna ed effettuate non appena rientrano in una fascia oraria di chiamata. > **Warning** > > Le campagne non sono disponibili per workspace o agenti che usano la [Modalità di conservazione zero](/docs/it/eleven-agents/customization/privacy/zrm). Le decisioni di follow-up dipendono da uno stato persistente delle chiamate > e dall'analisi delle conversazioni, pertanto le richieste dai workspace con conservazione zero e gli invii per > agenti con conservazione zero vengono rifiutati. ## Concorrenza Le chiamate delle campagne concorrono ai limiti di concorrenza del workspace e dell'agente. Per impostazione predefinita, una campagna usa il minore tra il 50% della concorrenza del workspace e il 70% della concorrenza dell'agente. Puoi impostare un limite inferiore per una singola campagna. ## API La creazione, la gestione e le analisi delle campagne sono disponibili tramite l'API di ElevenLabs, che ti consente di integrare le campagne nei workflow e nelle applicazioni esistenti. Consulta il [Riferimento API](/docs/it/api-reference/introduction) per gli endpoint disponibili. ## Best practice * **Inizia in piccolo.** Prima di estendere la campagna all'intero pubblico, esegui un test con un elenco breve e un valore `max_total_calls` prudente. * **Imposta le fasce con attenzione.** Le fasce orarie di chiamata sono il tuo principale controllo per rispettare gli orari locali. Imposta `timezone` in base alla posizione dei destinatari e mantieni le fasce ben entro gli orari consentiti. * **Raccogli i segnali di follow-up.** Le campagne gestiscono richiami, reindirizzamenti e richieste di non essere chiamati soltanto se l'agente li acquisisce. Indica all'agente nel prompt quando registrare ciascuno di essi. * **Usa il contesto di follow-up.** Fai riferimento a `campaign__previous_summary` nel prompt affinché un tentativo o una richiamata riprenda dal punto in cui si è conclusa l'ultima chiamata, anziché ripetere l'apertura. * **Mantieni bassi i limiti.** La persistenza ha un costo sia per i destinatari sia per te. Preferisci pochi tentativi ben programmati a molti tentativi. ## Domande frequenti #### Posso modificare la policy di una campagna in corso? No. La policy di una campagna è fissa al momento della creazione. Le modifiche alla policy del workspace si applicano alle campagne create in seguito. Per modificare una campagna in corso, interrompila e creane una nuova. #### Un destinatario può essere incluso in più campagne? Ogni campagna tiene traccia dei propri lead e lo stato di non contattare appartiene alla campagna. Deduplica i destinatari tra le campagne prima di crearle se devi evitare di contattare due volte la stessa persona. ## Passaggi successivi * [Raccolta dati](/docs/it/eleven-agents/customization/agent-analysis/data-collection): acquisisci i segnali su cui agisce il tuo agente. * [Variabili dinamiche](/docs/it/eleven-agents/customization/personalization/dynamic-variables): personalizza la chiamata di ogni destinatario. * [Guardrail](/docs/it/eleven-agents/best-practices/guardrails): fai sì che il tuo agente in uscita resti pertinente e coerente con il brand.