Configure um tronco SIP para receber e fazer chamadas
Esta página percorre a configuração completa de um tronco na ordem em que o dashboard a exige. Quando pular uma etapa causa um sintoma visível, a etapa o indica, então você também pode usar a página como checklist quando uma chamada de teste falhar. Para saber o que cada configuração significa, siga os links para Troncos SIP, Receber chamadas e Fazer chamadas.
Antes de começar
- Um espaço de trabalho Bird. Chamadas, números e troncos pertencem a um único espaço de trabalho, então faça todas as etapas no mesmo.
- Os endereços públicos dos seus equipamentos: os hosts aos quais o Bird deve entregar as chamadas e os endereços a partir dos quais seus equipamentos enviam SIP.
- Para chamadas recebidas, um número Bird nesse espaço de trabalho. Para chamadas de saída, um identificador de chamadas: um número Bird no espaço de trabalho ou um número que você verificou.
- Um número Bird cujo
statussejaactive. Um número que ainda aguarda a documentação de titularidade ou o registro não recebe nem faz chamadas: consulte Enviar a documentação de titularidade de um número.
1. Crie o tronco
Acesse Voice > SIP Trunks, selecione Add new SIP trunk, insira um nome e selecione Create trunk.
Um tronco novo não transporta chamadas em nenhuma direção até que você ative cada uma delas.
2. Ative as chamadas de entrada
Em Inbound calling, selecione Enable inbound. A seção Inbound routing aparece logo abaixo.
Se você pular esta etapa, não será possível direcionar números para o tronco, porque ele não aparece na lista de troncos do número.
3. Adicione seus gateways
Em Inbound routing, abra a aba Gateways e selecione Add gateway para cada endereço ao qual a Bird deve entregar as chamadas:
| Campo | O que informar |
|---|---|
| Name | Um rótulo que você reconheça, como Primary SBC |
| Host | O nome do host ou o endereço IP público do seu equipamento, sem sip: nem parte de usuário |
| Port | Deixe vazio para usar a porta padrão do transporte ou informe a porta em que seu equipamento escuta |
| Transport | UDP, TCP ou TLS, de acordo com seu equipamento |
| R-URI user part | Como o número discado é escrito na Request-URI. O padrão é E.164 com + |
| Origination format | Como o número de origem é escrito. O padrão é E.164 com + |
| Priority | A posição do gateway em All gateways (automatic): números menores tocam primeiro, e números iguais dividem as chamadas. O padrão é 0 |
Se seu equipamento espera números sem o + inicial, abra a lista do formato e escolha Without the plus ou um prefixo internacional 00 ou 011. O que um gateway precisa explica os formatos de número.
A Bird repassa o cabeçalho To exatamente como a operadora de quem liga o enviou. Se seu equipamento lê o número discado a partir do To, selecione Rewrite To user part e monte o mesmo formato da R-URI user part. A Bird passa então a substituir a parte de usuário do To nas chamadas para esse gateway.
Seu gateway precisa aceitar chamadas da Bird sem um desafio Digest de SIP, porque a Bird não responde a esse desafio.
4. Escolha o grupo em que as chamadas fazem a busca
A Bird entrega cada chamada a um grupo de gateways. Todo gateway está em All gateways (automatic), que os tenta na ordem da Priority definida na aba Gateways, começando pela menor. Para ter failover por esse grupo, dê ao gateway de backup um número de Priority maior que o do principal. Se a aba Groups não mostrar All gateways (automatic), o roteamento salvo do tronco contém um grupo próprio no lugar dele, e a Priority não ordena esse grupo; consulte Usar o grupo automático.
Quando você adiciona o primeiro gateway a um tronco cujo roteamento nunca foi salvo, o dashboard aponta a rota padrão para All gateways (automatic).
Para usar outros tempos de toque, pesos ou apenas alguns dos gateways, crie seu próprio grupo: na aba Groups, selecione Add group, dê um nome ao grupo e use Add gateway to group para cada gateway. Fazer failover e distribuir chamadas recebidas explica cada ordem, o tempo de toque e quando a busca termina.
5. Aponte a rota padrão para o grupo
Na aba Rules, localize Default route (No rule above matched). Defina Then como Route to group e escolha o seu grupo. Selecione Review and save e depois confirme.
A rota padrão atende toda chamada que nenhuma regra atende, então, sem regras, ela atende todas as chamadas. Se ela estiver definida como Reject, essas chamadas são recusadas antes de chegar ao seu equipamento, mesmo com gateways em um grupo.
Na revisão, o dashboard exibe o aviso Calls never reach some gateways quando um gateway não está em nenhum grupo para o qual uma regra ou a rota padrão envia chamadas. Corrija esse aviso antes de testar.
Essa rota padrão pertence ao trunk. Ela é diferente da configuração do espaço de trabalho Calls to numbers without their own route na página Numbers, que define o que acontece com os números que não têm rota própria.
6. Aponte seus números para o trunk
Acesse Voice > Numbers, abra o número e, em Inbound routing, escolha Deliver to a SIP trunk. Selecione o trunk e salve.
Um número sem rota própria segue a rota padrão do espaço de trabalho, que começa como rejeição. Para enviar todos esses números a este trunk de uma só vez, defina Calls to numbers without their own route como o trunk. Consulte Definir uma rota padrão.
Se você pular esta etapa enquanto a rota padrão do espaço de trabalho ainda for rejeição, as chamadas recebidas são rejeitadas e o campo Inbound route do registro da chamada mostra Reject the leg.
7. Ative as chamadas de saída e defina quem pode enviá-las
Em Outbound calling, selecione Enable outbound. A seção Connection aparece com o SIP domain do trunk. A Bird identifica o seu trunk por esse domínio, então copie-o por inteiro.
Em seguida, adicione pelo menos uma forma de reconhecer seu equipamento:
- Allowed IP addresses: os endereços públicos a partir dos quais seu equipamento envia SIP. Atrás de NAT, use o endereço público do roteador.
- Allowed API keys: para equipamentos que respondem a um desafio Digest, com o nome de usuário
birde o segredo de uma chave API como senha.
Enquanto as chamadas de saída não estiverem ativadas, o tronco recusa todas as chamadas de saída. Enquanto o tronco não conseguir reconhecer seu equipamento, as chamadas são recusadas antes que exista um registro de chamada. Consulte Controlar quem pode enviar chamadas.
8. Configure seu PBX ou SBC
No seu PBX ou SBC:
- Envie as chamadas de saída para o domínio SIP do tronco. Coloque o domínio SIP no host da Request-URI. Use a porta
5060(UDP ou TCP) ou5061(TLS). Uma chamada cujo host da Request-URI tenha qualquer outro nome é recusada. - Disque no formato internacional. Coloque o número chamado na parte de usuário da Request-URI com
+e o código do país, por exemplo+442071234567. Não adicione um prefixo técnico. Consulte O que a Bird espera no INVITE. - Apresente um identificador de chamadas elegível no cabeçalho
From. - Ofereça G.711 (lei A ou lei µ) e envie DTMF como eventos telefônicos RFC 4733. A mesma seção dessa página trata da mídia.
- Libere os endereços da Bird. Se seu firewall ou SBC aceita apenas endereços listados, libere os endereços de sinalização e de mídia da região do seu tronco, listados em Requisitos de rede de troncos SIP.
9. Ative os países para os quais você liga
Acesse Voice > Destinations, marque cada país para o qual você liga e selecione Save changes. Um novo espaço de trabalho começa sem nenhum país habilitado, e uma chamada para um país desabilitado é rejeitada com destination_not_enabled. Consulte Destinos de voz.
10. Teste as duas direções
- Entrada: ligue para o seu número Bird de um telefone comum e, em seguida, acesse Voice > Legs no mesmo espaço de trabalho.
- Saída: faça uma chamada do seu equipamento para qualquer número acessível em um país habilitado, apresentando como identificador de chamada o seu número Bird ou um número verificado. Você não precisa de um segundo número Bird para isso.
- Abra cada leg. Inbound route mostra o que o número foi configurado para fazer. Uma chamada rejeitada mostra o motivo e, quando a correção é uma configuração sua, um link para essa configuração. Uma chamada que funcionou mostra Answered. Guarde o Leg ID caso entre em contato com o suporte.
Se uma chamada estiver ausente, for rejeitada ou nunca chegar ao seu equipamento, siga a Solução de problemas de voz, que parte do sintoma.
Próximos passos
| Página | O que aborda |
|---|---|
| Trunks SIP | Todas as configurações do trunk, autenticação e Digest |
| Receber chamadas | Rotas de números, gateways, grupos e a rota padrão do espaço de trabalho |
| Fazer chamadas | O que o Bird espera no INVITE |
| Solução de problemas de voz | Como diagnosticar uma chamada a partir do sintoma |
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.