Sign inGet Started

Risoluzione dei problemi Voice

Parti dal registro chiamate. La presenza di un record e i suoi campi determinano quali controlli seguire.

Per le chiamate avviate tramite API, controlla prima la risposta Create Call e la cronologia delle esecuzioni. Consulta la risoluzione dei problemi delle sequenze per anteprima, pubblicazione, percorsi da tastiera e rotte delle sequenze in ingresso. I controlli di connessione seguenti riguardano le chiamate tramite trunk SIP.

Se non vedi alcun record di chiamata, controlla prima questi punti:

  1. Sei nello spazio di lavoro corretto. I record delle chiamate appartengono allo spazio di lavoro che possiede il numero o il trunk. Passa a quello spazio di lavoro, poi apri Voice > Legs.
  2. La chiamata ha raggiunto Bird. Per una chiamata in entrata, è l'operatore del chiamante a decidere dove va la chiamata, e un numero associato a un trunk senza gateway salvato rifiuta la chiamata prima che esista un record. Per una chiamata in uscita, consulta Una chiamata in uscita non compare nel registro chiamate: un'ammissione rifiutata non lascia alcun record.
  3. I filtri non la nascondono. Rimuovi il filtro di stato e amplia l'intervallo di date.

Una chiamata in uscita non compare nel registro chiamate

Per una chiamata effettuata tramite un trunk SIP, un errore di ammissione può verificarsi prima che esista un record del leg. Controlla queste cause comuni:

  • Il trunk non gestisce ancora le chiamate in uscita. Un trunk nuovo non trasporta alcuna chiamata finché non attivi le chiamate in uscita nella sua pagina, e rifiuta ogni tentativo fino a quel momento, indipendentemente dalle credenziali presentate.
  • Il trunk non ha ancora modo di riconoscerti. Un trunk nuovo rifiuta ogni chiamata finché non aggiungi un intervallo IP, una chiave API consentita o delle credenziali di sessione.
  • La chiamata è arrivata da un indirizzo fuori dalla lista IP consentiti del trunk. Dietro un NAT, confronta l'indirizzo pubblico del router con la lista IP consentiti del trunk. L'indirizzo privato del centralino non raggiunge Bird.
  • La challenge della password è fallita. Verifica che lo username sia bird. La password deve essere il secret di una chiave API consentita oppure una credenziale di sessione non scaduta. Il trunk deve inoltre offrire l'algoritmo Digest usato dal tuo centralino.
  • La chiamata era indirizzata a un dominio SIP che Bird non riconosce. Il tuo dispositivo deve inserire il dominio SIP del trunk come host della Request-URI. Copia il dominio per intero dalla pagina del trunk anziché ricomporlo manualmente. Una chiamata indirizzata a un altro nome host o indirizzo Bird non raggiunge il tuo trunk.

La risposta ricevuta dal tuo dispositivo indica quale controllo non è stato superato. 407 Proxy Authentication Required significa che il trunk richiede una password; con le credenziali di sessione attive, la richiede a ogni chiamante. 403 Forbidden significa che il trunk non ha ammesso la chiamata: un host della Request-URI diverso dal dominio SIP del trunk, chiamate in uscita disattivate, un indirizzo fuori dalla lista IP consentiti o una password non verificata. 503 Auth Unavailable significa che Bird non è riuscito a controllare la chiamata, quindi riprova.

Per una chiamata con sequenza, controlla prima se la richiesta di chiamata è stata accettata e se esiste un'esecuzione. Un'anteprima nel simulatore non effettua chiamate. Un test reale richiede una bozza salvata o una pubblicazione attiva, autorizzazioni in scrittura per la gestione Voice e le chiamate, un caller ID idoneo e una destinazione abilitata. La guida al builder di sequenze spiega questi controlli.

La chiamata è rifiutata con un motivo di rifiuto

Bird ha rifiutato la chiamata prima di contattare un operatore, e il motivo indica il controllo non superato. Apri la chiamata e usa il link nel pannello di rifiuto per raggiungere l'impostazione pertinente. Chiamate rifiutate elenca ogni motivo e la relativa soluzione.

caller_id_not_verified è quello in cui un nuovo client incappa più spesso, di solito perché il client inserisce lo username digest dove va il caller ID: i due sono campi diversi.

La chiamata risulta fallita anziché rifiutata

Failed non è un rifiuto. La chiamata è stata tentata ma non è andata a buon fine, e SIP response riporta il codice restituito. Un 486 indica un numero occupato, un 404 un numero non assegnato. Di solito il problema riguarda il numero chiamato, non la tua configurazione.

Una chiamata rifiutata da Bird è Rejected, non Failed: filtra quindi il registro su Rejected quando cerchi una chiamata che non ha superato uno dei controlli di Bird.

La chiamata è rifiutata senza motivo di rifiuto

Su una chiamata in uscita, il destinatario l'ha declinata direttamente e SIP response ne riporta il codice.

Su una chiamata in entrata, il numero chiamato ha respinto la chiamata, il che non fa fallire alcun controllo e quindi non indica alcun motivo. Apri la chiamata e leggi Inbound route: una route reject è un numero impostato per rifiutare, oppure un numero senza una propria route mentre la route predefinita dello spazio di lavoro è reject. Ricezione chiamate illustra ogni rifiuto in entrata in base a route e motivo.

La persona chiamata ha visto un numero diverso

La chiamata ha un record e nessun motivo di rifiuto, quindi ha superato tutti i controlli di Bird. Il problema è a valle di Bird: l'operatore di terminazione ha sostituito il caller ID oppure ha rifiutato una chiamata che lo presenta. La stessa causa si manifesta come un numero che funziona in un paese e non si connette mai in un altro.

La verifica dimostra che controlli un caller ID. Non obbliga l'operatore che consegna la chiamata ad accettarlo, e gli operatori applicano le proprie regole nazionali a un numero non acquisito tramite Bird. Consulta il disclaimer su verifica e consegna CLI per le pratiche coinvolte, che includono requisiti CLI nazionali, blocco basato sull'origine e liste do-not-originate.

Per sapere che tipo di numero hai presentato, aprilo in Voice > Numbers e leggi il pannello in cima alla sua pagina. Un numero acquistato da Bird mostra la sua sottoscrizione, così come uno acquistato e anche verificato. Solo un numero di tua proprietà presso un altro operatore mostra unicamente una verifica. Una sottoscrizione significa che il numero è stato acquisito tramite Bird, quindi il disclaimer non si applica. Presentare un numero acquisito tramite Bird è ciò che aumenta i tassi di consegna e completamento sulle destinazioni che rifiutano un numero solo verificato.

Una chiamata in entrata non raggiunge mai il tuo centralino

Il numero ha risposto alla chiamata, ed è la consegna a essere fallita. Controlla in questo ordine:

  1. Leggi il campo Inbound route della chiamata. Indica a quale trunk o inoltro puntava il numero al momento della chiamata. Un instradamento reject significa che il numero ha un proprio instradamento impostato su reject, oppure non ha un instradamento proprio mentre l'instradamento predefinito dello spazio di lavoro è reject. Apri il numero per capire quale caso si applica: un numero impostato su reject ignora il valore predefinito. Un numero il cui trunk è stato eliminato o ha le chiamate in entrata disattivate torna all'instradamento predefinito, e un instradamento predefinito che punta a quel trunk torna a reject.
  2. Verifica che il trunk possa consegnare la chiamata. Apri Inbound routing del trunk. Un gateway deve appartenere a un gruppo, e la Default route (o una regola) deve inviare le chiamate a quel gruppo. Una route predefinita impostata su Reject rifiuta ogni chiamata senza motivo di rifiuto, e un trunk senza gateway salvato rifiuta la chiamata prima che esista un record. Correggi l'avviso Calls never reach some gateways se la dashboard lo mostra al salvataggio.
  3. Verifica l'indirizzo del gateway. Bird contatta i gateway del gruppo nell'ordine stabilito dal gruppo e si arrende quando nessuno risponde. Conferma l'host dell'URI SIP, la sua porta e che il tuo centralino accetti chiamate da Bird su quell'indirizzo.
  4. Per un inoltro, verifica che il destinatario sia ancora verificato. Il destinatario dell'inoltro viene ricontrollato a ogni chiamata, quindi un caller ID che hai rimosso interrompe l'inoltro da quel momento in poi.
  5. Controlla la risposta del tuo dispositivo. Una chiamata che ha raggiunto il tuo gateway ed è stata rifiutata lì risulta di solito Failed (una risposta 6xx appare come Rejected), e SIP response riporta il codice del tuo dispositivo, ad esempio 403 o 412. Bird ha tentato la chiamata, quindi la correzione va fatta dalla tua parte: verifica che il tuo SBC accetti chiamate dagli indirizzi di segnalazione di Bird e il formato del numero inviato dal gateway.

Se il numero usa Run a sequence, ispeziona la sequenza associata e il punto di ingresso della chiamata anziché il trunk. Controlla che ci sia una pubblicazione attiva, che il punto di ingresso accetti dati vuoti e se il chiamante è un tester della bozza. Esamina l'esito dell'esecuzione della sequenza e il ramo di errore. Modificare una bozza non cambia la versione usata dai chiamanti ordinari.

Il telefono nel browser non squilla o non riesce a chiamare

Controlla prima lo stato in fondo al telefono:

  1. Scegli Online per ricevere chiamate. Un ring group salta i membri che sono Offline, Busy, già impegnati in una chiamata o Not accepting calls dopo tre chiamate perse di fila. Il tuo stato spiega ciascuno di questi stati.
  2. Vai online per chiamare. Un telefono Offline non può effettuare chiamate. Con Online, Busy e Not accepting calls puoi chiamare.
  3. Porta le chiamate su questo browser. In ogni spazio di lavoro puoi essere online su un solo dispositivo e in una sola scheda alla volta. Offline · Active on another device offre Take over, mentre Offline · Calls are handled in another tab offre Use here.
  4. Controlla il limite di utenti online. Offline · Limit of users online reached significa che la tua organizzazione ha già il numero massimo di utenti online consentito. Consulta Limite di utenti online.
  5. Attiva l'audio. Dopo un ricaricamento, il browser può bloccare la suoneria finché non interagisci con la pagina. In quel caso il menu dello stato offre Turn on sound.

Se il telefono è online e una chiamata continua a non squillare, leggi il campo Inbound route della chiamata nel registro chiamate. Indica il ring group in cui la chiamata ha squillato, così puoi verificare di esserne membro e che il numero instradi a quel gruppo.

Il tuo client risponde MD5 e non ottiene nulla

Alcuni dispositivi gestiscono male una challenge che inizia con SHA-256. Imposta il trunk su solo MD5.

Le chiamate si connettono ma l'audio è unidirezionale

Il tuo client è dietro un NAT e il suo media viene inviato a un indirizzo privato. Abilita la gestione NAT o STUN nel client.

Se il tuo dispositivo è raggiungibile e l'audio continua a non funzionare in una direzione, verifica che il firewall consenta gli indirizzi media di Bird sulle porte UDP da 2500 a 32499.

Passaggi successivi

PaginaCosa tratta
Registro chiamateOgni campo di un record chiamata e ogni motivo di rifiuto
Trunk SIPLista IP consentiti, chiavi, credenziali di sessione e Digest
Configurazione client SIPLe impostazioni richieste da ogni softphone e centralino
Effettuare chiamateCosa si aspetta Bird sul INVITE e come funziona l'handshake
Ricevere chiamateAssociare un numero a un trunk o a un inoltro e cosa viene registrato
TelefonoAndare online, il tuo stato e rispondere a una chiamata nel browser

Continua con la documentazione, le guide e gli esempi per questo argomento.