Effettuare chiamate

Il PBX, il centralino che instrada le chiamate, invia un SIP INVITE al dominio SIP del trunk per effettuare una chiamata. Bird verifica la richiesta, la instrada verso un operatore e trasmette l'audio. Questa pagina copre i prerequisiti, i campi della richiesta, l'autenticazione e i costi.

Prima di effettuare una chiamata

Quattro elementi devono essere pronti, in qualsiasi ordine, e tre dipendono da te:

Un trunk che accetta il tuo traffico. Crea un trunk SIP e abilita le chiamate in uscita. Aggiungi gli intervalli IP del tuo apparato, una chiave API consentita, o entrambi. I client che non possono conservare un segreto a lungo termine possono usare una credenziale di sessione.
Un caller ID verificato. Registra il numero che presenti e completa la chiamata di verifica, il modo in cui uno spazio di lavoro dimostra di possedere i numeri che presenta. La verifica non garantisce la consegna end-to-end del CLI né la connessione della chiamata quando il CLI non è un numero acquisito tramite Bird: consulta il disclaimer su verifica e consegna di CLI.
Il paese di destinazione abilitato. Attiva i paesi che servi nella pagina Destinations.
Routing associato al tuo spazio di lavoro. Bird lo configura per te, scegliendo quali operatori servono quali destinazioni. Finché non è attivo, le chiamate vengono rifiutate con routing_not_configured, uno dei motivi trattati in Chiamate rifiutate.

Cosa Bird si aspetta nell'INVITE

Invia la richiesta al dominio SIP del trunk su una delle porte supportate. Due header contengono tutto ciò che serve a Bird:

Header	Cosa fa Bird con il valore
To	Il numero chiamato. Bird ne legge il paese per scegliere un operatore e tariffare la chiamata
From	Il numero che presenti come chiamante. Deve essere un caller ID verificato in questo spazio di lavoro

Usa numeri internazionali completi in formato E.164, un + iniziale seguito dal prefisso del paese e dal numero nazionale, su entrambi gli header. È la forma che Bird registra sulla chiamata e quella che il matching delle destinazioni si aspetta.

Oltre a questi due header, si tratta di una chiamata SIP ordinaria, senza header personalizzati in nessuna direzione.

Autenticazione di ogni chiamata

Il percorso di una chiamata dipende da come è aperto il trunk:

Solo lista IP consentiti. Una sola richiesta. Bird confronta l'indirizzo sorgente con la lista e instrada la chiamata, senza challenge da completare.
Solo chiavi API consentite. Bird chiede prima una password alla chiamata, attraverso lo scambio Digest SIP.
Entrambi. L'indirizzo sorgente viene controllato prima che Bird invii il challenge, quindi una chiamata da un indirizzo non in lista viene rifiutata qualunque credenziale porti.
Credenziali di sessione attive. Bird invia il challenge alla chiamata indipendentemente dalla provenienza, anche da un indirizzo non coperto dalla lista consentiti, e una credenziale emessa pochi minuti prima risponde. Gli apparati già ammessi dalla lista consentiti su un trunk senza chiavi consentite continuano a connettersi senza challenge.

Quando il trunk ha chiavi API consentite, il tuo centralino risponde con un hash del segreto della chiave API anziché con il segreto stesso: è ciò che fa l'autenticazione Digest SIP:

Il tuo PBX invia l'INVITE.
Bird risponde 407 Proxy Authentication Required con una riga di challenge per ogni algoritmo offerto dal trunk, SHA-256 poi MD5 per impostazione predefinita.
Il tuo PBX reinvia l'INVITE con un header Proxy-Authorization calcolato usando come username bird e come password il segreto della chiave API.
Bird verifica la risposta e prosegue con il routing.

Un header Proxy-Authorization preemptive viene inviato prima del challenge, quindi il tuo apparato deve scegliere un algoritmo tra quelli che il trunk offre. Se il trunk ha anche una lista IP consentiti, la richiesta deve comunque provenire da un indirizzo in lista.

Bird risponde a un handshake fallito al livello SIP, quindi il tentativo viene respinto prima che la piattaforma crei un record di chiamata. Se le tue chiamate non compaiono affatto nel Call log, controlla le credenziali anziché il routing.

Attestazione della chiamata

Le chiamate verso gli Stati Uniti e la Francia portano l'attestazione STIR/SHAKEN. Gli operatori usano questa firma per etichettare le chiamate. Bird applica il livello B per impostazione predefinita senza configurazione aggiuntiva. Contatta il supporto per richiedere il livello A.

Quando una chiamata viene rifiutata

Bird controlla il caller ID, la destinazione, i limiti e il saldo del wallet prima di inoltrare la chiamata a un operatore. Il rifiuto raggiunge il tuo centralino come SIP 503; la causa specifica resta sul record autenticato della chiamata. Apri la chiamata nel call log, oppure consulta le chiamate rifiutate per ogni motivo e risoluzione.

Risolvi la causa registrata prima di riprovare. Ad esempio, calls_per_second_exceeded continua finché non rallenti la frequenza di composizione.

Le chiamate di emergenza non sono supportate

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

Questo comportamento non dipende dal tuo piano, dal saldo o dalle destinazioni. Configura il tuo centralino per instradare le chiamate di emergenza attraverso un servizio che le supporti, come una linea PSTN locale, un gateway on-premises o un altro provider. Testa quel percorso. Bird restituisce 503 per una chiamata di emergenza rifiutata, permettendo a un centralino con un altro percorso nel dial-plan di ritentare.

I servizi di emergenza dipendono dalla posizione registrata del chiamante, che Bird non memorizza per un trunk. Non fare affidamento su un percorso Bird per le chiamate di emergenza.

Costi e fatturazione

Voice è prepagato dal wallet della tua organizzazione, come gli altri canali:

Il tempo fatturabile decorre dalla risposta alla fine, indipendentemente da quanto a lungo la chiamata ha squillato. Il record della chiamata lo mostra insieme alla Durata totale, che decorre dal momento in cui Bird ha ricevuto la chiamata.
La tariffa dipende dal paese di destinazione. La tua scheda tariffaria indica il prezzo di ogni paese nella valuta del wallet. Una tariffa definisce un tempo minimo fatturato e l'incremento usato dopo quel minimo. Ad esempio, una tariffa con un minimo di un minuto e incrementi di sei secondi fattura una chiamata di 10 secondi come un minuto.
Il wallet viene controllato prima che l'operatore venga chiamato. Una chiamata che il tuo saldo non può coprire viene rifiutata con insufficient_balance in anticipo, anziché addebitata successivamente. Mantieni un margine, oppure attiva le ricariche automatiche.
Si applica un limite di spesa vocale giornaliero. Superato il limite, le chiamate vengono rifiutate con daily_spend_exceeded fino all'inizio del giorno UTC successivo. L'importo dipende dal tuo piano.
Il costo compare sulla chiamata una volta tariffata, a precisione piena, al netto delle imposte.

Per totalizzare la spesa tra le chiamate, esporta la lista filtrata delle chiamate come CSV dalla pagina Calls, oppure consulta le tue fatture e utilizzo.

Prossimi passi

Pagina	Cosa copre
Call log	Consultazione, filtro ed esportazione dei record di chiamata
Voice events	Ricevere gli esiti delle chiamate nei tuoi sistemi
Payment methods & wallet	Ricariche, ricariche automatiche e come viene scalato il wallet

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Comprendi il concettoWhat is a voice API?Esplora la funzionalitàVoice Guida all'implementazioneVoice overview

Ottieni un brief di implementazione