Sign inGet Started

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, Ricevere chiamate ed Effettuare chiamate.

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.
  • 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.

1. Crea il trunk

Apri 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:

CampoCosa inserire
NameUn'etichetta che riconosci, ad esempio Primary SBC
HostIl nome host o l'indirizzo IP pubblico dei tuoi apparati, senza sip: né una parte utente
PortLascia vuoto per usare la porta predefinita del trasporto, oppure inserisci la porta su cui sono in ascolto i tuoi apparati
TransportUDP, TCP o TLS, in base ai tuoi apparati
R-URI user partCome viene scritto il numero chiamato nella Request-URI. Il valore predefinito è E.164 con +
Origination formatCome viene scritto il numero chiamante. Il valore predefinito è E.164 con +
PriorityLa 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 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.

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 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, 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.

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.

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.
  • 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.

9. Attiva i paesi che chiami

Apri 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.

10. Verifica entrambe le direzioni

  1. In entrata: chiama il tuo numero Bird da un telefono qualsiasi, poi apri 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, che parte dal sintomo.

Passaggi successivi

PaginaArgomenti trattati
Trunk SIPTutte le impostazioni del trunk, l'autenticazione e Digest
Ricevere chiamateRoute dei numeri, gateway, gruppi e route predefinita dello spazio di lavoro
Effettuare chiamateChe cosa si aspetta Bird nella INVITE
Risoluzione dei problemi vocaliDiagnosticare una chiamata a partire dal sintomo

Continua con la documentazione, le guide e gli esempi per questo argomento.