Gerenciar números de telefone para bots

Este artigo descreve como usar a API de comunicações em nuvem no Microsoft Graph para criar um bot que pode ser acessado por meio de um número de telefone. Ao criar seu bot, será útil estar familiarizado com os seguintes termos:

  • Aplicação: Um aplicativo hospedado no Azure, também conhecido como bot.

  • Instância do aplicativo: Um objeto de usuário desabilitado que pode ser atribuído a um número de telefone que pode ser usado por um bot. Isso também é conhecido como conta de recurso. Essa é a única maneira de atribuir um número de telefone a um bot.

Um aplicativo pode ter várias instâncias de aplicativo e cada locatário pode ter várias instâncias de aplicativo, conforme mostrado na imagem a seguir.

Imagem mostrando um número de telefone com locatários com uma ou mais instâncias do aplicativo

Pré-requisito: registrar um bot

Para começar, siga as instruções para registrar um bot de chamada. Você precisará de valores de configuração, como ID do bot, ID do aplicativo da Microsoft e senha do aplicativo da Microsoft, para usar em seu código.

Adicione as seguintes permissões ao bot. Um administrador de locatário também precisa consentir com essas permissões:

  • Calls.AccessMedia.All
  • Calls.Initiate.All
  • Calls.JoinGroupCall.All
  • Calls.JoinGroupCallAsGuest.All

Para obter mais informações sobre permissões relacionadas a chamadas, consulte a referência Permissões.

Atribuir um número de telefone ao bot

Atribuir um número de telefone ao bot envolve três etapas:

  1. Crie uma instância do aplicativo.
  2. Atribua licenças do Microsoft 365 à instância do aplicativo.
  3. Atribua um número de telefone à instância do aplicativo (somente administrador de locatários).

Criar uma instância de aplicativo

Se ainda não tiver sido instalado, um administrador de locatário precisará instalar o módulo Teams para PowerShell. O administrador do locatário deve entrar usando suas credenciais antes de executar o cmdlet.

Para criar uma nova instância de aplicativo, o administrador do locatário executa o seguinte cmdlet:

PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <user@contoso.com> -ApplicationId <app_id> -DisplayName <bot_display_name>

Para obter mais informações, consulte New-CsOnlineApplicationInstance

Atribuir licenças do Microsoft 365 à instância do aplicativo

Atribua uma licença de usuário virtual à instância do aplicativo. Para obter detalhes, consulte Licença de usuário virtual do sistema de telefonia.

Atribua um plano de chamadas à instância do aplicativo. Para obter detalhes, consulte Planos de chamadas do Microsoft 365.

Atribuir um número de telefone à instância do aplicativo (somente administrador de locatários)

Antes de poder configurar os usuários em sua organização para fazer e receber chamadas telefônicas, você deve obter os números de telefone para eles. Para obter detalhes, consulte Obtendo números de telefone de seus usuários.

Para atribuir o número de telefone à instância do aplicativo, o administrador do locatário atribui um número de telefone do serviço (+formato 11D) usando o seguinte cmdlet:

PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Para obter mais informações, consulte Set-CsPhoneNumberAssignment.

Cancelar a atribuição de um número de telefone do bot

Use o cmdlet a seguir para cancelar a atribuição de um número de telefone:

PS C:\> Remove-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Atualizar o número de telefone de um bot

Depois de cancelar a atribuição do número, você poderá atribuir um número diferente ao bot usando o seguinte cmdlet:

PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Conteúdo relacionado

  • Last updated on