Gerenciar números de telefone para botsManage phone numbers for bots

Este artigo descreve como criar um bot que é acessível por meio de um número de telefone.This article describes how to create a bot that is reachable through a phone number. À medida que você cria seu bot, será útil estar familiarizado com os seguintes termos:As you create your bot, it will be helpful to be familiar with the following terms:

  • Aplicativo – Um aplicativo hospedado no Azure, também conhecido como bot.Application – An application that is hosted on Azure, also referred to as a 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.Application instance – A disabled-user object that can be assigned to a phone number that can be used by a bot. Isso também é conhecido como uma conta de recurso.This is also known as a resource account. Essa é a única maneira de um número de telefone ser atribuído a um bot.This is the only way a phone number can be assigned to a 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.One application can have multiple application instances, and each tenant can have multiple application instances, as shown in the following image.

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

Pré-requisito - Registrar um botPrerequisite - Register a bot

Para começar, siga as instruções para registrar um bot de chamada.To get started, follow the instructions to register a calling bot. Você precisará de valores de configuração, como ID de bot, ID de aplicativo da Microsoft e senha de aplicativo da Microsoft para usar em seu código.You’ll need config values such as bot ID, Microsoft app ID, and Microsoft app password to use in your code.

Adicione as seguintes permissões ao bot.Add the following permissions to your bot. Um administrador de locatário também precisa concordar com essas permissões:A tenant admin needs to consent to these permissions as well:

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

Para obter mais informações sobre permissões relacionadas a chamada, consulte a referência Permissões.For more information about call-related permissions, see the Permissions reference.

Atribuir um número de telefone ao botAssign a phone number to your bot

Atribuir um número de telefone ao bot envolve três etapas:Assigning a phone number to your bot involves three steps:

  1. Crie uma instância de aplicativo.Create an application instance.
  2. Atribua licenças do Microsoft 365 à instância do aplicativo.Assign Microsoft 365 licenses to your application instance.
  3. Atribua um número de telefone à instância do aplicativo (somente administrador de locatário).Assign a phone number to the application instance (only tenant admin).

Criar uma instância de aplicativoCreate an application instance

Se ainda não tiver sido instalado, um administrador de locatário precisará instalar o Módulo do Skype for Business Online para o PowerShell.If it hasn't been installed already, a tenant admin needs to install the Skype for Business Online Module for PowerShell. O administrador do locatário deve entrar usando suas credenciais antes de executar o cmdlet.The tenant admin must sign in using their credentials before running the cmdlet.

Para criar uma nova instância de aplicativo, o administrador de locatário executa o cmdlet a seguir.To create a new application instance, the tenant admin runs the following cmdlet.

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

Quando a instância do aplicativo for criada, use o cmdlet de sincronização.When the application instance is created, use the sync cmdlet.

PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <application_instance_id>

Para obter mais informações, consulte New-CsOnlineApplicationInstance e Sync-CsOnlineApplicationInstance.For more information, see New-CsOnlineApplicationInstance and Sync-CsOnlineApplicationInstance.

Atribuir licenças do Microsoft 365 à instância do aplicativoAssign Microsoft 365 licenses to your application instance

Atribua uma licença de usuário virtual à instância do aplicativo.Assign a virtual user license to your application instance. Para obter detalhes, consulte Phone system virtual user license.For details, see Phone system virtual user license.

Atribua um plano de chamada à instância do aplicativo.Assign a calling plan to your application instance. Para obter detalhes, consulte Planos de chamada para o Microsoft 365.For details, see Calling plans for Microsoft 365.

Atribuir um número de telefone à instância do aplicativo (somente administrador de locatário)Assign a phone number to the application instance (only tenant admin)

Antes de poder configurar os usuários em sua organização para fazer e receber chamadas telefônicas, você deve obter números de telefone para eles.Before you can set up users in your organization to make and receive phone calls, you must get phone numbers for them. Para obter detalhes, consulte Obter números de telefone para seus usuários.For details, see Getting phone numbers for your users.

Para atribuir o número de telefone à instância do aplicativo, o administrador do locatário:To assign the phone number to the application instance, the tenant admin:

  1. Entre no centro de administração do Teams como administrador de locatário.Signs in to the Teams admin center as a tenant admin.
  2. Vai para o Centro de Administração do Teams Números de > Telefone de > Voz.Goes to Teams Admin center > Voice > Phone Numbers.
  3. Atribui um número de telefone de serviço (formato+11D) usando o cmdlet a seguir.Assigns a service phone number (+11D format) using the following cmdlet.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber <phone_number>

Quando o número de telefone de serviço for atribuído, use o cmdlet de sincronização.When the service phone number is assigned, use the sync cmdlet.

PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <application_instance_id>

Para obter mais informações, consulte Set-CsOnlineVoiceApplicationInstance e Sync-CsOnlineApplicationInstance.For more information, see Set-CsOnlineVoiceApplicationInstance and Sync-CsOnlineApplicationInstance.

Unassign a bot phone numberUnassign a bot phone number

Use o cmdlet a seguir para desemplacar um número de telefone.Use the following cmdlet to unassign a phone number.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber $null

Observação: Atualmente, isso só funciona com números online e não números de roteamento direto (DR).Note: Currently this only works with online numbers and not direct routing (DR) numbers. Este é um problema conhecido.This is a known issue.

Atualizar um número de telefone botUpdate a bot phone number

Depois de desatribuição do número, você pode atribuir um número diferente ao bot usando o cmdlet a seguir.After unassigning the number, you can assign a different number to the bot by using the following cmdlet.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber <new phone_number>

Confira tambémSee also