Configurando o Microsoft Teams Direct Routing

Introdução

O 3CX Enterprise Edition para chamadas de 16 sim e acima oferece a integração do Teams Direct Routing. Isso permite que os usuários da equipe liguem e sejam chamados por usuários do 3CX.

Passo 1: Verifique os Requisitos

• Você precisará de um certificado SSL de uma das autoridades de certificação aprovadas pela Microsoft.
• Integração configurada do Microsoft 365.
• Os usuários do MS365 devem ter o número de “Telefone comercial” em formato E.164.
• O domínio para equipes FQDN deve ser registrado em Domínios do locatário MS365.
• *.onmicrosoft.com não é suportado como o nome FQDN do SBC.
• A porta 5062 (ou 5061 em alguns casos) deve ser aberta no firewall.
• Uma das seguintes licenças deve ser atribuída aos usuários do MS365:

• Microsoft 365 E1/E3/E5/A5/G5
• Plano Microsoft Teams + Microsoft Phone System (add-on) ou Business Voice (add-on)
• Consulte a Microsoft para obter as regras mais recentes de licenciamento do Teams. Elas variam de acordo com a região e mudam rapidamente.

Passo 2: Configure o Teams FQDN

1. Encontre o domínio de sua equipe acessando o centro do portal de administração do Microsoft 365 > Configurações > Domínios. (e.x. Domínio MS365: contoso.com, FQDN Teams pode ser: teams.contoso.com)
2. Faça login em seu Console de Gerenciamento 3CX e vá para “Configurações”> “Integração com Microsoft 365” > guia “Teams Direct Routing” e marque “Habilitar Microsoft Teams Direct Routing”.
3. Especifique um FQDN do Teams que corresponda ao domínio de email do MS365
4. Navegue até o seu provedor de DNS e crie um novo registro A para apontar para o endereço IP público estático de sua instalação 3CX.

Passo 3: Gere uma chave CSR

Para integrar 3CX com 365/Teams, a Microsoft requer um certificado SSL de uma das autoridades de certificação aprovadas pela Microsoft. Para obter um certificado, você primeiro precisa gerar uma chave CSR, na qual o certificado SSL será criado. Criamos uma ferramenta de linha de comando para facilitar esse processo para você:

1. Baixe o OpenSSL e instale.
2. Depois de instalado, execute nosso arquivo de lote CSR e preencha os seguintes detalhes:

1. 3CX (Teams) FQDN (por exemplo equipes.exemplo.com)
2. Unidade de Organização, (por exemplo, TI ou Operações)
3. Código do país (por exemplo, UK, US, AU, DE, FR)
4. Área (por exemplo, Inglaterra)
5. Cidade (por exemplo, Londres)
6. Nome da empresa (por exemplo, Exemplo Ltd)

3. A ferramenta irá gerar a chave privada para a pasta na qual você executou o arquivo no formato de bloco de notas e em um arquivo *.pem. Mantenha este arquivo *.pem, pois ele será carregado no campo 'Chave Privada' do console de gerenciamento 3CX durante o passo 5 deste guia.
4. Navegue até o provedor de certificado de sua escolha para obter o certificado, incluindo todos os certificados intermediários e chave privada da autoridade raiz do certificado. Deve abranger o FQDN das equipes que você especificou.

Nota: alguns provedores não fornecem um único arquivo com o certificado, incluindo os certificados intermediários. Nesse caso, listamos as etapas necessárias em nosso FAQ do Teams.

Passo 4: Obtenha um certificado SSL

Este exemplo utiliza o SSL.com

1. Escolha o nível apropriado de certificado, o SSL Básico será suficiente > Adicionar ao carrinho
2. Assim que a janela ‘Mostrar Transação do Pedido’ for exibida, clique em “Clique aqui para concluir o processamento deste pedido de certificado” na parte superior da tela.
3. Pegue o arquivo do bloco de notas que a ferramenta CSR gerou e copie-o na caixa CSR.
4. Certifique-se de que o campo de nome comum preenchido automaticamente (CN) corresponda corretamente e clique em “Avançar”
5. No estágio ‘Validação de Domínio’, selecione as caixas suspensas e escolha sua opção de validação

6. Navegue até o e-mail de verificação e clique no link contido
7. Insira o código de validação de 20 caracteres e certifique-se de que a barra de validação verde apareça

8. Navegue de volta para o painel SSL.com e escolha a guia ‘Pedido’ na barra de navegação superior
9. Localize o seu certificado SSL e clique no ícone da lupa para expandir e obter mais detalhes

10. Clique para “Baixar” o arquivo Nginx. Você pode receber uma notificação na barra de tarefas perguntando se deseja continuar, clique em “Manter”. Localize o arquivo e renomeie de .chained para .pem

Passo 5: Faça o Upload do Certificado SSL para o 3CX

Depois de criar e baixar o certificado SSL:

1. Se ainda não estiver concluído, clique com o botão direito do mouse no arquivo de certificado e renomeie-o para um tipo de arquivo *.pem.
2. No “Passo 2” no console de gerenciamento 3CX, carregue seu certificado e chave privada gerada usando a ferramenta de geração de CSR na Passo 3 deste guia.

Passo 6: Abra a porta 5062 em seu firewall

Caso o FQDN do Microsoft Teams não seja igual ao FQDN 3CX, você deverá garantir que a porta 5062 esteja aberta. Por exemplo, se você tiver um FQDN 3CX mycompany.3cx.us e um FQDN de equipes de mycompany.onmicrosoft.com, será necessário abrir a porta 5062. Consulte esta seção no FAQ do Teams se você tiver uma política de firewall muito restritiva.

Passo 7: Configure o plano de discagem e execute o script

1. Gere o script a partir do console de gerenciamento.
2. Selecione seu país e código de área nos casos aplicáveis. O script gerado será ajustado para formatar os números discados em cenários como interno, nacional, internacional.
3. Clique em “Gerar plano de discagem” e salve o arquivo PowerShell em seu sistema.
4. Inicie o Windows Powershell como Administrador e certifique-se de que a política de execução esteja definida como Bypass.
5. Mude para a pasta onde o script “teams_dial_plan.ps1” está salvo e execute.
6. Você pode verificar se a configuração está correta e se nenhum erro ocorre abrindo o portal de administração do Microsoft Teams

Passo 8: Execute scripts para usuários

Essa etapa deve ser executada sempre que novos usuários forem criados e receberem uma licença do Teams Phone System.

1. Clique em “Gerar Script de Usuários” e salve o arquivo PowerShell em seu sistema.
2. Os usuários selecionados em "User Sync" que atenderem aos requisitos (licença, formato do número de telefone) serão incluídos no script gerado.
3. Revise o script para quaisquer usuários inválidos que possam ser comentados. Ajuste de acordo e repita as etapas acima.
4. Inicie o Windows Powershell como Administrador e certifique-se de que a política de execução esteja definida como Ignorar inserindo este comando:

5. Vá para a pasta onde o script “map_users.ps1” está salvo e execute.

Veja Também

• Verifique nosso guia de FAQ para algumas respostas a perguntas populares
• Aprenda a configurar a Integração com o Microsoft 365

Última atualização

Este documento foi atualizado pela última vez em 27 de fevereiro de 2024.

https://www.3cx.com.br/docs/microsoft-teams/