# Limiti e orari di chiamata
Quanto spesso Voice Logica chiama la stessa persona e in quali orari. Queste regole proteggono le persone che chiamate (e la reputazione del vostro numero presso gli operatori). Valgono solo per le chiamate **in uscita**. Chi vi chiama non è mai limitato.
## Orari di chiamata
- Le chiamate in uscita partono solo tra le **09:00 e le 21:00**, nell'ora del **paese della vostra azienda**.
- Le chiamate singole (API, workflow, chiamate programmate) non partono inoltre di **sabato e domenica**.
- Una chiamata richiesta fuori da questi orari non va persa. Viene **programmata** per il primo orario consentito e l'API risponde `"scheduled": true` con `scheduleTime`.
- Le [campagne](https://docs.voicelogica.ai/it/outbound-calls/campaigns/) chiamano solo nei propri **giorni e orari di programmazione**, e mai fuori dalla fascia 09:00–21:00.
- I trasferimenti e le chiamate che una persona effettua dalle app o da un telefono fisso non sono limitati.
Le richieste API possono ignorare gli orari con `overrideTimeRestriction: true` e la regola del fine settimana con `overrideDayRestriction: true`. Chiamare di notte o nel fine settimana può violare le norme a tutela dei consumatori del vostro paese. Usatele solo per persone che hanno chiesto di essere chiamate in quel momento.
## Chiamate singole: al massimo 3 al giorno per numero
Ogni chiamata effettuata singolarmente (l'[API](https://docs.voicelogica.ai/it/outbound-calls/api/), un workflow, una chiamata programmata) è protetta **per impostazione predefinita**. Per ogni numero di telefono, al giorno:
| Regola | Limite | Se lo superate |
|---|---|---|
| Chiamate andate a buon fine | **3** | `daily_call_limit_reached` |
| Tentativi falliti (nessuna rotta, rifiutati) | **3** | `failed_call_limit_reached` |
| Intervallo tra chiamate andate a buon fine | **1 ora** | `cooldown_period_active` |
| Chiamate contemporanee allo stesso numero | **1** | `call_already_in_progress` |
- Le chiamate che la persona fa a voi non contano.
- Un richiamo chiesto dalla persona («mi chiami alle 7») avviene sempre: non è soggetto a questi limiti né al numero massimo di tentativi della campagna. Gli orari di chiamata restano validi.
- Neanche le richieste rifiutate contano.
- La giornata si azzera a **mezzanotte UTC**.
- Una richiesta rifiutata risponde HTTP 429 (409 per una chiamata già in corso), con `details.retryAfterSeconds`, `details.nextAllowedAt` e un header `Retry-After`. Attendete fino ad allora. Non reinviatela in un ciclo.
- Una richiesta API può disattivare questi limiti con `useAntiHarassmentProtection: false`. Fatelo solo per numeri vostri o per persone che si aspettano le chiamate.
## Campagne: quante volte viene chiamata una persona
Le campagne non seguono la regola delle 3 al giorno. Siete voi a decidere quanto spesso viene chiamata ogni persona della lista (ogni lead), nella scheda **Fasi** della campagna.
### Quando nessuno risponde
Aprite **Fasi** → **Quando nessuno risponde** e impostate quante volte richiamare e quanto attendere tra una chiamata e l'altra.
- «Nessuno ha risposto» significa linea occupata, segreteria, nessuna risposta o una chiamata che non si è collegata. Un numero inesistente non viene richiamato.
- I **tentativi** (da 0 a 10, predefinito **3**) sono le chiamate *dopo* la prima. 3 tentativi = fino a 4 chiamate in totale. 0 = una sola chiamata.
- **Attesa tra le chiamate:** da 1 ora a 4 settimane, predefinito **4 ore**.
### Quando qualcuno risponde
Dopo ogni chiamata con risposta, l'IA sceglie la fase che corrisponde all'esito, per esempio *Riuscito*, *Non riuscito* o *Riprova più tardi*. Una fase con **Riprova** richiama la persona più avanti. Impostate **Chiamate in questa fase** (da 1 a 10) e l'attesa (da 30 minuti a 1 settimana). **Chiamate in questa fase** comprende la chiamata che ha portato la persona nella fase. Esempio: *Riprova più tardi* impostata su 5 = fino a 4 chiamate in più, ogni 5 giorni. Chi rifiuta viene chiuso come **Annullato** e non viene più chiamato.
### Le due impostazioni condividono un limite
Nessuno viene chiamato più di **la prima chiamata + il maggiore dei due valori**: i tentativi di *Quando nessuno risponde* o il numero più alto di **Riprova**. I due valori non si sommano.
| Tentativi | Riprova più tardi | Chiamate massime per persona |
|---|---|---|
| 3 | 5 | **6** (1 + 5), non 9 |
| 3 | 2 | **4** (1 + 3) |
| 0 | 5 | **6** (1 + 5) |
Le chiamate senza risposta e quelle di *Riprova più tardi* attingono alla stessa quota. Chi non ha risposto tre volte ha meno chiamate *Riprova più tardi* disponibili. Con una fase *Riprova più tardi*, anche con 0 tentativi una persona che non risponde mai può ricevere più di una chiamata. Per chiamare di meno, riducete entrambi i valori.
### Numeri aggiuntivi e «mi chiami alle 18»
- **Più di un numero:** se il primo numero non risponde, proviamo il successivo circa un minuto dopo. Questo non consuma un tentativo; l'attesa parte quando tutti i numeri sono stati provati.
- **La persona indica un orario** («mi chiami domani alle 18»): quella chiamata avviene sempre, anche quando le chiamate sono finite, entro gli orari di chiamata e i giorni e gli orari della campagna. Conta comunque come una delle sue chiamate, quindi dopo potrebbero non restarne altre. Se ha chiesto di essere richiamata senza indicare un orario, richiamiamo dopo l'attesa impostata (2 giorni nelle campagne di appuntamenti).
- Lo strumento **Schedule Callback** è un'altra cosa: crea un'attività di richiamo per il vostro team e non effettua la chiamata della campagna. Il suo **Max callbacks per caller** (da 1 a 3) limita queste attività, non le chiamate della campagna. Vedi [Strumenti & Workflow](https://docs.voicelogica.ai/it/agent-configuration/built-in-tools/).
### Le chiamate attendono gli orari della campagna
Ogni tentativo e ogni richiamo parte solo nei giorni e negli orari del **Programma** della campagna. Se uno cade fuori, non va perso: parte alla successiva apertura. Esempio: orari 09:00–20:00, attesa di 4 ore, chiamata senza risposta alle 18:00. La chiamata successiva parte alle 09:00 del giorno di chiamata seguente.
### Modificare le impostazioni a campagna avviata
Potete modificare i tentativi, l'attesa e le fasi in qualsiasi momento. La modifica si applica in pochi secondi:
- Le persone che attendono già una chiamata a un orario preciso mantengono quell'orario. La nuova attesa vale dopo quella chiamata.
- Meno tentativi: le persone che hanno già ricevuto quel numero di chiamate non vengono più chiamate.
- Più tentativi: le persone già in **Tentativi esauriti** restano chiuse. Per richiamarle, aggiungetele di nuovo alla campagna.
### Quante volte è stata chiamata ogni persona
Nella tabella dei lead della campagna, **Tentativi di chiamata** mostra le chiamate fatte finora a ciascuna persona. Lo stato mostra **Nuovo tentativo programmato** mentre attende la chiamata successiva e **Tentativi esauriti** quando non restano chiamate. Aprite un lead per vedere ogni chiamata e la sua fase.
### Un messaggio quando le chiamate sono finite
In **Quando le chiamate sono finite**, scegliete un **SMS**, un'**email** o entrambi, e per l'SMS il mittente (**Da**: *Automatico* usa il mittente SMS del vostro agente o il mittente verificato della vostra azienda). Viene inviato **una volta** per persona, quando arriva a **Tentativi esauriti**: i richiami o il limite di chiamate di una fase sono finiti senza risultato, anche se la persona ha risposto e riattaccato. Parte negli orari di chiamata della campagna (se le chiamate finiscono la sera, parte all'apertura della fascia successiva), mai verso un numero che ha chiesto di non essere chiamato, e non se è stato fissato un appuntamento in una delle sue chiamate.
I numeri in **Allowed test numbers** della campagna ignorano tutti i limiti. Usatelo solo per i vostri telefoni durante i test.
## L'opposizione è definitiva
Quando qualcuno chiede di non essere più chiamato, il suo numero viene segnato come disiscritto (opted out):
- Nessun agente e nessuna campagna della vostra azienda lo richiama (`callee_opted_out`).
- I suoi lead nelle campagne vengono sospesi.
- Non riaggiungetelo come nuovo contatto o in una nuova campagna.
## Contatti bloccati
Bloccate un contatto in **Contatti** quando quella persona deve parlare solo con il vostro team, mai con un agente AI. Le sue chiamate verso un numero a cui risponde un agente vengono rifiutate prima che l'agente risponda (SIP 603 Decline), così il vostro operatore o centralino può inoltrarle al vostro team. Nessun agente e nessuna campagna lo chiama (`callee_opted_out`, motivo `contact_blocked`). Le chiamate instradate a un utente o a un gruppo di utenti, e quelle effettuate dal vostro team, non sono interessate. Per annullare, sbloccate il contatto.
## Domande frequenti
**L'agente può chiamare la stessa persona 10 volte in un giorno?**
Non con le chiamate singole: il limite è di 3 chiamate al giorno allo stesso numero, a 1 ora di distanza. Una campagna con 10 tentativi e 1 ora di ritardo può farlo. Impostate il ritardo in modo da distribuire le chiamate su più giorni.
**Perché la mia chiamata in uscita via API è stata programmata invece di partire?**
Era fuori dalla fascia 09:00–21:00 o in un fine settimana nel paese della vostra azienda. La chiamata parte automaticamente alla `scheduleTime` indicata nella risposta.
**Sto provando le chiamate in uscita sul mio telefono e ho raggiunto il limite. Cosa faccio?**
Aggiungete il vostro numero agli **Allowed test numbers** di una campagna, oppure inviate `useAntiHarassmentProtection: false` nelle richieste API di prova.
**Ho impostato 3 tentativi e Riprova più tardi a 5. Perché un lead è stato chiamato 6 volte?**
Una campagna con fasi ha un solo limite per lead: la prima chiamata più il maggiore dei due valori, qui 1 + 5 = 6. Contano sia le chiamate senza risposta sia i richiami di Riprova più tardi. Per chiamare meno volte, riducete anche il numero di **Riprova** della fase.
**Il lead non aveva più tentativi ma è stato chiamato lo stesso. Perché?**
La persona ha chiesto di essere richiamata a un orario preciso. Un richiamo chiesto dalla persona avviene sempre, entro gli orari di chiamata e la programmazione della campagna. Conta comunque come una delle chiamate del lead.