Configurar um cliente de teste para o Roteamento Direto do Microsoft Teams com o Gateway de Comunicações do Azure

  • Artigo

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

Dica

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

Para obter mais informações sobre como o Gateway de Comunicações do Azure 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 diretrizes detalhadas equivalentes à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.
  • Configurar troncos derivados no locatário do cliente (incluindo failover).

Pré-requisitos

Você precisa ter um locatário do Microsoft 365 que possa usar como um cliente de teste. Você precisa ter pelo menos um número que possa alocar para esse cliente de teste.

Você precisa concluir os procedimentos a seguir.

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

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

Você precisa ser capaz de entrar no centro de administração do Microsoft 365 para o locatário do cliente de teste como um administrador global.

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

  • Você precisa de duas contas de usuário ou de recurso para ativar os domínios do Gateway de Comunicações do Azure que você adiciona ao Microsoft 365 seguindo este artigo. As implantações de laboratório exigem uma conta.
  • Você precisa de pelo menos uma conta de usuário para usar para teste posteriormente quando executar Configurar números de teste para o Roteamento Direto do Microsoft Teams com o Gateway de Comunicações do Azure. Você pode reutilizar uma das contas usadas para ativar os domínios ou usar uma conta com um dos outros nomes de domínio para esse locatário.

Escolher um rótulo de subdomínio DNS a ser usado para identificar o cliente

O Gateway de Comunicações do Azure 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 o cliente de teste. O Microsoft Phone System e o Gateway de Comunicações do Azure usam esses subdomínios para corresponder chamadas a locatários.

  1. Determine quais são os nomes de domínio por região para se conectar ao Roteamento Direto do Microsoft Teams, que usam o formato 1-r<region-number>.<base-domain-name>. O nome de domínio base é o Domínio no recurso do Gateway de Comunicações do Azure no portal do Azure.
  2. Escolha um rótulo DNS para identificar o cliente de teste.
    • O rótulo deve ter até oito caracteres de comprimento e pode conter apenas letras, números, sublinhados e traços.
    • Você não pode usar subdomínios curinga nem 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. O Microsoft Entra ID não dá suporte a nomes de domínio de mais de 48 caracteres. Por exemplo, o subdomínio de cliente contoso1.1-r1.a1b2c3d4e5f6g7h8.commsgw.azure.com 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 o Gateway de Comunicações 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, no qual <deployment-id> é gerado automaticamente e exclusivo para a implantação.
  • Os 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 test, esse rótulo combinado com os nomes de domínio por região criará os seguintes subdomínios de cliente para o 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 se conectar ao Roteamento Direto do Microsoft Teams são diferentes dos nomes de domínio por região para se conectar à sua rede.

Dica

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

Começar a registrar os subdomínios no locatário do cliente e obter 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 Escolher um rótulo de subdomínio DNS a ser usado para identificar o cliente. Em seguida, o Microsoft 365 exige que você (como a operadora) crie registros DNS que usam 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 um administrador global.
  2. Usando Adicionar um subdomínio ao locatário do cliente e verificá-lo:
    1. Registre o primeiro subdomínio de 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 fornecido pelo Microsoft 365.
  3. (Somente implantações de produção) Repita a etapa anterior do segundo subdomínio de cliente.

Importante

Ainda não conclua o processo de verificação. Você deve executar Configurar o cliente no Gateway de Comunicações do Azure e gerar registros DNS primeiro.

Configurar o cliente no Gateway de Comunicações do Azure e gerar registros DNS

O Gateway de Comunicações do Azure inclui um servidor DNS. Você precisa usar o Gateway de Comunicações do Azure 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 de DNS no Gateway de Comunicações do Azure.

Você pode usar o Portal de Gerenciamento de Números do Gateway de Comunicações do Azure (versão prévia) ou a API de Provisionamento (versão prévia).

  1. Na página de visão geral do recurso do Gateway de Comunicações, 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 selecione a caixa de seleção Habilitar roteamento direto do Teams.
  5. Defina a ID do locatário do Teams como a ID do locatário do cliente de teste.
  6. Opcionalmente, selecione Habilitar triagem de chamadas. Esta triagem garante que os clientes só possam fazer chamadas de roteamento direto a partir de números atribuídos a eles.
  7. Defina o Subdomínio como o rótulo do subdomínio escolhido em Escolher um rótulo de subdomínio DNS a ser usado para identificar o cliente (por exemplo, test).
  8. Defina os campos da Região do 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 DNS.
  9. Selecione Criar.
  10. Confirme se os registros DNS foram gerados.
    1. No painel Contas, selecione o nome da conta na lista.
    2. Confirme se o Estado de provisionamento do subdomínio é Provisionado.

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

Quando você tiver usado o Gateway de Comunicações do Azure para gerar os registros DNS para os subdomínios do cliente, verifique os subdomínios no centro de administração do Microsoft 365 para seu locatário do cliente.

  1. Entre no centro de administração do Microsoft 365 para o locatário do cliente como um administrador global.
  2. Selecione Configurações>Domínios.
  3. Termine de verificar os subdomínios do cliente seguindo Adicionar um subdomínio ao locatário do cliente e verificá-lo.

Ativar os domínios no locatário do cliente

Para ativar os subdomínios do cliente no Microsoft 365, configure pelo menos um usuário ou conta de 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 de subdomínio.

Importante

Verifique se 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 Gateway de Comunicações do Azure

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 roteia chamadas para o Gateway de Comunicações do Azure.

Importante

Você deve usar o PowerShell para definir os gateways PSTN para a rota de voz, pois o Centro de Administração do Microsoft Teams não dá 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óxima etapa

Configurar números de teste