Faça sua primeira chamada

Faça uma chamada telefônica real pelo dashboard. O telefone do dashboard é um cliente SIP que usa o mesmo trunk, identificador de chamadas e configurações de destino do seu sistema telefônico.

Após a chamada, você pode inspecionar o registro dela no dashboard ou pela API de Voice.

Pré-requisitos

Antes de começar, verifique se você tem:

Um espaço de trabalho com Phone em Voice. O dashboard exibe essa opção quando a região do seu espaço de trabalho suporta chamadas pelo navegador e você tem acesso a Voice no nível Write.
Um número de telefone próprio e um telefone que possa atender as chamadas de verificação e teste.
Um navegador com um microfone funcionando.

1. Abra o telefone

Selecione Voice > Phone no dashboard. O telefone abre em uma janela flutuante e permanece aberto enquanto você navega.

Se o seu espaço de trabalho não estiver pronto para fazer chamadas, o telefone exibe Finish setup to place calls. A checklist identifica cada requisito pendente e tem um link para a ação necessária. Criar um trunk pronto para chamadas e verificar um identificador de chamadas conclui a checklist.

2. Crie um trunk pronto para chamadas

Selecione Create a trunk na checklist. Insira um nome e selecione Create trunk.

O dashboard habilita chamadas de saída e credenciais de sessão ao criar o trunk. O trunk também oferece o digest MD5 que o navegador utiliza. A checklist marca todos os requisitos do trunk como concluídos.

3. Verifique seu identificador de chamadas

Selecione Verify a number you own na checklist. Insira um número próprio no campo Phone number no formato E.164: um + inicial, o código do país e o número nacional. Em seguida, selecione Send verification call.

Atenda a chamada de verificação e ouça o código de seis dígitos. Insira-o no campo Verification code e selecione Verify caller ID.

O dashboard exibe Caller ID verified, remove o aviso de configuração e adiciona o número à linha From do telefone.

4. Habilite o país de destino

Abra Voice > Destinations. Encontre o país para o qual você pretende ligar e ative o botão correspondente.

Chamadas para países desabilitados são rejeitadas antes de a plataforma discar para uma operadora.

5. Faça a chamada

Insira o número que você verificou na linha To e selecione Call. Se o navegador solicitar acesso ao microfone, permita.

Seu telefone toca e exibe o identificador de chamadas verificado. Atenda a chamada e confirme que há áudio bidirecional. Para encerrar a chamada pelo dashboard, selecione Hang up.

6. Inspecione o registro da chamada

Abra Voice > Calls. A página lista chamadas por horário de início, da mais recente para a mais antiga, então sua chamada aparece na primeira linha. Selecione-a para inspecionar quando foi atendida, a duração faturável e o custo após a tarifação ser concluída.

Os mesmos registros de chamadas estão disponíveis pela 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"

Use o registro da chamada para investigar falhas futuras. Uma chamada recusada armazena a causa em rejection_reason. Para filtros do dashboard, campos do registro e acesso pela API, consulte o guia de log de chamadas.

Solucione problemas na chamada de teste

O telefone ainda exibe Finish setup to place calls: conclua cada requisito pendente usando o link na linha correspondente da checklist.
O telefone exibe um motivo de rejeição: destination_not_enabled significa que o país de destino está desabilitado. caller_id_not_verified significa que o número na linha From não está verificado. A referência de chamadas rejeitadas cobre todos os motivos e suas resoluções.
A chamada conecta, mas um lado não tem áudio: verifique a permissão de microfone do navegador e o seletor de microfone no telefone. O guia de controles durante a chamada cobre os seletores de dispositivo.

Solução de problemas de Voice aborda os mesmos sintomas para qualquer cliente.

Próximos passos

Chamadas de teste pelo terminal: faça a mesma chamada com bird voice tools test-call.
Configure um cliente SIP: conecte Asterisk, FreePBX, Zoiper ou outro cliente ao trunk.
Configure trunks SIP: revise as configurações habilitadas pelo trunk pronto para chamadas e outros métodos de admissão.
Faça chamadas: entenda como a plataforma roteia e precifica chamadas.
Inspecione o log de chamadas: filtre registros, revise campos, recupere chamadas pela API ou exporte dados em CSV.
Assine eventos de voz: envie resultados de chamadas para seus sistemas em vez de fazer polling.

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Entenda o conceitoWhat is a voice API?Explore a funcionalidadeVoice Guia de implementaçãoVoice overview

Obtenha um resumo de implementação