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. 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, Bird a roteia e retransmite o áudio. Cada conexão é um trecho. Quando um trecho termina, 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 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
Cada número do seu espaço de trabalho tem uma ação configurada por vez para as chamadas recebidas: entregar a chamada a um dos seus trunks SIP, encaminhá-la para um número verificado, executar uma sequência publicada ou rejeitá-la. Todo número novo começa rejeitando chamadas, portanto um número ainda não configurado recusa quem liga.
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.
- 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.
- 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.
- 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
| Página | Para que serve |
|---|---|
| Metrics | Volume de chamadas e taxa de atendimento ao longo do tempo, resultados de chamadas, principais países e divisão entre entrada e saída. Veja Métricas de voz |
| Legs | Registros por trecho das chamadas do espaço de trabalho, com totais de uso do mês |
| Calls | Trechos relacionados e participantes agrupados em uma chamada |
| Numbers | Todos os números que o espaço de trabalho pode usar para voz, e o que cada um faz com uma chamada de entrada |
| SIP Trunks | Seus trunks, o domínio SIP deles, quem pode enviar tráfego para eles e para onde chamadas de entrada são entregues |
| Destinations | Os países para os quais seu espaço de trabalho pode ligar, desativados por padrão |
| Sequences | Criar, visualizar, publicar e inspecionar as execuções de fluxos de chamadas |
| Phone | Um telefone flutuante que faz chamadas pelo navegador, por um dos seus trunks |
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 da chamada, e o registro indica qual foi o limite, em Chamadas rejeitadas.
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
| Página | O que aborda |
|---|---|
| Faça sua primeira chamada | De um espaço de trabalho vazio a um telefone tocando |
| Phone | Ligar pelo dashboard, o que é necessário e o que você pode fazer durante a chamada |
| Trunks SIP | Criar um trunk, seus detalhes de conexão e controlar quem pode enviar |
| Fazer chamadas | O que o Bird espera no INVITE, e quanto custa uma chamada |
| Receber chamadas | Direcionar um número a um trunk ou encaminhamento, e o que é registrado |
| Caller IDs | Registrar um número e provar que você o possui com uma chamada de verificação |
| Destinos de voz | Ativar os países para os quais você liga, e o que alto risco significa |
| Registro de trechos | Navegação, filtragem e exportação dos seus registros de trecho |
| Eventos de voz | Os três eventos de chamada e seus payloads |
| Solução de problemas | Diagnosticar uma chamada que não é completada, a partir do sintoma |
| Webhooks e eventos | Configuração de endpoint, verificação de assinatura, tentativas e replay |
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.