Configurar um cliente de teste para o Roteamento Direto do Microsoft Teams com o Azure Communications Gateway

  • Artigo

O teste do Roteamento Direto do Microsoft Teams requer alguns números de teste em um locatário do Microsoft 365, como se você estivesse prestando serviço a um cliente real. Chamamos esse locatário (que você controla) de locatário cliente de teste, correspondente ao seu cliente de teste (ao qual você aloca os números de teste). A configuração de um cliente de teste requer configuração no locatário do cliente de teste e no Azure Communications Gateway. Este artigo explica como configurar essa configuração. Em seguida, você pode configurar usuários e números de teste no locatário e iniciar o teste.

Gorjeta

Quando você integra um cliente real, normalmente precisará pedir que ele altere a configuração do locatário, porque sua organização não terá permissão. Você ainda precisará fazer alterações de configuração no Azure Communications Gateway.

Para obter mais informações sobre como o Azure Communications Gateway e o Microsoft Teams usam a configuração de locatário para rotear chamadas, consulte Suporte para vários clientes com o modelo multilocatário do Microsoft Teams.

Este artigo fornece orientação detalhada equivalente às etapas a seguir na documentação do Microsoft Teams para configurar um SBC para vários locatários.

  • Registrar um nome de subdomínio no locatário do cliente.
  • Configuração de troncos derivados no locatário do cliente (incluindo failover).

Pré-requisitos

Você deve ter um locatário do Microsoft 365 que possa ser usado como cliente de teste. Você deve ter pelo menos um número que você pode alocar para este cliente de teste.

Você deve concluir os procedimentos a seguir.

Você deve provisionar o Azure Communications Gateway com os detalhes do locatário do cliente de teste durante este procedimento.

  • Para usar o Portal de Gerenciamento de Números do Azure Communications Gateway (visualização) para provisionamento (recomendado), você deve ter acesso de Leitor ao recurso do Gateway de Comunicação do Azure e às funções ProvisioningAPI.ReadUser e ProvisioningAPI.WriteUser para o aplicativo empresarial AzureCommunicationsGateway.
  • Para usar a API de provisionamento do Azure Communications Gateway (visualização), você deve ser capaz de fazer solicitações usando um cliente integrado à API. Você também deve ter acesso à Referência da API.

Tem de conseguir iniciar sessão no centro de administração do Microsoft 365 para o seu inquilino de cliente de teste como Administrador Global.

Você deve ser capaz de configurar o locatário com pelo menos duas contas de usuário ou recurso licenciadas para o Microsoft Teams. Para obter mais informações sobre licenças adequadas, consulte a documentação do Microsoft Teams.

Escolha um rótulo de subdomínio DNS para usar para identificar o cliente

O Azure Communications Gateway tem nomes de domínio por região para se conectar ao Roteamento Direto do Microsoft Teams. Você precisa configurar subdomínios desses nomes de domínio para seu cliente de teste. O Microsoft Phone System e o Azure Communications Gateway usam esses subdomínios para fazer a correspondência entre chamadas e locatários.

  1. Calcule os nomes de domínio por região para se conectar ao Roteamento Direto do Microsoft Teams. Estes utilizam o formulário 1-r<region-number>.<base-domain-name>. O nome de domínio base é o Domínio no recurso do Azure Communications Gateway no portal do Azure.
  2. Escolha um rótulo DNS para identificar o cliente de teste.
    • O rótulo deve ter até oito caracteres e só pode conter letras, números, sublinhados e traços.
    • Você não deve usar subdomínios curinga ou subdomínios com vários rótulos.
    • Por exemplo, você pode alocar o rótulo test.

    Importante

    Os subdomínios completos do cliente (incluindo os nomes de domínio por região) devem ter no máximo 48 caracteres. Microsoft Entra ID não suporta nomes de domínio de mais de 48 caracteres. Por exemplo, o subdomínio contoso1.1-r1.a1b2c3d4e5f6g7h8.commsgw.azure.com do cliente tem 48 caracteres.

  3. Use esse rótulo para criar um subdomínio de cliente de cada nome de domínio por região para seu Gateway de Comunicação do Azure.
  4. Anote o rótulo escolhido e os subdomínios de cliente correspondentes.

Por exemplo:

  • Seu nome de domínio base pode ser <deployment-id>.commsgw.azure.com, onde <deployment-id> é gerado automaticamente e exclusivo para a implantação.
  • Seus nomes de domínio por região são, portanto:
    • 1-r1.<deployment-id>.commsgw.azure.com
    • 1-r2.<deployment-id>.commsgw.azure.com
  • Se você alocar o rótulo, testesse rótulo combinado com os nomes de domínio por região criará os seguintes subdomínios de cliente para seu cliente de teste:
    • test.1-r1.<deployment-id>.commsgw.azure.com
    • test.1-r2.<deployment-id>.commsgw.azure.com

Importante

Os nomes de domínio por região para conexão com o Microsoft Teams Direct Routing são diferentes dos nomes de domínio por região para conexão à sua rede.

Gorjeta

As implantações de laboratório têm um nome de domínio por região. Portanto, seu cliente de teste também tem apenas um subdomínio de cliente.

Comece a registrar os subdomínios no locatário do cliente e obtenha valores TXT de DNS

Para rotear chamadas para um locatário do cliente, o locatário do cliente deve ser configurado com os subdomínios do cliente que você alocou em Escolha um rótulo de subdomínio DNS para usar para identificar o cliente. O Microsoft 365 exige que você (como operadora) crie registros DNS que usem um código de verificação do locatário do cliente.

  1. Entre no Centro de administração do Microsoft 365 para o locatário do cliente como Administrador Global.
  2. Usando Adicionar um subdomínio ao locatário do cliente e verifique-o:
    1. Registre o primeiro subdomínio do cliente (por exemplo test.1-r1.<deployment-id>.commsgw.azure.com).
    2. Inicie o processo de verificação usando registros TXT.
    3. Observe o valor TXT que o Microsoft 365 fornece.
  3. (Somente implantações de produção) Repita a etapa anterior para o segundo subdomínio do cliente.

Importante

Ainda não concluiu o processo de verificação. Você deve executar Configurar o cliente no Azure Communications Gateway e gerar registros DNS primeiro.

Configurar o cliente no Azure Communications Gateway e gerar registros DNS

O Azure Communications Gateway inclui um servidor DNS. Você deve usar o Azure Communications Gateway para criar os registros DNS necessários para verificar os subdomínios do cliente. Para gerar os registros, provisione os detalhes do locatário do cliente e os valores TXT do DNS no Azure Communications Gateway.

Você pode usar o Portal de Gerenciamento de Números do Azure Communications Gateway (visualização) ou a API de Provisionamento (visualização).

  1. Na página de visão geral do recurso do Communications Gateway, localize a seção Gerenciamento de números na barra lateral.
  2. Selecione Contas.
  3. Selecione Criar conta.
  4. Insira um nome de conta e marque a caixa de seleção Habilitar roteamento direto do Teams.
  5. Defina o ID do locatário do Teams como o ID do locatário do cliente de teste.
  6. Opcionalmente, selecione Ativar triagem de chamadas. Essa triagem garante que os clientes só possam fazer chamadas de Roteamento Direto a partir de números atribuídos a eles.
  7. Defina Subdomínio como o rótulo do subdomínio escolhido em Escolha um rótulo de subdomínio DNS a ser usado para identificar o cliente (por exemplo, test).
  8. Defina os campos de região de token de subdomínio para os valores TXT obtidos em Iniciar o registro dos subdomínios no locatário do cliente e obter valores TXT de DNS.
  9. Selecione Criar.
  10. Confirme se os registos DNS foram gerados.
    1. No painel Contas, selecione o nome da conta na lista.
    2. Confirme se o Estado Provisionado do Subdomínio é Provisionado.

Concluir a verificação dos domínios no locatário do cliente

Quando tiver utilizado o Azure Communications Gateway para gerar os registos DNS para os subdomínios do cliente, verifique os subdomínios no centro de administração do Microsoft 365 para o inquilino do cliente.

  1. Entre no Centro de administração do Microsoft 365 para o locatário do cliente como Administrador Global.
  2. Selecione Configurações>Domínios.
  3. Conclua a verificação dos subdomínios do cliente seguindo Adicionar um subdomínio ao locatário do cliente e verifique-o.

Ativar os domínios no locatário do cliente

Para ativar os subdomínios do cliente no Microsoft 365, configure pelo menos uma conta de usuário ou recurso licenciada para o Microsoft Teams para cada nome de domínio. Para obter informações sobre as licenças que você pode usar e instruções, consulte Ativar o nome do subdomínio.

Importante

Certifique-se de que as contas usam os subdomínios do cliente (por exemplo, test.1-r1.<deployment-id>.commsgw.azure.com), em vez de quaisquer nomes de domínio existentes no locatário.

Configurar o roteamento de chamadas do locatário do cliente para usar o Azure Communications Gateway

No locatário do cliente, configure uma política de roteamento de chamadas (também chamada de política de roteamento de voz) com uma rota de voz que roteie chamadas para o Azure Communications Gateway.

  • Defina o gateway PSTN para os subdomínios do cliente para o Azure Communications Gateway (por exemplo, test.1-r1.<deployment-id>.commsgw.azure.com e test.1-r2.<deployment-id>.commsgw.azure.com). Esta etapa configura troncos derivados para o locatário do cliente, conforme descrito na documentação do Microsoft Teams para criar troncos e provisionar usuários para vários locatários.
  • Não configure nenhum usuário para usar a política de roteamento de chamadas ainda.

Importante

Você deve usar o PowerShell para definir os gateways PSTN para a rota de voz, porque o Centro de Administração do Microsoft Teams não oferece suporte à adição de troncos derivados. Você pode usar o Centro de Administração do Microsoft Teams para todas as outras configurações de rota de voz.

Para definir os gateways PSTN para uma rota de voz, use o seguinte comando do PowerShell.

Set-CsOnlineVoiceRoute -id "<voice-route-id>" -OnlinePstnGatewayList <customer-subdomain-1>, <customer-subdomain-2>

Próximo passo

Configurar números de teste