--- title: "Configure um tronco SIP para receber e fazer chamadas" description: "Conecte seu PBX ou SBC ao Bird nesta ordem: crie o tronco, entregue as chamadas recebidas aos seus gateways, libere as chamadas de saída e teste as duas direções." canonical: "https://bird.com/pt-br/documentacao/guides/voice/sip-trunk-setup" --- # 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](/docs/guides/voice/sip-trunks), [Receber chamadas](/docs/guides/voice/receiving-calls) e [Fazer chamadas](/docs/guides/voice/placing-calls). ## 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](/docs/guides/voice/caller-ids). - Um número Bird cujo `status` seja `active`. 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](/docs/guides/numbers/ownership-paperwork). ## 1. Crie o tronco Acesse **Voice** > [**SIP Trunks**](https://bird.com/dashboard/w/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](/docs/guides/voice/receiving-calls#what-a-gateway-needs) 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](/docs/guides/voice/hunt-groups#use-the-automatic-group). 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](/docs/guides/voice/hunt-groups) 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**](https://bird.com/dashboard/w/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](/docs/guides/voice/receiving-calls#set-a-default-route). 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 `bird` e 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](/docs/guides/voice/sip-trunks#controlling-who-may-send-calls). ## 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) ou `5061` (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](/docs/guides/voice/placing-calls#what-bird-expects-on-the-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](/docs/guides/voice/network-requirements). ## 9. Ative os países para os quais você liga Acesse **Voice** > [**Destinations**](https://bird.com/dashboard/w/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](/docs/guides/voice/destinations). ## 10. Teste as duas direções 1. **Entrada:** ligue para o seu número Bird de um telefone comum e, em seguida, acesse **Voice** > [**Legs**](https://bird.com/dashboard/w/voice/legs) no mesmo espaço de trabalho. 2. **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. 3. 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](/docs/guides/voice/troubleshooting), que parte do sintoma. ## Próximos passos | Página | O que aborda | | ----------------------------------------------------------------- | ------------------------------------------------------------------------ | | [Trunks SIP](/docs/guides/voice/sip-trunks) | Todas as configurações do trunk, autenticação e Digest | | [Receber chamadas](/docs/guides/voice/receiving-calls) | Rotas de números, gateways, grupos e a rota padrão do espaço de trabalho | | [Fazer chamadas](/docs/guides/voice/placing-calls) | O que o Bird espera no `INVITE` | | [Solução de problemas de voz](/docs/guides/voice/troubleshooting) | Como diagnosticar uma chamada a partir do sintoma | ## Related resources - [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer) - [Voice](/voice-api) (product) - [Voice overview](/docs/guides/voice/overview) (docs) [Get an implementation brief](/learn/workspace?topic=voice)