Perguntas sobre voz, respondidas.

Bird Voice conecta sistemas telefônicos e aplicações à rede de telefonia. Use trunks SIP, chamadas pelo navegador e sequências de chamadas, ou conecte um runtime de voz com IA. Acompanhe as chamadas por seus registros, sessões e eventos.

Crie um espaço de trabalho, prepare um trunk pronto para chamadas e uma identidade de chamador, e habilite o destino que deseja testar. O tempo de configuração depende do acesso, da verificação e do cliente que você conectar. O guia de primeira chamada orienta você em uma chamada controlada pelo navegador.

Três coisas do seu lado: um tronco SIP com seu equipamento autorizado (por faixa de IP ou chave de API), um identificador de chamadas verificado (o número que você apresenta como chamador) e o país de destino habilitado. O Bird vincula o roteamento ao seu workspace, que é o quarto pré-requisito e acontece do lado do Bird.

Sim. Abra, no seu espaço de trabalho, um número que ofereça suporte a chamadas recebidas e configure sua rota de entrada. Você pode direcionar as chamadas para um tronco SIP com chamadas recebidas habilitadas e um gateway de entrega, ou encaminhá-las para um número verificado como identificador de chamadas. Novos números vêm configurados com uma rota que rejeita chamadas.

Não. Use o telefone do navegador ou um softphone, PBX ou aplicação SIP compatível. Combine o transporte, a autenticação e as configurações de mídia suportados com a configuração do trunk.

Sim. Pode efetuar chamadas a partir da aplicação Telefone no painel usando WebRTC.

Por chamada, a uma tarifa que depende do país de destino. Cada tarifa tem um incremento de faturamento: um tempo mínimo cobrado e, depois, o intervalo ao qual é arredondado. Uma tarifa com mínimo de um minuto e intervalos de seis segundos cobra uma chamada de 10 segundos como um minuto inteiro.

O tempo faturável vai do momento em que o número chamado atende até o momento em que a chamada termina. Revise os componentes de tarifa publicados para o seu caso de uso; aluguel de número e outros serviços configurados são separados do tempo de chamada atendida.

Pré-pago, a partir da carteira da sua organização. O Bird verifica seu saldo antes de discar para a operadora, então uma chamada que sua carteira não pode cobrir é recusada antecipadamente com insufficient_balance em vez de cobrada depois.

Sim. Um teto diário de gastos com voz aplica-se por organização, sendo reiniciado no início de cada dia UTC. Acima dele, as chamadas são recusadas com daily_spend_exceeded. O valor depende do seu plano, e a Bird pode aumentá-lo mediante solicitação.

Abra a chamada no registo de chamadas. O custo aparece no registo assim que for tarifado, com precisão total, líquido de impostos. Para totais de várias chamadas, exporte a lista filtrada como CSV a partir da página de Chamadas, ou consulte as suas faturas e utilização.

Três limites: quantas chamadas você pode ter em andamento ao mesmo tempo (chamadas simultâneas), quantas novas chamadas pode iniciar por segundo (chamadas por segundo) e quanto pode gastar com voz em um dia UTC (gasto diário). Os limites aplicáveis dependem da configuração da sua conta.

A chamada é recusada na configuração, antes de qualquer operadora ser discada. O registro da chamada identifica qual limite foi atingido: concurrent_calls_exceeded, calls_per_second_exceeded ou daily_spend_exceeded. Seu sistema telefônico recebe um SIP 503.

Entre em contato com o suporte informando seu tráfego esperado, destinos e gasto para solicitar uma revisão de limites. Confirme os limites aprovados antes de aumentar o tráfego em produção.

Verifique qual motivo o registro da chamada indica. Um discador pode atingir calls_per_second_exceeded mesmo longe do teto de chamadas simultâneas, porque os dois limites são independentes. Reduza a taxa de discagem e tente novamente; tentar novamente imediatamente resulta na mesma resposta.

Não. O trunking SIP conecta um sistema telefônico compatível ao Bird. Combine as configurações de transporte, autenticação e mídia do trunk com as do cliente que você usa.

Sim. Configure cada direção separadamente. Chamadas de entrada também precisam de um número habilitado para recebimento apontado para o trunk e um gateway de entrega.

Sim, quando seu runtime consegue lidar com a sinalização SIP e a conexão de áudio. A aplicação conversacional controla fala, modelo e ações de negócio; o Bird transporta a conexão telefônica.

Os números apontados para esse trunk voltam a uma rota de rejeição. Reativar o trunk não restaura os vínculos anteriores; revise os números antes de retomar o tráfego.

O Bird Voice não transporta chamadas de emergência. Use um serviço telefônico projetado para esse requisito.

Um SIP trunk é a conexão entre o seu sistema telefónico e a Bird. SIP (Session Initiation Protocol) é a linguagem que os sistemas telefónicos usam para estabelecer chamadas, e um trunk é a linha por onde essas chamadas passam. A Bird atribui ao seu workspace um endereço de trunk, e você aponta o seu sistema telefónico para ele.

A maioria dos workspaces precisa de apenas um. Crie mais quando quiser regras de acesso separadas por local ou por sistema, uma vez que a lista de IPs permitidos, as chaves API autorizadas e as configurações de Digest são todas por trunk.

O domínio SIP do trunk (copiado da página do trunk), o nome de utilizador bird e a palavra-passe (o segredo de uma chave API autorizada no trunk). Envie chamadas para o domínio SIP na porta 5060 (UDP ou TCP) ou 5061 (TLS).

Sim, com uma lista de IPs permitidos, chaves API autorizadas, ou ambos. Adicione os endereços públicos de onde o seu equipamento envia SIP, ou exija que cada chamada se autentique com uma chave API via SIP Digest. Ambos entram em vigor na próxima chamada.

O domínio SIP do trunk deixa de aceitar novas chamadas imediatamente. As chamadas já em curso continuam, e os registos de chamadas feitos através do trunk permanecem no seu registo de chamadas.

O seu PBX envia a chamada, o Bird responde com um desafio 407, e o seu PBX reenvia a chamada com um cabeçalho Proxy-Authorization calculado a partir do nome de utilizador bird e o segredo da sua API key como palavra-passe. O seu PBX envia um hash da palavra-passe, nunca a palavra-passe em si.

SHA-256 e MD5. O Bird oferece SHA-256 primeiro e MD5 em segundo por padrão, e o seu PBX escolhe o primeiro que suporta. Se o seu equipamento apenas suporta MD5 e não lida corretamente com um desafio que começa com SHA-256, defina o trunk apenas para MD5.

Sim. Quando um trunk tem ambos, o endereço de origem é verificado antes de o Bird solicitar uma palavra-passe, pelo que uma chamada de um endereço não listado é recusada independentemente das credenciais que transporta.

Adicione a nova chave ao trunk primeiro, migre o seu equipamento e depois revogue a antiga. Revogar ou eliminar uma chave remove imediatamente a sua capacidade de autenticação em todos os trunks que a permitiam.

Um caller ID é um número de telefone que o seu espaço de trabalho pode apresentar como chamador em chamadas de saída. Bird compara, em cada chamada, o número de origem que seu equipamento insere no cabeçalho From do SIP com essa lista de identidades elegíveis do seu espaço de trabalho, incluindo números qualificados mantidos em Bird e números externos verificados.

Adicione o número no formato internacional E.164 e siga o fluxo de verificação. Atenda a chamada de verificação e insira o código no painel. Use o status exibido no número para confirmar que ele está pronto antes de ligar.

Se as tentativas se esgotaram, utilize Obter um novo código na linha do número para uma nova chamada de verificação. Se o número ainda estiver à espera do código, remova o identificador de chamadas e adicione o número novamente.

Providencie atender a chamada de verificação pelo sistema que recebe chamadas desse número. Se o número não puder receber a verificação, entre em contato com o suporte sobre as verificações de titularidade disponíveis.

A partir desse momento, qualquer chamada que apresente esse número é recusada com caller_id_not_verified. As chamadas já em curso continuam, e os registos de chamadas que usaram o número permanecem inalterados.

A fraude de portagem funciona ao marcar países caros que nunca pretendeu ligar. Os países que ativa são aqueles nos quais pode acumular custos, pelo que deixar tudo o resto desativado limita a sua exposição caso alguém invada o seu sistema telefónico.

Encontre o país na página de Destinos usando a caixa de pesquisa (pesquisa por nome ou código de duas letras) e ative o respetivo botão. A alteração aplica-se a partir desse momento.

As chamadas para países de alto risco são caras, e quem opera o número que marca recebe uma parte do custo. Estes são os países que um atacante visa se invadir um sistema telefónico. Deixe-os desativados a menos que tenha negócios lá, e verifique a tarifa antes de ativar um.

Contacte o suporte para que seja aberto para a sua conta. Available significa que pode ativá-lo; Not supported significa que o Bird não consegue atualmente efetuar chamadas para esse país a partir da sua conta.

Um país disponível ainda pode ter destinos específicos dentro dele que o roteamento ainda não alcança. Compartilhe o ID da chamada com o suporte para investigar a cobertura de destino e a recusa.

Dois cabeçalhos: To (o número sendo chamado) e From (o número que você apresenta como chamador, que deve ser uma identidade de chamador elegível). Ambos devem ser números internacionais completos no formato E.164, um + inicial seguido do código do país e número nacional. Nenhum cabeçalho personalizado é necessário.

STIR/SHAKEN permite que provedores assinem informações de identidade do chamador. A atestação reflete o que o provedor pode verificar sobre o chamador e o número. Isso não garante que a operadora de destino conectará a chamada ou removerá um rótulo de spam.

Abra a chamada no registro de chamadas. Seu sistema telefônico vê apenas um SIP 503 genérico, mas o motivo específico fica no registro da chamada, onde só você pode lê-lo. Um painel acima dos detalhes indica a causa e leva à configuração que a corrige.

Somente quando a causa for eliminada. Uma chamada recusada por calls_per_second_exceeded receberá a mesma resposta até você reduzir a taxa de discagem. Leia o motivo da rejeição antes de tentar novamente.

Não. Significa que a chamada foi conectada. Associe a um evento de negócio confirmado, como uma reserva ou caso resolvido, para avaliar o sucesso da tarefa.

Uma chamada ativa ainda não teve a tarifação concluída. Leia o registro final após o encerramento da chamada e do ciclo de tarifação; um valor ausente não é preço zero.

Verifique a assinatura, elimine entregas duplicadas usando o identificador do webhook e tolere chegadas fora de ordem. Reconcilie o resultado final com o registro da chamada.

Verifique a direção e os filtros do relatório explicitamente. A composição do tráfego e os componentes tarifados aplicáveis podem ser diferentes.

Associe as chamadas tarifadas e suas sessões a resultados confirmados na sua aplicação. Inclua todos os trechos de chamada relevantes e use um período e uma definição de conclusão consistentes.

Para chamadas encerradas: Answered (o número chamado atendeu), No answer (tocou até o tempo de espera se esgotar), Failed (houve uma tentativa de chamada, mas ela não teve sucesso), Rejected (o Bird recusou a chamada antes de encaminhá-la a uma operadora, ou a outra ponta a recusou) e Unknown (não foi possível determinar o resultado).

Uma recusa do Bird aparece como Rejected. Quando presente, o motivo da rejeição identifica a verificação que falhou. Rejected também pode significar que a outra ponta recusou a chamada. Failed significa que houve uma tentativa de chamada, mas ela não teve sucesso; consulte o código de resposta SIP para mais detalhes.

Sim. O separador Live na página de Chamadas lista as chamadas nos seus trunks neste momento, com uma contagem. Uma chamada em direto aparece como Ringing (à espera que o outro lado atenda) ou In progress (conectada). O separador atualiza a cada poucos segundos.

A duração total vai do momento em que Bird recebeu a chamada até o desligamento. O tempo faturável vai do atendimento até o desligamento. A diferença é o tempo de toque sem atendimento, então uma diferença grande merece investigar o que você está discando. Chamadas não atendidas não têm tempo de chamada atendida. Consulte a tabela de tarifas aplicável para outros componentes e cobranças de chamada.

Três formas: descarregar CSV da página de Chamadas (exporta todos os registos que correspondem aos seus filtros atuais, não apenas a página visível), lê-los através da API com uma API key com permissão voice:read, ou usar o Bird CLI com bird voice list.

Três: voice_call.initiated (o Bird aceitou a chamada e iniciou o encaminhamento), voice_call.answered (o número chamado atendeu) e voice_call.ended (a chamada terminou, com o resultado). Uma chamada não atendida nunca emite o evento answered.

Use o evento de encerramento para o status e durações reportados, depois reconcilie o resultado final com o registro da chamada. A publicação de eventos pode falhar, e uma solicitação recusada antes da admissão pode não ter registro de chamada nem eventos. Uma atualização ausente não significa que a chamada ainda está ativa.

Sim. As entregas não são ordenadas, então answered pode chegar após ended. Ordene pelo campo timestamp e deixe um evento que chegou depois, mas com timestamp anterior, perder.

Desduplique pelo cabeçalho HTTP webhook-id. Uma retentativa de entrega ou sinalização pode repetir um evento. A mesma chamada e etapa do ciclo de vida mantêm sua identidade de webhook. Reconcilie uma atualização ausente com o registro da chamada.

O registro da chamada contém o custo e o motivo da rejeição, se houver. O status rejected em voice_call.ended pode significar que o Bird recusou a chamada ou que a outra ponta a recusou. Abra o registro de chamadas para consultar o motivo da rejeição, quando presente; o custo aparece assim que a chamada é tarifada.

Uma chamada que a Bird não consegue admitir é rejeitada na camada SIP, antes de existir um registo. Verifique quatro coisas: o trunk tem um intervalo de IP ou chave API que autoriza o seu equipamento, a chamada chegou de um endereço na lista de IPs permitidos do trunk (atrás de NAT, esse é o endereço público do router), as credenciais Digest estão corretas (nome de utilizador bird, o segredo da chave API correto, um algoritmo que o trunk oferece) e o domínio SIP corresponde exatamente ao domínio do trunk.

Abra a chamada no registo de chamadas. O painel acima dos detalhes indica a causa e aponta para a configuração que a resolve. Os sete motivos que pode corrigir são source_not_allowed, caller_id_not_verified, destination_not_enabled, insufficient_balance, daily_spend_exceeded, concurrent_calls_exceeded e calls_per_second_exceeded.

Alguns equipamentos não lidam bem com um desafio que começa com SHA-256. Defina o algoritmo Digest do trunk apenas como MD5, e o seu PBX receberá um desafio que compreende.

Verifique os endereços de mídia, as regras de firewall e os codecs suportados. Uma causa comum é o NAT enviando mídia para um endereço privado inacessível. Configure o tratamento de NAT ou STUN do cliente e verifique o áudio em ambas as direções.

Pode ser. Bird suporta TLS na porta 5061 para sinalização SIP, pelo que a configuração da chamada é encriptada em trânsito. UDP e TCP na porta 5060 não são encriptados. Escolha o transporte que os seus requisitos de segurança exigem.

Cada evento é assinado com HMAC. Verifique a assinatura com o segredo do seu endpoint antes de agir sobre o payload, e faça a rotação desse segredo a partir do painel sempre que necessário.

Os registros de voz seguem a região de serviço configurada. Revise os termos de processamento de dados e retenção aplicáveis à sua implantação; o roteamento de endpoint da API por si só não descreve todos os locais de processamento ou armazenamento.

Use o escopo voice com nível de escrita em uma chave permitida para autenticar chamadas, e o escopo voice com nível de leitura para ler registros de chamadas. O escopo separado voice_management cobre a configuração. O trunk também aplica suas regras configuradas de chave e origem.

O motivo específico fica no registo da chamada, onde apenas você pode lê-lo. Retornar um 503 genérico na camada SIP impede que alguém que esteja a sondar o seu trunk descubra quais trunks, números e destinos existem.

As certificações e a documentação de segurança estão no Trust Center em trust.bird.com. O acordo de processamento de dados, a declaração de privacidade e a política de utilização aceitável estão publicados em bird.com/legal. Para um questionário de fornecedor, a equipa da sua conta Bird trata disso.

Uma sequência de chamada controla prompts, opções de teclado e gravação dentro de uma ligação telefônica. Um fluxo de automação coordena um processo de negócio mais amplo. Mantenha os dois fluxos de trabalho e suas decisões de publicação separados.

Sim. Combine um prompt falado ou gravado com entrada de teclado e ramificações para dígitos reconhecidos, tempo esgotado e entrada não correspondida.

Não. A coleta por teclado lê dígitos DTMF. Um agente de voz com linguagem natural precisa de um runtime conversacional com comportamento próprio de fala e alternância de turnos.

Chamadas usando uma versão publicada mantêm o conteúdo imutável dessa versão. Novas chamadas usam a versão recém-publicada. Chamadas de teste em rascunho leem a sequência salva mais recente em cada transição e podem observar edições do rascunho.

Não. Ela identifica trabalho aceito. Acompanhe o toque, o atendimento e o resultado final da chamada separadamente, e mantenha tentativas incertas vinculadas à mesma operação.

Não. Um menu telefônico segue opções predefinidas, como dígitos do teclado. Uma conversa por voz com IA interpreta linguagem e gera respostas por meio de um runtime conversacional. Ambos ainda precisam de um design completo de roteamento de chamadas e tratamento de resultados.

Um runtime compatível com SIP pode se conectar por meio do Bird quando sua sinalização, autenticação e comportamento de mídia forem compatíveis. Valide a integração com uma chamada real em ambas as direções antes de migrar o tráfego.

Não. MCP permite que um agente de software autorizado opere ferramentas da conta. Um agente de voz ao vivo precisa adicionalmente de áudio, processamento de fala, alternância de turnos e uma aplicação de conversa.

Conecte essas ações por meio das ferramentas autorizadas da sua aplicação. Trate o status retornado como a fonte da verdade e exija a confirmação adequada do cliente antes de fazer uma alteração.

Meça conexão e conclusão da chamada separadamente do sucesso da tarefa. Acompanhe o resultado de negócio confirmado, a taxa de escalonamento e os motivos de falha observados; uma transcrição ou uma chamada atendida sozinha não comprova conversão.

Não. Configure a rota de entrada do número. Uma rota que rejeita é um resultado explícito, não uma conexão automática a uma equipe ou agente.

Sim, por meio do aplicativo de chamada ou do runtime SIP que você configurar para recebê-la. O número, o tronco de entrada, o gateway e o runtime de conversa precisam estar prontos.

Inspecione os dois trechos correlacionados da chamada. Verifique o destino verificado, o destino habilitado, o roteamento disponível e os limites de conta aplicáveis.

Não. A rota registra o comportamento de tratamento selecionado. O status da chamada e os eventos relacionados informam se esse comportamento foi bem-sucedido.

O encaminhamento cria um trecho de saída além do trecho de chegada. Consulte as tarifas publicadas e os componentes tarifados finais da chamada.

Não. O telefone do painel usa o navegador e um tronco SIP configurado da Bird.

O telefone do painel faz chamadas de saída. Direcione chamadas recebidas para o sistema telefônico ou aplicação projetada para atendê-las.

Sim. Use o teclado para opções DTMF, como um menu IVR ou ramal.

Elas são transportadas e tarifadas como chamadas de voz. Consulte as tarifas publicadas para o destino e verifique o registro final da chamada.

Não. O Bird Voice não realiza chamadas de emergência.

Não. A gravação é uma parte explícita do fluxo configurado. Decida qual fonte suportada capturar e quando a captura começa e termina.

Captura de áudio e transcrição são operações separadas. Solicite a transcrição quando apropriado e inspecione o resultado do processamento.

Sim. O processamento de fala pode terminar depois da chamada telefônica. Mantenha o resultado da chamada e o estado de processamento dos artefatos como coisas distintas.

Não. Uma sessão pode correlacionar várias pernas de chamada, e cada uma pode ter seus próprios artefatos. Inspecione a chamada de origem e a identidade da captura.

Use-a como evidência da conversa. Confirme uma reserva, alteração de pedido ou pagamento no sistema de negócios que executou essa ação.