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 tem 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, tocar em um grupo de toque de pessoas online no telefone do navegador 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.

• Crie um tronco SIP, ative as chamadas de saída e autorize quem pode fazer chamadas por ele: uma faixa de IPs ou uma chave de API para seu próprio equipamento, credenciais de sessão para um navegador ou a CLI.
• Escolha um identificador de chamadas permitido: 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.
• Habilite 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. Ela mostra o status, os dois números, o tronco pelo qual o trecho entrou, a resposta SIP com a qual terminou, os horários de atendimento e término, o tempo faturável e o custo. Aplique filtros e exporte os registros correspondentes como CSV. O CSV inclui as durações e o tempo faturável, mas não tem uma coluna de custo; consulte as cobranças em Uso, gastos e faturas.
• 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 limites se aplicam às suas chamadas, nos dois sentidos: quantas podem estar em andamento ao mesmo tempo, quantas novas chamadas podem ser feitas por segundo e quanto você pode gastar com voz em um dia UTC. Seu plano Voice define os limites de chamadas simultâneas e por segundo da sua organização: o pagamento conforme o uso utiliza os valores padrão, e os planos Voice superiores os aumentam. O limite de gastos diários funciona de outra forma. Cada espaço de trabalho define seu próprio limite em Voice > Spend limit, e por país em Voice > Destinations, até o máximo da sua organização. Os maiores planos Voice aumentam esse máximo. Uma chamada que ultrapassa qualquer um desses limites é recusada ao ser iniciada, e seu registro informa qual limite foi excedido, em Chamadas rejeitadas. Os valores de cada plano estão na página de preços do Voice; mude para um plano superior em Billing and payments > Overview.

O limite de duração de chamadas da plataforma é de 4 horas. O Bird encerra os dois lados de uma chamada que atinge essa duração, então planeje sessões mais longas em mais de uma chamada. Uma chamada que executa uma sequência de chamadas tem seu tempo contado a partir do momento em que o Bird a aceita ou recebe. Assim, o tempo de espera para discar e o tempo em que o telefone fica tocando consomem parte das 4 horas. Status explica como esse tipo de 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 aumentá-lo.

Próximos passos