Caller ID

Un caller ID è un numero che il tuo spazio di lavoro può presentare in una chiamata in uscita. Bird confronta l'header SIP From di ogni chiamata con i numeri Bird che questo spazio di lavoro può presentare e con i suoi numeri esterni verificati. Le chiamate che presentano un numero non idoneo vengono rifiutate.

Gestisci i caller ID in Voice > Numbers, che elenca tutti i numeri utilizzabili dal tuo spazio di lavoro per le chiamate vocali. Un numero acquistato da noi e un numero verificato compaiono nella stessa lista, una riga per numero. Un numero che è entrambi compare una sola volta. Un numero acquistato da noi è pronto per essere presentato non appena lo possiedi, senza chiamata di verifica: il possesso è la prova. La procedura seguente riguarda un numero di tua proprietà presso un altro operatore.

Ogni riga mostra il nome, il numero e il suo paese, il Provider, le direzioni di chiamata supportate e l'utilizzo del numero. Un numero in attesa del codice mostra Verifying; uno il cui codice è scaduto o i cui tentativi sono esauriti mostra Failed. Ogni pagina contiene fino a 25 numeri. Seleziona una riga per aprire la pagina del numero.

Registrare un numero

1. Seleziona Add number > Verify a number you own.
2. Inserisci il numero in formato E.164: un + iniziale, il prefisso del paese e il numero nazionale. Un numero può essere registrato una sola volta nel tuo spazio di lavoro.
3. Salva. Una chiamata di verifica viene effettuata immediatamente al numero.
4. Rispondi alla chiamata e ascolta il codice a sei cifre.
5. Inserisci il codice nella dashboard. Hai cinque tentativi e un codice accettato cambia lo stato in Verified.

La verifica del caller ID non addebita al tuo spazio di lavoro la chiamata di verifica. La registrazione richiede comunque il permesso di gestione Voice e l'approvazione dell'account per registrare numeri verificati. Assegna un nome al numero in seguito nella sua pagina. Vedi Assegnare un nome a un numero.

Dopo la verifica, controlla il paese che intendi chiamare in Voice > Destinations. La verifica tenta di abilitare il paese del numero verificato, ma paesi non disponibili o un aggiornamento delle impostazioni non riuscito possono lasciarlo disabilitato. Un caller ID verificato e una destinazione abilitata sono requisiti separati.

Registrare e verificare tramite API

Registra un numero per avviare la sua chiamata di verifica, quindi invia il codice per l'ID restituito dalla registrazione. Elenca i tuoi caller ID per trovare un numero registrato nella dashboard. Puoi anche rinominare o eliminare un caller ID. La lettura richiede voice_management:read; registrazione, verifica, ridenominazione ed eliminazione richiedono voice_management:write. La documentazione API include esempi per SDK, la riga di comando Bird e MCP.

Se non è stato possibile avviare la chiamata di verifica originale, l'invio del codice può avviare un'altra chiamata al numero registrato. La tua organizzazione deve continuare a soddisfare i requisiti di registrazione. Se il codice scade o i tentativi sono esauriti, elimina il caller ID e registra di nuovo il numero: verrà effettuata una nuova chiamata di verifica. Invia poi il nuovo codice per l'ID restituito da quella registrazione. Se il codice viene accettato ma l'attivazione restituisce 412 o 503, la proprietà resta dimostrata e il caller ID risulta verified con outbound_enabled: false. Un 412 indica che la verifica dell'identità è incompleta, e la completi nella dashboard, oppure una revisione o un rifiuto di idoneità, che richiede il supporto. Un 503 indica che la valutazione di idoneità è in sospeso o non disponibile, quindi riprova più tardi. Una volta risolto, invia una richiesta di verifica vuota per lo stesso ID; non eliminarlo e non registrarlo di nuovo.

Dopo la verifica, controlla le destinazioni Voice e abilita il paese del numero quando è supportato e necessario. La verifica tenta di abilitarlo, ma anche dopo una verifica riuscita del caller ID la destinazione può rimanere disabilitata e le chiamate in uscita verso quel paese possono restare bloccate.

Una verifica alla volta

La registrazione può restituire E21036 quando il provider di verifica ha già una challenge per quel numero associata a un altro spazio di lavoro o scopo. Attendi che la verifica termini o scada, poi registra di nuovo il numero. Una prova ottenuta per un altro spazio di lavoro non verifica il numero nel tuo.

Lo stesso rifiuto si applica a un numero occupato per un altro motivo: un codice di accesso o una verifica Trust Hub già in corso verso quel numero. Se nessun altro spazio di lavoro sta verificando il numero, di solito il motivo è questo, e l'attesa è la stessa.

Una verifica già completata altrove non ti blocca: lo stesso numero può essere un caller ID verificato in più di uno spazio di lavoro, e ognuno lo dimostra separatamente.

Stati

Get a new code registra di nuovo il numero e lo chiama con un nuovo codice. Se la prima chiamata non è mai arrivata e il numero è ancora in attesa, rimuovi il caller ID e aggiungi di nuovo il numero.

Se leggi questi valori dal tuo tooling, gestisci quelli che riconosci e tratta qualsiasi altro come uno stato non gestito anziché come un errore.

Disclaimer su verifica e consegna di CLI

Bird esegue la verifica CLI (Calling Line Identification) per confermare che un A-number è valido e autorizzato all'uso prima che le chiamate in uscita possano essere effettuate dalla piattaforma. Questa verifica assicura che il numero sia legittimo e sotto il controllo del cliente.

Tuttavia, 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. I carrier a valle e gli operatori internazionali applicano le proprie normative nazionali e politiche di traffico, che sono al di fuori del controllo di Bird. Queste possono includere:

• Framework anti-spoofing e di autenticazione del caller ID (ad es. STIR/SHAKEN negli USA, linee guida CLI di Ofcom nel Regno Unito)
• Requisiti affinché il CLI sia un numero registrato localmente o nazionale
• Filtraggio di spam e frodi applicato dagli operatori di terminazione
• Restrizioni su categorie di traffico specifiche, come gioco d'azzardo, promozioni finanziarie, recupero crediti o messaggistica politica
• Blocco delle chiamate internazionali che presentano un CLI nazionale (restrizioni "origin-based")
• Liste do-not-originate e blocchi imposti dai regolatori

Per queste ragioni, Bird può verificare un CLI ma non può garantire che (1) il CLI venga preservato e mostrato al destinatario della chiamata, o (2) la chiamata si connetta tramite trunk nazionali o partner e operatori internazionali Tier 1. Per massimizzare la consegna del CLI e i tassi di completamento delle chiamate, raccomandiamo di usare numeri acquisiti tramite Bird, che sono provisionati e instradati in conformità ai requisiti normativi locali.

Assegnare un nome a un numero

Un nome identifica il numero nella dashboard e nella lista Call from del dialer. Non viene inviato con la chiamata.

Seleziona il numero nella lista Numbers per aprire la sua pagina, poi imposta Name e salva. Lascia il campo vuoto per mostrare solo il numero. L'assegnazione del nome funziona con qualsiasi stato e non modifica il numero né la sua verifica.

Verificare un numero a cui non puoi rispondere

Qualcuno deve rispondere alla chiamata di verifica e ascoltare il codice. Se il numero raggiunge normalmente un sistema non presidiato, instradalo temporaneamente verso un telefono a cui puoi rispondere, poi ripristinalo. Contatta il supporto se il numero non può ricevere chiamate.

Rimuovere un caller ID

Usa Remove caller ID sulla riga del numero. La rimozione della verifica elimina quella prova per le nuove chiamate. Un numero detenuto dal tuo spazio di lavoro tramite Bird può restare idoneo grazie alla sua allocazione; un numero esterno che perde la sua prova viene rifiutato con caller_id_not_verified. Le chiamate già in corso continuano e i registri delle chiamate esistenti non cambiano.

Passaggi successivi