Effettua la tua prima chiamata

Effettua una vera telefonata dalla dashboard. Il telefono della dashboard è un client SIP che utilizza le stesse impostazioni di trunk, caller ID e destinazione del tuo sistema telefonico.

Dopo la chiamata puoi ispezionare il relativo record nella dashboard o tramite la API Voice.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Uno spazio di lavoro con Phone sotto Voice. La dashboard lo mostra quando la regione del tuo spazio di lavoro supporta le chiamate dal browser e disponi dei permessi voice:write e voice_management:read.
• Un numero di telefono di tua proprietà e un telefono in grado di rispondere alle chiamate di verifica e di test.
• Un browser con un microfono funzionante.

1. Apri il telefono

Seleziona Voice > Phone nella dashboard. Il telefono si apre in una finestra mobile e resta aperto mentre navighi.

Se il tuo spazio di lavoro non è pronto per effettuare chiamate, il telefono mostra Finish setup to place calls. La checklist identifica ogni requisito mancante e rimanda all'azione necessaria. Creare un trunk pronto per le chiamate e verificare un caller ID completa la checklist.

2. Crea un trunk pronto per le chiamate

Seleziona Create a trunk dalla checklist. Inserisci un nome, quindi seleziona Create trunk.

La dashboard abilita le chiamate in uscita e le credenziali di sessione quando crea il trunk. Il trunk offre anche il digest MD5 utilizzato dal browser. La checklist segna come completati tutti i requisiti del trunk.

3. Verifica il tuo caller ID

Seleziona Verify a number you own dalla checklist. Inserisci un numero di tua proprietà nel campo Phone number in formato E.164: un + iniziale, il prefisso internazionale e il numero nazionale. Quindi seleziona Send verification call.

Rispondi alla chiamata di verifica e ascolta il codice a sei cifre. Inseriscilo nel campo Verification code, quindi seleziona Verify caller ID.

La dashboard mostra Caller ID verified, rimuove l'avviso di configurazione e aggiunge il numero alla riga From del telefono.

4. Abilita il paese di destinazione

Apri Voice > Destinations. Trova il paese che intendi chiamare e attiva il relativo toggle.

Le chiamate verso paesi disabilitati vengono rifiutate prima che la piattaforma contatti un operatore.

5. Effettua la chiamata

Inserisci il numero che hai verificato nella riga To, quindi seleziona Call. Se il browser richiede l'accesso al microfono, concedilo.

Il tuo telefono squilla e mostra il caller ID verificato. Rispondi alla chiamata e verifica di avere audio bidirezionale. Per terminare la chiamata dalla dashboard, seleziona Hang up.

6. Ispeziona il record della chiamata

Apri Voice > Legs. La pagina elenca le chiamate per orario di inizio, dalla più recente, quindi la tua chiamata compare nella prima riga. Selezionala per vedere quando ha ricevuto risposta, la durata fatturabile e il costo al termine della tariffazione.

Gli stessi record delle chiamate sono disponibili tramite la API:

for await (const leg of bird.voice.legs.list()) {
  console.log(leg.id, leg.status);
}

for leg in client.voice.legs.list():
    print(leg.id, leg.status)

for leg, err := range client.Voice.Legs.List(context.Background(), bird.VoiceLegsListParams{}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(leg.Id, leg.Status)
}

foreach ($bird->voice->legs->list() as $leg) {
    echo $leg->getId(), ' ', $leg->getStatus(), "\n";
}

bird voice legs list

curl -X GET "https://{region}.platform.bird.com/v1/voice/legs" \
  -H "Authorization: Bearer $TOKEN" \
  --url-query "limit=25"

Usa il record della chiamata per indagare futuri problemi di chiamata. Una chiamata rifiutata registra la causa in rejection_reason. Per filtri della dashboard, campi dei record e accesso API, consulta la guida al registro chiamate.

Risoluzione dei problemi della chiamata di test

• Il telefono mostra ancora Finish setup to place calls: completa ogni requisito non spuntato usando il link nella relativa riga della checklist.
• Il telefono mostra un motivo di rifiuto: destination_not_enabled significa che il paese di destinazione è disabilitato. caller_id_not_verified significa che il numero nella riga From non è verificato. Il riferimento alle chiamate rifiutate copre ogni motivo e la relativa soluzione.
• La chiamata si connette, ma un lato non ha audio: controlla il permesso del microfono nel browser e il selettore del microfono nel telefono. La guida ai controlli in chiamata copre i selettori dei dispositivi.

La risoluzione dei problemi Voice affronta gli stessi sintomi per qualsiasi client.

Passaggi successivi

• Chiamate di test dal terminale: effettua la stessa chiamata con bird voice tools test-call.
• Configura un client SIP: collega Asterisk, FreePBX, Zoiper o un altro client al trunk.
• Configura i trunk SIP: rivedi le impostazioni abilitate dal trunk pronto per le chiamate e altri metodi di ammissione.
• Effettua chiamate: scopri come la piattaforma instrada e tarifica le chiamate.
• Ispeziona il registro chiamate: filtra i record, esamina i campi, recupera le chiamate tramite la API o esporta i dati in CSV.
• Iscriviti agli eventi vocali: invia gli esiti delle chiamate ai tuoi sistemi invece di effettuare polling.