Sign inGet started

Realizando chamadas

Seu PBX, o sistema telefônico corporativo que roteia chamadas, envia um SIP INVITE para o domínio SIP do trunk para realizar uma chamada. Bird verifica a solicitação, roteia para uma operadora e retransmite o áudio. Esta página cobre os pré-requisitos, campos da solicitação, autenticação e custo.

Antes de realizar uma chamada

Quatro coisas precisam estar prontas, em qualquer ordem, e três delas são você quem configura:
  • Um trunk que aceita seu tráfego. Crie um trunk SIP e habilite chamadas de saída. Adicione os intervalos de IP do seu equipamento, uma chave API permitida, ou ambos. Clientes que não conseguem manter um segredo de longa duração podem usar uma credencial de sessão.
  • Um caller ID verificado. Registre o número que você apresenta e conclua a chamada de verificação, que é como um espaço de trabalho comprova que possui os números que apresenta. A verificação não garante a entrega ponta a ponta do CLI nem a conexão da chamada quando o CLI não é um número adquirido pelo Bird: veja o aviso de verificação e entrega do CLI.
  • O país de destino habilitado. Ative os países que você atende na página Destinations.
  • Roteamento vinculado ao seu espaço de trabalho. Bird configura isso para você, escolhendo quais operadoras atendem quais destinos. Até que esteja pronto, chamadas são recusadas com routing_not_configured, um dos motivos que Chamadas rejeitadas cobre.

O que Bird espera no INVITE

Envie a solicitação para o domínio SIP do seu trunk em uma das portas suportadas. Dois cabeçalhos carregam tudo que Bird precisa:
CabeçalhoO que Bird faz com ele
ToO número sendo chamado. Bird lê o país para escolher uma operadora e tarifar a chamada
FromO número que você está apresentando como chamador. Deve ser um caller ID verificado neste espaço de trabalho
Use números internacionais completos no formato E.164, um + inicial seguido do código do país e do número nacional, em ambos os cabeçalhos. Essa é a forma que Bird registra na chamada e a forma que sua correspondência de destino espera.
Além desses dois cabeçalhos, esta é uma chamada SIP comum, sem cabeçalhos personalizados em nenhuma direção.

Autenticando cada chamada

O que uma chamada passa depende de como o trunk está configurado:
  • Apenas lista de IPs permitidos. Uma única solicitação. Bird compara o endereço de origem com a lista e roteia a chamada, sem desafio a responder.
  • Apenas chaves API permitidas. Bird solicita uma senha primeiro, por meio da troca Digest SIP.
  • Ambos. O endereço de origem é verificado antes de Bird lançar qualquer desafio, então uma chamada de um endereço não listado é recusada independentemente das credenciais que carrega.
  • Credenciais de sessão ativadas. Bird desafia a chamada independentemente da origem, mesmo de um endereço não coberto pela lista de permitidos, e uma credencial emitida minutos antes responde. Equipamentos já admitidos pela lista de permitidos em um trunk sem chaves permitidas continuam conectando sem desafio.
Quando o trunk possui chaves API permitidas, seu sistema telefônico responde com um hash do segredo da chave API em vez do segredo em si, que é o que a autenticação Digest SIP faz:
  1. Seu PBX envia o INVITE.
  2. Bird responde 407 Proxy Authentication Required com uma linha de desafio por algoritmo que o trunk oferece, SHA-256 e depois MD5 por padrão.
  3. Seu PBX reenvia o INVITE com um cabeçalho Proxy-Authorization calculado com o nome de usuário bird e o segredo da chave API como senha.
  4. Bird verifica a resposta e continua o roteamento.
Um cabeçalho Proxy-Authorization preemptivo é enviado antes do desafio, então seu equipamento deve escolher um algoritmo que o trunk oferece. Se o trunk também tiver uma lista de IPs permitidos, a solicitação ainda deve vir de um endereço listado.
Bird responde a um handshake falho na camada SIP, então a tentativa é barrada antes de a plataforma criar um registro de chamada. Se suas chamadas estão completamente ausentes do Log de chamadas, verifique as credenciais em vez do roteamento.

Atestação de chamadas

Chamadas para os Estados Unidos e a França carregam atestação STIR/SHAKEN. Operadoras usam essa assinatura ao rotular chamadas. Bird aplica o nível B por padrão sem configuração adicional. Entre em contato com o suporte para solicitar o nível A.

Quando uma chamada é recusada

Bird verifica o caller ID, destino, limites e saldo da carteira antes de discar para uma operadora. A recusa chega ao seu sistema telefônico como SIP 503; a causa específica fica no registro de chamada autenticado. Abra a chamada no log de chamadas, ou veja chamadas rejeitadas para cada motivo e resolução.
Resolva a causa registrada antes de tentar novamente. Por exemplo, calls_per_second_exceeded continua até você reduzir a taxa de discagem.

Chamadas de emergência não são realizadas

Bird Voice não realiza chamadas para serviços de emergência. Uma chamada para 112, 911, 999 ou qualquer outro número de emergência é recusada, em todos os trunks, em todos os países. Seu sistema telefônico deve alcançar serviços de emergência por outra rota.
Esse comportamento não depende do seu plano, saldo ou destinos. Configure seu sistema telefônico para rotear chamadas de emergência por um serviço que as suporte, como uma linha PSTN local, gateway local ou outro provedor. Teste essa rota. Bird retorna 503 para uma chamada de emergência recusada, permitindo que um sistema telefônico com outra rota no plano de discagem tente por ela.
Serviços de emergência dependem da localização registrada do chamador, que Bird não armazena para um trunk. Não confie em uma rota Bird para chamadas de emergência.

Custo e faturamento

Voice é pré-pago a partir da carteira da sua organização, como os outros canais:
  • O tempo faturável vai do atendimento ao encerramento, independentemente de quanto tempo a chamada tocou antes. O registro da chamada mostra isso ao lado de Duração total, que conta a partir do momento em que Bird recebeu a chamada.
  • A tarifa depende do país de destino. Seu cartão de tarifas precifica cada país na moeda da carteira. Uma tarifa define um tempo mínimo faturado e o incremento usado após esse mínimo. Por exemplo, uma tarifa com mínimo de um minuto e incrementos de seis segundos fatura uma chamada de 10 segundos como um minuto.
  • A carteira é verificada antes de discar para a operadora. Uma chamada que seu saldo não cobre é recusada com insufficient_balance antecipadamente, em vez de ser cobrada depois. Mantenha uma reserva ou ative recargas automáticas.
  • Um limite diário de gasto com voz se aplica. Após atingi-lo, chamadas são recusadas com daily_spend_exceeded até o próximo dia UTC começar. O valor depende do seu plano.
  • O custo aparece na chamada assim que ela é tarifada, com precisão total, líquido de impostos.
Para totalizar o gasto entre chamadas, exporte a lista filtrada de chamadas como CSV na página Calls, ou consulte suas faturas e uso.

Próximos passos

PáginaO que cobre
Log de chamadasNavegação, filtragem e exportação dos seus registros de chamada
Eventos de vozRecebendo resultados de chamadas enviados para seus próprios sistemas
Métodos de pagamento e carteiraRecargas, recargas automáticas e como a carteira é consumida

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Obtenha um resumo de implementação