--- title: "Failover e ripartizione delle chiamate in entrata tra i tuoi gateway" description: "Usa gli hunt group su un trunk SIP per inviare le chiamate in entrata a un gateway di backup quando il primo non risponde, oppure per ripartire le chiamate tra i gateway in base al peso." canonical: "https://bird.com/it-it/documentazione/guides/voice/hunt-groups" --- # Failover e ripartizione delle chiamate in entrata tra i tuoi gateway Il routing di un trunk SIP decide cosa succede a ogni chiamata in entrata: cercare in un gruppo dei tuoi gateway, rifiutare la chiamata o inoltrarla a un numero verificato. Un hunt group è un elenco di gateway che Bird prova uno dopo l'altro finché uno risponde. Ordine, priorità, pesi e tempi di squillo del gruppo decidono quale gateway squilla per primo e cosa succede se non risponde. Questa pagina mostra come configurarli per il failover e per la ripartizione del carico. ## Prima di iniziare - Un trunk SIP con le chiamate in entrata attive e almeno un gateway. [Configurare un trunk SIP](/docs/guides/voice/sip-trunk-setup) spiega entrambe le cose. Quando aggiungi il primo gateway a un trunk il cui routing non è mai stato salvato, la dashboard indirizza la route predefinita su **All gateways (automatic)**, il gruppo che contiene tutti i gateway del trunk. - I gateway che vuoi combinare, aggiunti nella scheda **Inbound routing** > **Gateways** del trunk. ## Come funziona la ricerca in un gruppo Ogni chiamata in entrata avvia una ricerca. Bird ordina i gateway del gruppo per quella chiamata, fa squillare il primo e passa al successivo quando fallisce: - Un gateway squilla per il suo **Ring time**, da 1 a 120 secondi (30 per impostazione predefinita). Se nessuno risponde in quel tempo, Bird passa oltre. - Un gateway che non invia alcuna risposta viene saltato dopo un breve intervallo, così un gateway non attivo non tiene in attesa il chiamante per tutto il suo tempo di squillo. - Se un gateway rifiuta la chiamata con un codice di errore SIP, la ricerca passa al gateway successivo, a meno che quel codice non sia elencato in **Stop the hunt on** del gruppo. - La ricerca termina quando un gateway risponde o quando sono stati provati tutti i gateway del gruppo. Bird ordina ogni chiamata in modo indipendente e non mantiene alcuna rotazione tra una chiamata e l'altra, quindi non esiste il round-robin. Una distribuzione uniforme si ottiene dall'ordine casuale o ponderato su molte chiamate. | Ordine | Come ordina i gateway per ogni chiamata | Quando usarlo | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | | **Sequential** | L'ordine dell'elenco, dall'alto verso il basso | Un gateway principale fisso con gateway di riserva | | **Random** | Un nuovo ordine casuale | Distribuire le chiamate in modo uniforme | | **Weighted** | Prima la **Priority** più bassa. A parità di priorità, un ordine casuale in cui la probabilità di ogni gateway di essere il primo corrisponde alla sua quota sul totale dei pesi | Failover e distribuzione ponderata insieme | ## Usare il gruppo automatico Ogni gateway di un trunk fa parte di **All gateways (automatic)**, a meno che il routing salvato del trunk non contenga al suo posto un gruppo proprio (vedi la fine di questa sezione). Un gateway che aggiungi o rimuovi entra o esce automaticamente dal gruppo. Il gruppo usa l'ordine **Weighted**, pesi uguali e un tempo di squillo di 30 secondi, e prova i gateway nell'ordine della **Priority** impostata nella scheda **Gateways**. Nel gruppo stesso non puoi modificare nome, **Order**, tempi di squillo e membri. Per il failover tramite questo gruppo, assegna al gateway principale una **Priority** più bassa di quella del backup nella scheda **Gateways**. I gateway con la stessa **Priority** si dividono le chiamate in modo uniforme. Per tempi di squillo, pesi o codici **Stop the hunt on** diversi, aggiungi un gruppo tuo con gli stessi gateway, come mostrano le sezioni successive. Un gruppo chiamato **All gateways** creato dalla dashboard quando hai aggiunto il primo gateway è un gruppo tuo: contiene solo i gateway con cui è stato salvato. Se la scheda **Groups** non mostra **All gateways (automatic)**, il routing salvato del trunk contiene al suo posto un gruppo proprio, di solito chiamato **All gateways**. Se lo elimini, al suo posto torna il gruppo automatico: le chiamate che andavano a quel gruppo fanno quindi squillare tutti i gateway, in ordine di **Priority** e con un tempo di squillo di 30 secondi. Mantienilo se contiene i gateway, i tempi di squillo o i codici **Stop the hunt on** che ti servono. ## Configurare il failover 1. Apri **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), apri il trunk e vai su **Inbound routing** > **Groups**. 2. Apri un gruppo tuo oppure seleziona **Add group** e assegnagli un nome. **All gateways (automatic)** non è modificabile. 3. Aggiungi il gateway principale e quello di backup con **Add gateway to group**. 4. Imposta **Order** su **Sequential** e mantieni il gateway principale in cima all'elenco con **Move up** e **Move down**. In alternativa, imposta **Order** su **Weighted** e assegna **Priority** 1 al gateway principale e **Priority** 2 a quello di backup. 5. Imposta la **Ring time** di ogni gateway. Con una durata di squillo più breve sul gateway principale, le chiamate senza risposta passano prima al backup. 6. Nella scheda **Rules**, imposta il campo **Then** della **Default route** su **Route to group** e scegli il gruppo, oppure indirizza una regola verso di esso. Un gruppo che nessuna route usa non riceve chiamate. 7. Seleziona **Review and save**, poi conferma. ## Distribuire le chiamate tra i gateway 1. Apri **Inbound routing** > **Groups** del trunk. Apri un gruppo tuo oppure seleziona **Add group**, assegnagli un nome e aggiungi i gateway con **Add gateway to group**. 2. Imposta **Order** su **Weighted**, assegna ai gateway la stessa **Priority** e imposta per ciascuno un **Weight** da 1 a 100. Con pesi di 70 e 30, circa il 70% e il 30% delle chiamate vanno ai rispettivi gateway. Per una distribuzione uniforme, usa pesi uguali oppure imposta **Order** su **Random**. 3. Per mantenere anche un gateway di backup, assegna **Priority** 1 ai gateway che si dividono le chiamate e **Priority** 2 al backup. Il backup squilla solo quando tutti i gateway con priorità 1 non sono riusciti a rispondere. 4. Nella scheda **Rules**, imposta il campo **Then** della **Default route** su **Route to group** e scegli il gruppo, oppure indirizza una regola verso di esso. 5. Seleziona **Review and save**, poi conferma. ## Interrompere la ricerca con il segnale di occupato Se non modifichi questo comportamento, Bird prova il gateway successivo a ogni errore. Quando un errore indica che un altro gateway non servirebbe, inserisci il relativo codice nel campo **Stop the hunt on** del gruppo. Ad esempio, aggiungi `486` (Busy Here), così una persona già impegnata in una chiamata non viene chiamata di nuovo tramite un secondo gateway. Puoi inserire qualsiasi codice da 400 a 699. ## Instradare chiamate diverse verso gruppi diversi Un trunk può avere più gruppi. La **Default route** invia a un gruppo le chiamate che non corrispondono a nessuna regola, mentre le regole nella scheda **Rules** possono inviare altre chiamate ad altri gruppi. [Consegnare le chiamate a un trunk SIP](/docs/guides/voice/receiving-calls#deliver-calls-to-a-sip-trunk) spiega le regole e la route predefinita. ## Risoluzione dei problemi | Cosa succede | Cosa controllare | | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Il backup non squilla mai | Il backup deve trovarsi nel gruppo usato dalla route predefinita (o dalla regola corrispondente). Con **Weighted**, il suo numero di **Priority** deve essere più alto di quello del primario. Un codice in **Stop the hunt on** interrompe la ricerca prima di arrivare al backup | | Con **Weighted** un solo gateway riceve tutte le chiamate | I gateway con priorità diverse non si dividono le chiamate. Assegna loro la stessa **Priority** | | Le chiamate squillano troppo a lungo prima di arrivare al gateway di backup | Riduci il **Ring time** del gateway principale | | Un gateway non squilla mai | Il gateway non fa parte di nessun gruppo usato da una regola o dalla route predefinita. Quando salvi, la dashboard mostra l'avviso **Calls never reach some gateways** | ## Passaggi successivi | Pagina | Argomento | | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | [Configurare un trunk SIP](/docs/guides/voice/sip-trunk-setup) | La configurazione completa di un trunk nell'ordine giusto, dalla creazione a una chiamata di prova | | [Ricevere chiamate](/docs/guides/voice/receiving-calls) | Route dei numeri, regole, route predefinita e chiamate rifiutate | | [Risoluzione dei problemi vocali](/docs/guides/voice/troubleshooting) | Diagnosticare una chiamata a partire dal sintomo | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/voice-api) (product) - [Voice overview](/docs/guides/voice/overview) (docs) [Get an implementation brief](/learn/workspace?topic=voice)