Ricevere chiamate
Un numero del tuo spazio di lavoro può rispondere a una chiamata in entrata in tre modi: consegnarla a uno dei tuoi trunk SIP, inoltrarla a un numero che hai verificato, o rifiutarla. La risposta è un'impostazione sul numero, e un numero ha esattamente una risposta alla volta.
Ogni numero parte su rifiuto, quindi un numero che nessuno ha configurato respinge i chiamanti anziché restare senza risposta.
Prerequisiti
Prima di indirizzare un numero verso una risposta:
- Un numero che può ricevere chiamate. Apri Voice > Numbers e controlla la colonna Directions per un contrassegno inbound. Un numero registrato come caller ID da un altro operatore non riceve chiamate qui: quell'operatore instrada le chiamate dirette a esso, quindi non porta alcuna risposta.
- Per la consegna a un trunk: un trunk SIP con le chiamate in entrata attive e almeno un gateway di consegna.
- Per un inoltro: un caller ID verificato verso cui inoltrare.
- Per modificare l'impostazione tramite API o CLI: una chiave API con lo scope voice_management a livello di scrittura. Quello scope copre la configurazione vocale; lo scope voice copre il traffico e le statistiche delle chiamate, quindi la lettura del registro chiamate richiede l'altro.
Consegnare le chiamate a un trunk SIP
La consegna chiama il tuo centralino agli indirizzi che dichiari sul trunk. Attiva prima la direzione, perché un numero può essere indirizzato solo verso un trunk che già accetta chiamate in entrata.
- Apri Voice > SIP Trunks, apri il trunk e sotto Inbound calling seleziona Enable inbound.
- Aggiungi almeno un gateway nella stessa sezione. Un trunk senza gateway rifiuta ogni chiamata in entrata verso i numeri a cui risponde.
- Apri Voice > Numbers, apri il numero e sotto Inbound routing scegli Deliver to a SIP trunk.
- Scegli il trunk e seleziona Save. Nell'elenco compaiono solo i trunk con le chiamate in entrata attive.
La colonna Used for nell'elenco Numbers mostra quindi il numero come consegnato a quel trunk, e la pagina del trunk elenca i numeri a cui risponde.
Cosa serve a un gateway
Un gateway è un indirizzo a cui viene consegnata una chiamata, insieme al modo in cui quel peer vuole che i due numeri della chiamata siano formattati:
| Impostazione | Cos'è |
|---|---|
| SIP URI | L'host del tuo centralino, con una porta opzionale, come in sip:pbx.example.com:5060. Indica solo l'host: un URI con una user part viene rifiutato |
| Priority | L'ordine in cui i gateway vengono provati, dal più basso |
| Destination format | Come il numero chiamato viene formattato per questo peer. Il valore predefinito è E.164 |
| Origination format | Come il numero chiamante viene formattato per questo peer, nell'header P-Asserted-Identity della chiamata consegnata. Il valore predefinito è E.164 |
I gateway con la stessa priorità ricevono una quota uguale di chiamate, e ognuno di essi può essere provato per primo su una data chiamata. Per trasferire la consegna a un secondo indirizzo, assegna a quel gateway un numero di priorità più alto: viene provato quando il primo non risponde.
Entrambi i formati dei numeri sono template basati su un segnaposto, {number}, che rappresenta il numero senza il + iniziale. Il formato di destinazione viene posto prima dell'host URI SIP, quindi 1234#{number} consegna una chiamata a +31201234567 come sip:1234#31201234567@pbx.example.com:5060. Il valore predefinito per entrambi è +{number}, cioè E.164. Un formato che non contiene alcun {number} invia tutti i numeri a cui il trunk risponde a un unico indirizzo fisso.
Warning: turning inbound calling off on a trunk, or deleting the trunk, puts every number pointing at it back on reject. Turning inbound back on does not restore them, so each number has to be pointed at a trunk again.
Inoltrare le chiamate a un altro numero
Un inoltro risponde alla chiamata in entrata e ne effettua una seconda verso un numero che hai verificato, poi collega le due.
- Apri Voice > Numbers, apri il numero e sotto Inbound routing scegli Forward to another number.
- Scegli il numero verso cui inoltrare. L'elenco contiene i tuoi caller ID verificati, perché un inoltro può avere come destinazione solo un numero di cui hai dimostrato il controllo.
- Scegli quale numero la chiamata inoltrata mostra come chiamante, poi seleziona Save.
La destinazione dell'inoltro viene verificata quando la imposti e di nuovo a ogni chiamata inoltrata. Un caller ID che rimuovi in seguito interrompe l'inoltro anziché proseguire, e le chiamate in entrata vengono rifiutate da quel momento.
La chiamata inoltrata squilla per 45 secondi prima di essere abbandonata, un tempo più lungo rispetto alla consegna a un trunk perché il destinatario è di solito il telefono di una persona e non un centralino.
L'inoltro effettua una chiamata, quindi le regole in uscita si applicano alla seconda tratta: l'inoltro verso un paese che non hai attivato sotto Destinations viene rifiutato con destination_not_enabled.
Un inoltro, due record di chiamata
Una chiamata inoltrata produce due record che condividono un session_id:
| Record | Cos'è |
|---|---|
| La chiamata in arrivo | direction è inbound, e route indica che il numero era impostato per inoltrare, verso quale numero e quale numero la tratta inoltrata ha presentato |
| La chiamata inoltrata | direction è outbound, dal numero presentato dalla tratta al numero verso cui inoltri. Non porta un proprio route |
Raggruppali per session_id per vedere l'intera chiamata. Il record in arrivo è quello che indica come era configurato il numero.
Scegliere quale numero una chiamata inoltrata mostra come chiamante
Una chiamata inoltrata ha due numeri che potrebbe presentare a chi risponde, e la scelta cambia sia ciò che vedono sia la probabilità che un operatore interferisca con la chiamata:
- Numero chiamante è il numero del chiamante stesso, quindi il telefono squilla come se avesse composto il numero direttamente e la chiamata può essere restituita dal registro chiamate. Poiché il numero non è uno dei tuoi, alcuni operatori, più spesso negli USA e in parti d'Europa, contrassegnano tali chiamate come non verificate, sostituiscono il numero o le filtrano.
- Numero composto è il numero che il chiamante ha composto, che è uno dei tuoi. Chi risponde vede quale dei tuoi numeri è stato chiamato anziché chi ha chiamato.
Non c'è un valore predefinito. Specifica la scelta su ogni inoltro che configuri tramite API o CLI.
Quali valori il tuo spazio di lavoro può impostare è indicato sul numero stesso, in forward_as_options nella sua inbound_configuration. Presentare il numero composto richiede che il tuo spazio di lavoro sia approvato per effettuare chiamate dai numeri acquistati da noi, e tale approvazione non è ancora disponibile, quindi forward_as_options offre solo il numero chiamante e un inoltro presenta il numero del chiamante stesso. L'impostazione del numero composto viene rifiutata fino ad allora.
In lettura, forward_as è il valore che le chiamate effettivamente portano, che può differire dall'ultimo valore scritto.
Leggere cosa ha fatto un numero con una chiamata
Il record di una chiamata in entrata porta un route insieme al suo stato, e route indica cosa il numero era impostato per fare al momento della gestione della chiamata. Modificare l'impostazione del numero in seguito non cambia ciò che le sue chiamate passate riportano.
| route.type | Cosa ha fatto il numero |
|---|---|
| trunk | La chiamata è stata consegnata al trunk SIP indicato in trunk_id |
| forward | La chiamata è stata inoltrata al numero in forward_to, presentando il numero in forward_as |
| reject | Il numero ha respinto la chiamata |
route indica cosa il numero era impostato per fare, non che abbia funzionato. Una rotta trunk su una chiamata mai connessa è un numero indirizzato verso un trunk che non ha accettato la chiamata, e lo stato della chiamata è ciò che riporta l'esito. route è assente sulle chiamate in uscita e sulle chiamate registrate prima dell'esistenza del campo.
Nella dashboard, apri la chiamata da Voice > Calls e leggi la riga Inbound route, che rimanda al numero le cui impostazioni l'hanno determinata. Tramite API, route si trova su GET /v1/voice/calls/{call_id} e GET /v1/voice/calls, e direction filtra l'elenco sulle chiamate in entrata.
Diagnosticare una chiamata in entrata rifiutata
Una chiamata in entrata rifiutata viene registrata con lo stato rejected. Due cause diverse lo producono, e rejection_reason è ciò che le distingue:
- Rifiutata senza rejection_reason. Il numero stesso ha respinto la chiamata. La chiamata non ha fallito alcun nostro controllo, quindi non indica alcun motivo, e route indica come era impostato il numero. Una rotta reject è un numero che nessuno ha indirizzato da nessuna parte, o uno impostato deliberatamente per rifiutare.
- Rifiutata con un rejection_reason. La chiamata ha fallito uno dei nostri controlli prima di raggiungere il tuo centralino. Il motivo indica il controllo. Chiamate rifiutate elenca ogni motivo e la relativa soluzione.
failed è uno stato diverso e non significa rifiutata: significa che la chiamata è stata tentata e non ha funzionato, con sip_response_code che riporta la risposta ricevuta.
Leggi route e rejection_reason insieme per distinguere i rifiuti:
| route e motivo | Causa |
|---|---|
| reject, nessun motivo | Il numero non è indirizzato verso alcuna risposta. Eliminare un trunk, o disattivarne le chiamate in entrata, riporta qui ogni numero che puntava a esso, quindi un numero che prima funzionava può ricadervi |
| trunk, no_route_found | Il numero è indirizzato verso un trunk, e quel trunk non ha alcun gateway a cui consegnare la chiamata. Aggiungine uno nella pagina del trunk |
| forward, nessun motivo | La destinazione dell'inoltro non è più un caller ID verificato. Verificala di nuovo sotto Caller IDs, oppure inoltra a un altro numero |
| forward, destination_not_enabled | La seconda tratta non è stata effettuata verso il paese della destinazione dell'inoltro. Attiva quel paese sotto Destinations |
I limiti dell'account si applicano anche alle chiamate in entrata: oltre il saldo del wallet, il limite di spesa vocale giornaliero della tua organizzazione, o i tuoi limiti di concorrenza e al secondo, una chiamata in entrata viene rifiutata con il motivo corrispondente. Panoramica Voice tratta i limiti stessi.
Verificare il costo di una chiamata ricevuta
Ricevere una chiamata ha un costo. La tariffa dipende dal paese e dal tipo del numero che la riceve, ed è pubblicata per paese sotto Receiving calls nella pagina dei prezzi Voice, insieme alle tariffe per le chiamate che effettui.
Un inoltro viene fatturato come due chiamate: la chiamata in arrivo alla tariffa di ricezione, e la tratta che effettuiamo alla tariffa in uscita per il numero verso cui inoltri. Un'unica commissione di gestione viene addebitata una volta per la chiamata anziché una per tratta.
Il wallet viene verificato prima che una chiamata in entrata sia consegnata, quindi un saldo insufficiente a coprirla significa che la chiamata viene rifiutata anziché addebitata in seguito. Costi e fatturazione spiega come funzionano il tempo fatturabile, le tariffe e il wallet per entrambe le direzioni.
Passaggi successivi
| Pagina | Cosa tratta |
|---|---|
| Trunk SIP | Creare un trunk, le sue due direzioni e controllare chi può inviare |
| Caller IDs | Registrare un numero e dimostrare di controllarlo |
| Registro chiamate | Ogni campo di un record di chiamata e ogni motivo di rifiuto |
| Eventi Voice | Ricevere gli esiti delle chiamate nei tuoi sistemi |
| Risoluzione problemi Voice | Diagnosticare una chiamata che non va a buon fine, partendo dal sintomo |
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.