--- title: "Configurare un trunk SIP per ricevere ed effettuare chiamate" description: "Collega il tuo PBX o SBC a Bird in quest'ordine: crea il trunk, instrada le chiamate in arrivo verso i tuoi gateway, abilita le chiamate in uscita e verifica entrambe le direzioni." canonical: "https://bird.com/it-it/documentazione/guides/voice/sip-trunk-setup" --- # Configurare un trunk SIP per ricevere ed effettuare chiamate Questa pagina descrive la configurazione completa di un trunk nell'ordine richiesto dalla dashboard. Quando saltare un passaggio produce un sintomo visibile, il passaggio lo indica: puoi quindi usare la pagina anche come checklist quando una chiamata di prova non riesce. Per il significato di ogni impostazione, segui i link a [Trunk SIP](/docs/guides/voice/sip-trunks), [Ricevere chiamate](/docs/guides/voice/receiving-calls) ed [Effettuare chiamate](/docs/guides/voice/placing-calls). ## Prima di iniziare - Uno spazio di lavoro Bird. Chiamate, numeri e trunk appartengono a un unico spazio di lavoro, quindi esegui tutti i passaggi nello stesso. - Gli indirizzi pubblici dei tuoi apparati: gli host a cui Bird deve consegnare le chiamate e gli indirizzi da cui i tuoi apparati inviano SIP. - Per le chiamate in arrivo, un numero Bird in quello spazio di lavoro. Per le chiamate in uscita, un ID chiamante: un numero Bird nello spazio di lavoro o un numero che hai [verificato](/docs/guides/voice/caller-ids). - Un numero Bird il cui `status` è `active`. Un numero ancora in attesa della documentazione di titolarità o della registrazione non gestisce chiamate in arrivo né in uscita: consulta [Inviare la documentazione di titolarità di un numero](/docs/guides/numbers/ownership-paperwork). ## 1. Crea il trunk Apri **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), seleziona **Add new SIP trunk**, inserisci un nome e seleziona **Create trunk**. Un nuovo trunk non gestisce chiamate in nessuna delle due direzioni finché non le attivi singolarmente. ## 2. Attiva le chiamate in entrata In **Inbound calling**, seleziona **Enable inbound**. Sotto compare la sezione **Inbound routing**. Se salti questo passaggio, non puoi indirizzare i numeri al trunk, perché il trunk non compare nell'elenco dei trunk del numero. ## 3. Aggiungi i tuoi gateway In **Inbound routing**, apri la scheda **Gateways** e seleziona **Add gateway** per ogni indirizzo a cui Bird deve consegnare le chiamate: | Campo | Cosa inserire | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | Un'etichetta che riconosci, ad esempio `Primary SBC` | | **Host** | Il nome host o l'indirizzo IP pubblico dei tuoi apparati, senza `sip:` né una parte utente | | **Port** | Lascia vuoto per usare la porta predefinita del trasporto, oppure inserisci la porta su cui sono in ascolto i tuoi apparati | | **Transport** | UDP, TCP o TLS, in base ai tuoi apparati | | **R-URI user part** | Come viene scritto il numero chiamato nella Request-URI. Il valore predefinito è E.164 con `+` | | **Origination format** | Come viene scritto il numero chiamante. Il valore predefinito è E.164 con `+` | | **Priority** | La posizione del gateway in **All gateways (automatic)**: i numeri più bassi squillano per primi e i numeri uguali si dividono le chiamate. Il valore predefinito è 0 | Se la tua apparecchiatura si aspetta i numeri senza il `+` iniziale, apri l'elenco del formato e scegli **Without the plus**, oppure un prefisso internazionale `00` o `011`. [What a gateway needs](/docs/guides/voice/receiving-calls#what-a-gateway-needs) spiega i formati dei numeri. Bird inoltra l'intestazione `To` così come l'ha inviata l'operatore del chiamante. Se la tua apparecchiatura legge il numero chiamato da `To`, seleziona **Rewrite To user part** e imposta lo stesso formato usato per **R-URI user part**. Bird sostituisce quindi la parte utente di `To` nelle chiamate verso quel gateway. Il tuo gateway deve accettare le chiamate da Bird senza una challenge Digest SIP, perché Bird non vi risponde. ## 4. Scegli il gruppo in cui cercare le chiamate Bird consegna una chiamata a un gruppo di gateway. Ogni gateway fa parte di **All gateways (automatic)**, che li prova nell'ordine della loro **Priority** nella scheda **Gateways**, a partire dal valore più basso. Per il failover tramite questo gruppo, assegna al gateway di backup un numero di **Priority** più alto rispetto al principale. Se la scheda **Groups** non mostra **All gateways (automatic)**, il routing salvato del trunk contiene al suo posto un gruppo proprio, e **Priority** non determina l'ordine di quel gruppo; consulta [Usare il gruppo automatico](/docs/guides/voice/hunt-groups#use-the-automatic-group). Quando aggiungi il primo gateway a un trunk il cui routing non è mai stato salvato, la dashboard indirizza la route predefinita a **All gateways (automatic)**. Per tempi di squillo o pesi diversi, oppure per usare solo alcuni gateway, crea un gruppo tuo: nella scheda **Groups**, seleziona **Add group**, assegnagli un nome e usa **Add gateway to group** per ogni gateway. [Failover e distribuzione delle chiamate in arrivo](/docs/guides/voice/hunt-groups) spiega ogni ordine, il tempo di squillo e quando la ricerca si interrompe. ## 5. Indirizza la route predefinita al gruppo Nella scheda **Rules**, trova **Default route** (**No rule above matched**). Imposta **Then** su **Route to group** e scegli il tuo gruppo. Seleziona **Review and save**, poi conferma. La route predefinita gestisce ogni chiamata che non corrisponde a nessuna regola, quindi, in assenza di regole, gestisce tutte le chiamate. Se è impostata su **Reject**, quelle chiamate vengono rifiutate prima di raggiungere i tuoi apparati, anche se ci sono gateway in un gruppo. Nella revisione, la dashboard mostra l'avviso **Calls never reach some gateways** quando un gateway non appartiene a nessun gruppo a cui una regola o la route predefinita inviano chiamate. Risolvi questo avviso prima di fare il test. Questa route predefinita appartiene al trunk. È distinta dall'impostazione dello spazio di lavoro **Calls to numbers without their own route** nella pagina **Numbers**, che stabilisce cosa succede ai numeri senza una route propria. ## 6. Indirizza i tuoi numeri al trunk Apri **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), apri il numero e in **Inbound routing** scegli **Deliver to a SIP trunk**. Seleziona il trunk e salva. Un numero senza una route propria segue la route predefinita dello spazio di lavoro, che inizialmente rifiuta le chiamate. Per inviare tutti questi numeri a questo trunk in una volta sola, imposta **Calls to numbers without their own route** sul trunk. Consulta [Impostare una route predefinita](/docs/guides/voice/receiving-calls#set-a-default-route). Se salti questo passaggio mentre la route predefinita dello spazio di lavoro è ancora impostata sul rifiuto, le chiamate in entrata vengono rifiutate e il campo **Inbound route** del record della chiamata mostra **Reject the leg**. ## 7. Attiva le chiamate in uscita e indica chi può inviarle In **Outbound calling**, seleziona **Enable outbound**. Compare la sezione **Connection** con il **SIP domain** del trunk. Bird identifica il tuo trunk tramite questo dominio, quindi copialo per intero. Poi aggiungi almeno un modo per riconoscere i tuoi apparati: - **Allowed IP addresses**: gli indirizzi pubblici da cui i tuoi apparati inviano SIP. Dietro NAT, usa l'indirizzo pubblico del router. - **Allowed API keys**: per gli apparati che rispondono a una richiesta Digest, con nome utente `bird` e il segreto di una chiave API come password. Finché le chiamate in uscita non sono attive, il trunk rifiuta ogni chiamata in uscita. Finché il trunk non riesce a riconoscere i tuoi apparati, le chiamate vengono rifiutate prima che esista un record di chiamata. Consulta [Controllare chi può inviare chiamate](/docs/guides/voice/sip-trunks#controlling-who-may-send-calls). ## 8. Configura il tuo PBX o SBC Sul tuo PBX o SBC: - **Invia le chiamate in uscita al dominio SIP del trunk.** Inserisci il dominio SIP come host della Request-URI. Usa la porta `5060` (UDP o TCP) oppure `5061` (TLS). Una chiamata con qualsiasi altro nome come host della Request-URI viene rifiutata. - **Componi in formato internazionale.** Inserisci il numero chiamato nella parte utente della Request-URI con `+` e il prefisso del paese, ad esempio `+442071234567`. Non aggiungere un prefisso tecnico. Consulta [Cosa si aspetta Bird nell'INVITE](/docs/guides/voice/placing-calls#what-bird-expects-on-the-invite). - **Presenta un ID chiamante idoneo** nell'intestazione `From`. - **Offri G.711** (A-law o µ-law) e invia i DTMF come eventi telefonici RFC 4733. La stessa sezione di quella pagina tratta i flussi audio. - **Consenti gli indirizzi di Bird.** Se il tuo firewall o SBC accetta solo indirizzi in elenco, consenti gli indirizzi di segnalazione e dei flussi audio della regione del tuo trunk, elencati in [Requisiti di rete dei trunk SIP](/docs/guides/voice/network-requirements). ## 9. Attiva i paesi che chiami Apri **Voice** > [**Destinations**](https://bird.com/dashboard/w/voice/destinations), seleziona ogni paese che chiami e seleziona **Save changes**. Un nuovo spazio di lavoro parte senza paesi abilitati, e una chiamata verso un paese disabilitato viene rifiutata con `destination_not_enabled`. Consulta [Destinazioni vocali](/docs/guides/voice/destinations). ## 10. Verifica entrambe le direzioni 1. **In entrata:** chiama il tuo numero Bird da un telefono qualsiasi, poi apri **Voice** > [**Legs**](https://bird.com/dashboard/w/voice/legs) nello stesso spazio di lavoro. 2. **In uscita:** effettua una chiamata dalla tua apparecchiatura verso un qualsiasi numero raggiungibile in un paese abilitato, presentando come ID chiamante il tuo numero Bird o un numero verificato. Per questo non ti serve un secondo numero Bird. 3. Apri ogni leg. **Inbound route** indica cosa era impostato per il numero. Una chiamata rifiutata mostra il motivo e, quando la soluzione è una tua impostazione, un link a quell'impostazione. Una chiamata riuscita mostra **Answered**. Annota il **Leg ID** se contatti l'assistenza. Se una chiamata manca, viene rifiutata o non raggiunge mai la tua apparecchiatura, segui [Risoluzione dei problemi vocali](/docs/guides/voice/troubleshooting), che parte dal sintomo. ## Passaggi successivi | Pagina | Argomenti trattati | | --------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | [Trunk SIP](/docs/guides/voice/sip-trunks) | Tutte le impostazioni del trunk, l'autenticazione e Digest | | [Ricevere chiamate](/docs/guides/voice/receiving-calls) | Route dei numeri, gateway, gruppi e route predefinita dello spazio di lavoro | | [Effettuare chiamate](/docs/guides/voice/placing-calls) | Che cosa si aspetta Bird nella `INVITE` | | [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)