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 l'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 hai accesso Voice al livello Write.
- 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, poi 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 completato ogni requisito 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 usando il formato E.164: un + iniziale, il prefisso internazionale e il numero nazionale. Poi seleziona Send verification call.
Rispondi alla chiamata di verifica e ascolta il codice a sei cifre. Inseriscilo nel campo Verification code, poi 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 componga il numero tramite un carrier.
5. Effettua la chiamata
Inserisci il numero che hai verificato nella riga To, poi 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 > Calls. La pagina elenca le chiamate per orario di inizio, dalla più recente, quindi la tua chiamata appare nella prima riga. Selezionala per ispezionare quando è stata risposta, la sua durata fatturabile e il suo costo al termine della tariffazione.
Gli stessi record delle chiamate sono disponibili tramite l'API:
for await (const call of bird.voice.list({ status: ["ringing", "in_progress"] })) {
console.log(call.id, call.status);
}for call in client.voice.list(status=["ringing", "in_progress"]):
print(call.id, call.status)for call, err := range client.Voice.List(context.Background(), bird.VoiceListParams{
Status: []bird.VoiceCallStatus{"ringing", "in_progress"},
}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(call.Id, call.Status)
}foreach ($bird->voice->list(['status' => ['ringing', 'in_progress']]) as $call) {
echo $call->getId(), ' ', $call->getStatus(), "\n";
}bird voice list{
"name": "voice_list"
}curl -X GET "https://{region}.platform.bird.com/v1/voice/calls" \
-H "Authorization: Bearer $TOKEN" \
--url-query "limit=25"Usa il record della chiamata per indagare su futuri errori di chiamata. Una chiamata rifiutata registra la propria causa in rejection_reason. Per filtri della dashboard, campi del record e accesso API, consulta la guida al registro chiamate.
Risolvi i 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 risoluzione.
- 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 descrive i selettori dei dispositivi.
Risoluzione dei problemi Voice analizza 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: esamina 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 l'API o esporta dati CSV.
- Iscriviti agli eventi vocali: invia gli esiti delle chiamate ai tuoi sistemi invece di effettuare polling.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Comprendi il concettoWhat is a voice API?Esplora la funzionalitàVoiceGuida all'implementazioneVoice overview
Ottieni un brief di implementazione