Gerenciar números de telefone para bots

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

• Aplicativo: Um aplicativo hospedado no Azure, também chamado de 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 uma conta de recurso. Essa é a única maneira de um número de telefone ser atribuído 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.

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 a ID do bot, a ID do aplicativo da Microsoft e a senha do aplicativo microsoft para usar em seu código.

Adicione as permissões a seguir 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 à chamada, 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 de 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ário).

Criar uma instância de aplicativo

Se ele ainda não tiver sido instalado, um administrador de locatário precisará instalar o módulo do Teams para o 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, confira Licença de usuário virtual do sistema de telefone.

Atribua um plano de chamada à instância do aplicativo. Para obter detalhes, confira Chamando planos para o Microsoft 365.

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

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, confira Obtendo números de telefone para 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 de serviço (+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.

Desatribuir um número de telefone do bot

Use o seguinte cmdlet para desatribuir um número de telefone:

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

Atualizar um número de telefone do bot

Depois de desatribuir o número, você pode 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

• Visão geral da API do Teams
• Exemplo de bot de incidente
• Implantando o exemplo