Visão geral do Voice

O Bird Voice permite ligar para números de telefone e atender chamadas feitas para números que você possui. Conecte um sistema telefônico por SIP, faça uma chamada pelo navegador ou use o construtor de sequências para executar um fluxo de chamada salvo. O Bird conecta chamadas à rede pública de telefonia, a PSTN.

A conexão entre seu sistema telefônico e o Bird é um trunk SIP. O SIP (Session Initiation Protocol) estabelece chamadas entre sistemas telefônicos. O Bird fornece ao seu espaço de trabalho um endereço de trunk, que seu sistema telefônico usa para chamadas de saída para a rede telefônica, e que o Bird usa no sentido inverso para entregar as chamadas que chegam nos seus números.

Você não precisa de um sistema telefônico para fazer a primeira chamada: o telefone no dashboard faz uma direto do navegador, por um dos seus trunks.

Você também pode criar uma sequência no dashboard e iniciá-la com a API Create Call. A sequência cuida das mensagens de voz, das opções do teclado e do roteamento da chamada depois que o destinatário atende.

Como uma chamada é feita

Seu sistema telefônico envia um SIP INVITE para o endereço do trunk para iniciar uma chamada. O Bird verifica o caller ID, o país de destino, os limites e o saldo da carteira antes de contatar uma operadora. Se a chamada passar, o Bird a roteia e retransmite o áudio. Cada conexão é um trecho. Quando um trecho termina, o Bird grava seu registro em Voice > Legs e emite um voice_call.ended evento.

Uma chamada que falha em uma verificação é recusada antes de uma operadora ser envolvida, e o motivo específico é registrado no registro do trecho. Fazer chamadas descreve o que o Bird lê de cada chamada, e Chamadas rejeitadas lista todos os motivos de recusa e o que fazer a respeito.

Como uma chamada de entrada é atendida

Um número que seu espaço de trabalho possui carrega uma resposta por vez, definida no próprio número ou, quando ele não tem nenhuma, herdada da rota padrão do espaço de trabalho: entregar a chamada a um dos seus trunks SIP, encaminhá-la para um número que você verificou, executar uma sequência publicada ou rejeitá-la. A rota padrão começa como rejeitar, então um número que ninguém configurou recusa os chamadores.

Quando uma chamada chega, o Bird verifica os limites da conta e a carteira da mesma forma que faz para uma chamada que você realiza, depois age conforme a resposta do número e registra qual era essa resposta na chamada. Receber chamadas explica como direcionar um número a uma resposta, o que um encaminhamento apresenta a quem atende, e como interpretar uma recusa.

Antes da sua primeira chamada

Para chamadas pelo seu próprio equipamento SIP, prepare os itens a seguir. As chamadas pela API seguem os pré-requisitos de Create Call.

1. Criar um trunk SIP, ativar chamadas de saída e autorizar chamadores nele: um intervalo de IP ou uma chave API para seu próprio equipamento, credenciais de sessão para um navegador ou o CLI.
2. Escolher um caller ID elegível: use um número que seu espaço de trabalho possui pelo Bird, ou registre um número externo e confirme-o com uma chamada de verificação.
3. Habilitar seus destinos: ative os países para os quais você liga.

Faça sua primeira chamada percorre os três requisitos e termina com uma chamada real.

Ler registros de chamadas requer voice:read; fazer chamadas requer voice:write. Gerenciar trunks, rotas de números, caller IDs e sequências usa permissões voice_management. O acesso a uma página não concede permissão para alterar suas configurações ou fazer uma chamada faturável.

O app Voice no dashboard

Visibilidade

Uma chamada pode conter múltiplos trechos. O log tem um registro por trecho, seja ele conectado, expirado sem resposta ou recusado. Chamadas encaminhadas ou com múltiplas partes podem, portanto, ter várias entradas:

• Registro de trechos: a visualização por trecho na página Legs. Status, ambos os números, o trunk pelo qual o trecho entrou, a resposta SIP com que terminou, horários de atendimento e encerramento, tempo faturável e custo. Filtre e exporte o resultado como CSV.
• Eventos de voz: voice_call.initiated, voice_call.answered e voice_call.ended entregues ao seu próprio endpoint, para que seus sistemas saibam de uma chamada sem precisar consultar.

A referência API lista os contratos HTTP públicos suportados e os métodos SDK. A referência CLI e a referência da ferramenta MCP descrevem suas operações publicadas. Essas superfícies podem expor operações diferentes; uma ação no dashboard ou um comando CLI não estabelece por si só um método SDK público.

Limites

Três tetos se aplicam às suas chamadas, em ambas as direções: quantas você pode ter em andamento ao mesmo tempo, quantas novas chamadas por segundo, e quanto você pode gastar com voz em um dia UTC. Cada um é definido por organização, e os valores dependem do seu plano. Uma chamada que ultrapasse qualquer um deles é recusada no estabelecimento, e o registro indica qual foi o limite, em Chamadas rejeitadas.

O limite de duração da plataforma é de 3 horas. O Bird encerra ambos os lados de uma chamada que atinge essa duração, então planeje uma sessão mais longa como mais de uma chamada. Uma chamada que executa uma sequência de chamada conta a partir de quando o Bird a aceitou ou recebeu, então o tempo gasto esperando para discar e tocando consome parte das 3 horas. Status explica como essa chamada aparece no log.

O teto por segundo é a política voice_call em Limites de requisições, que também explica como seu limite efetivo é calculado e como solicitar mais capacidade.

Próximos passos