# 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**](https://bird.com/dashboard/w/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](/docs/guides/voice/sip-trunks) con le chiamate in entrata attive e almeno un gateway di consegna. - **Per un inoltro:** un [caller ID verificato](/docs/guides/voice/caller-ids) 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. 1. Apri **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/voice/sip-trunks), apri il trunk e sotto **Inbound calling** seleziona **Enable inbound**. 2. Aggiungi almeno un gateway nella stessa sezione. Un trunk senza gateway rifiuta ogni chiamata in entrata verso i numeri a cui risponde. 3. Apri **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), apri il numero e sotto **Inbound routing** scegli **Deliver to a SIP trunk**. 4. 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. 1. Apri **Voice** > [**Numbers**](https://bird.com/dashboard/w/voice/numbers), apri il numero e sotto **Inbound routing** scegli **Forward to another number**. 2. 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. 3. 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](/docs/guides/voice/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**](https://bird.com/dashboard/w/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}`](/docs/api/reference/get-voice-call) e [`GET /v1/voice/calls`](/docs/api/reference/list-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](/docs/guides/voice/call-log#rejected-calls) 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](/docs/guides/voice/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](/docs/guides/voice/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](/docs/guides/voice/overview#limits) 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](/pricing/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](/docs/guides/voice/placing-calls#cost-and-billing) spiega come funzionano il tempo fatturabile, le tariffe e il wallet per entrambe le direzioni. ## Passaggi successivi | Pagina | Cosa tratta | | ---------------------------------------------------------------- | ----------------------------------------------------------------------- | | [Trunk SIP](/docs/guides/voice/sip-trunks) | Creare un trunk, le sue due direzioni e controllare chi può inviare | | [Caller IDs](/docs/guides/voice/caller-ids) | Registrare un numero e dimostrare di controllarlo | | [Registro chiamate](/docs/guides/voice/call-log) | Ogni campo di un record di chiamata e ogni motivo di rifiuto | | [Eventi Voice](/docs/guides/voice/events) | Ricevere gli esiti delle chiamate nei tuoi sistemi | | [Risoluzione problemi Voice](/docs/guides/voice/troubleshooting) | Diagnosticare una chiamata che non va a buon fine, partendo dal sintomo | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/products/voice) (product) [Get an implementation brief](/learn/workspace?topic=voice)