Effettuare chiamate

Per effettuare una chiamata, il tuo PBX invia un INVITE SIP al dominio SIP del trunk. Bird controlla la richiesta, la instrada verso un operatore e inoltra l'audio. Questa pagina descrive i prerequisiti, i campi della richiesta, l'autenticazione e il costo.

Per avviare una chiamata dalla tua applicazione tramite HTTP, usa la guida alla creazione di chiamate. Questo metodo esegue una sequenza Bird pubblicata dopo la risposta.

Prima di effettuare una chiamata

La guida Configurare un trunk SIP descrive in ordine l'intera configurazione di un trunk, per entrambe le direzioni.

Devono essere pronti quattro elementi, in qualsiasi ordine. Tre di questi vanno configurati da te:

• Un trunk che accetti il tuo traffico. Crea un trunk SIP e abilita le chiamate in uscita. Aggiungi gli intervalli IP della tua apparecchiatura, una chiave API consentita o entrambi. I client che non possono conservare un segreto a lunga durata possono usare una credenziale di sessione.
• Un ID chiamante idoneo. Usa un numero Bird assegnato a questo spazio di lavoro oppure registra un numero esterno e completa la relativa chiamata di verifica. La verifica non garantisce la consegna end-to-end del CLI né la connessione della chiamata quando il CLI non è un numero acquistato tramite Bird: consulta l'esclusione di responsabilità sulla verifica e sulla consegna del CLI.
• Il paese di destinazione abilitato. Abilita i paesi che servi nella pagina Destinations.
• L'instradamento associato al tuo spazio di lavoro. Bird lo configura per te, scegliendo quali operatori servono le varie destinazioni. Finché non è configurato, le chiamate vengono rifiutate con routing_not_configured, uno dei motivi descritti in Chiamate rifiutate.

Cosa si aspetta Bird nell'INVITE

Invia la richiesta al dominio SIP del tuo trunk su una delle porte supportate. Bird legge tre parti della richiesta:

Scrivi i numeri nel formato internazionale E.164, con un + iniziale seguito dal prefisso internazionale e dal numero nazionale. Bird accetta anche lo stesso numero con 00 al posto di +, oppure come sole cifre a partire dal prefisso internazionale. Bird interpreta le cifre senza + o 00 come se iniziassero con un prefisso internazionale, quindi un numero in formato nazionale non viene interpretato come il numero desiderato. Non aggiungere un prefisso tecnico al numero chiamato.

A parte questi requisiti, si tratta di una normale chiamata SIP e non devi inviare alcuna intestazione personalizzata.

Includi G.711, A-law o µ-law, nell'offerta SDP. Invia i toni della tastiera (DTMF) come eventi telefonici RFC 4733. Bird rimuove gli altri codec, come G.729 o Opus, dall'offerta che invia all'operatore, quindi includi G.711 in ogni offerta.

I flussi multimediali usano RTP senza crittografia. SRTP non è supportato. TLS sulla porta 5061 crittografa la segnalazione, mentre l'audio rimane non crittografato.

Autenticazione di ogni chiamata

I passaggi di una chiamata dipendono da come è configurato l'accesso al trunk:

• Solo lista di indirizzi IP consentiti. Una sola richiesta. Bird confronta l'indirizzo di origine con la lista e instrada la chiamata, senza richiedere una risposta di autenticazione.
• Solo chiavi API consentite. Bird richiede prima una password per la chiamata, tramite lo scambio Digest SIP.
• Entrambi. Le chiamate che usano una chiave API consentita devono anche provenire da un indirizzo presente nella lista. Le credenziali di sessione abilitate offrono il percorso di accesso separato descritto di seguito.
• Credenziali di sessione abilitate. Bird richiede l'autenticazione della chiamata indipendentemente dalla sua provenienza, anche da un indirizzo non incluso nella lista degli indirizzi consentiti. La risposta usa una credenziale emessa pochi minuti prima. Le apparecchiature già ammesse dalla lista su un trunk senza chiavi consentite continuano a connettersi senza richiesta di autenticazione.

Se il trunk ha chiavi API consentite, il tuo sistema telefonico risponde con un hash del segreto della chiave API anziché con il segreto stesso. È così che funziona l'autenticazione Digest SIP:

1. Il tuo PBX invia il INVITE.
2. Bird risponde con 407 Proxy Authentication Required, includendo una riga di richiesta di autenticazione per ogni algoritmo offerto dal trunk: per impostazione predefinita, SHA-256 seguito da MD5.
3. Il tuo PBX invia nuovamente il INVITE con un'intestazione Proxy-Authorization calcolata usando il nome utente bird e il segreto della chiave API come password.
4. Bird verifica la risposta e prosegue con l'instradamento.

Un'intestazione Proxy-Authorization preventiva viene inviata prima della richiesta di autenticazione, quindi la tua apparecchiatura deve scegliere un algoritmo che il trunk offre. Per l'autenticazione con chiave API, un trunk con un elenco di indirizzi IP consentiti richiede comunque che la richiesta provenga da un indirizzo presente nell'elenco.

Bird risponde a un handshake non riuscito a livello SIP, quindi il tentativo viene respinto prima che la piattaforma crei un record della chiamata. Se le tue chiamate non compaiono affatto nel registro chiamate, controlla le credenziali anziché l'instradamento.

Attestazione delle chiamate

Le chiamate verso gli Stati Uniti e la Francia includono un'attestazione STIR/SHAKEN. Gli operatori usano questa firma per classificare le chiamate. Bird applica il livello B per impostazione predefinita, senza configurazioni aggiuntive. Contatta l'assistenza per richiedere il livello A.

Quando una chiamata viene rifiutata

Bird controlla l'ID chiamante, la destinazione, i limiti e il saldo del portafoglio prima di inoltrare la chiamata a un operatore. Il rifiuto arriva al tuo sistema telefonico come SIP 503; la causa specifica resta nel record della chiamata, accessibile dopo l’autenticazione. Apri la chiamata nel registro chiamate, oppure consulta le chiamate rifiutate per ogni causa e relativa soluzione.

Risolvi la causa registrata prima di riprovare. Ad esempio, calls_per_second_exceeded persiste finché non riduci la frequenza delle chiamate.

Le risposte a una chiamata registrata da Bird, incluso il 503 di un rifiuto con una causa registrata, contengono un'intestazione X-BIRD-CALL-ID con il Leg ID della chiamata (vcl_…). Consulta il record con GET /v1/voice/legs/{leg_id}, oppure comunica l'identificativo all'assistenza.

Le chiamate di emergenza non vengono inoltrate

Bird Voice non inoltra chiamate ai servizi di emergenza. Una chiamata a 112, 911, 999 o a qualsiasi altro numero di emergenza viene rifiutata, su ogni trunk e in ogni paese. Il tuo sistema telefonico deve raggiungere i servizi di emergenza tramite un altro percorso.

Questo comportamento non dipende dal piano, dal saldo o dalle destinazioni. Configura il tuo sistema telefonico per instradare le chiamate di emergenza tramite un servizio che le supporti, ad esempio una linea PSTN locale, un gateway in sede o un altro fornitore. Verifica che il percorso funzioni. Bird restituisce 503 per una chiamata di emergenza rifiutata, consentendo a un sistema telefonico con un percorso alternativo nel piano di numerazione di provarlo.

I servizi di emergenza si basano sulla posizione registrata del chiamante, che Bird non memorizza per i trunk. Non affidarti a un instradamento Bird per le chiamate di emergenza.

Costi e fatturazione

Il servizio voce è prepagato e utilizza il portafoglio della tua organizzazione, come gli altri canali:

• Il tempo fatturabile va dalla risposta alla fine della chiamata, indipendentemente da quanto è durata la fase di squillo. Il registro della chiamata lo mostra accanto a Total duration, che decorre dal momento in cui Bird ha ricevuto la chiamata.
• La tariffa dipende dal paese di destinazione. Il tuo tariffario indica il prezzo per ciascun paese nella valuta del portafoglio. Una tariffa definisce un tempo minimo fatturato e gli scatti applicati dopo tale minimo. Ad esempio, una tariffa con un minimo di un minuto e scatti di sei secondi fattura una chiamata di 10 secondi come un minuto.
• Il saldo del portafoglio viene controllato prima di contattare l'operatore. Se il saldo non basta a coprire una chiamata, questa viene rifiutata subito con insufficient_balance, anziché esserti addebitata in seguito. Mantieni un margine di saldo o attiva le ricariche automatiche.
• Si applica un limite di spesa giornaliero per il servizio voce. Una volta superato, le chiamate vengono rifiutate con daily_spend_exceeded fino all'inizio del giorno UTC successivo. In uno spazio di lavoro puoi anche impostare un limite giornaliero per ciascun paese di destinazione in Voice > Destinations. Una chiamata deve rispettare entrambi i limiti. L'importo dipende dal tuo piano.
• Il costo compare nei dati della chiamata dopo il calcolo della tariffa, con tutte le cifre decimali e al netto delle imposte.

Per esaminare gli addebiti di più chiamate, usa Utilizzo, spesa e fatture. L'esportazione CSV Legs include le durate e il tempo fatturabile, ma non contiene una colonna per il costo.

Passaggi successivi