Faça sua primeira chamada

Faça uma chamada telefônica real a partir do 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 as permissões voice:write e voice_management:read.
• Um número de telefone que você possui 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. O checklist identifica cada requisito pendente e contém um link para a ação necessária. Criar um trunk pronto para chamadas e verificar um identificador de chamadas completa o checklist.

2. Crie um trunk pronto para chamadas

Selecione Create a trunk no 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. O checklist marca todos os requisitos do trunk como concluídos.

3. Verifique seu identificador de chamadas

Selecione Verify a number you own no checklist. Insira um número que você possui no campo Phone number usando o 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 você tem áudio bidirecional. Para encerrar a chamada pelo dashboard, selecione Hang up.

6. Inspecione o registro da chamada

Abra Voice > Legs. A página lista as 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, sua duração faturável e seu custo após a tarifação ser concluída.

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

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: Complete cada requisito pendente usando o link na linha do checklist correspondente.
• 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 dos lados não tem áudio: Verifique a permissão de microfone do seu 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.