Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo descreve como utilizar a API de comunicações na cloud no Microsoft Graph para criar um bot acessível através de um número de telefone. À medida que cria o bot, será útil estar familiarizado com os seguintes termos:
Aplicação: Uma aplicação alojada no Azure, também conhecida como bot.
Instância da aplicação: Um objeto de utilizador desativado que pode ser atribuído a um número de telefone que pode ser utilizado por um bot. Isto também é conhecido como uma conta de recurso. Esta é a única forma de atribuir um número de telefone a um bot.
Uma aplicação pode ter várias instâncias de aplicação e cada inquilino pode ter várias instâncias de aplicação, conforme mostrado na imagem seguinte.
Pré-requisito: registar um bot
Para começar, siga as instruções para registar um bot de chamada. Precisará de valores de configuração, como o ID do bot, o ID da aplicação Microsoft e a palavra-passe da aplicação Microsoft para utilizar no seu código.
Adicione as seguintes permissões ao bot. Um administrador de inquilinos também tem de dar consentimento a estas permissões:
- Calls.AccessMedia.All
- Calls.Initiate.All
- Calls.JoinGroupCall.All
- Calls.JoinGroupCallAsGuest.All
Para obter mais informações sobre permissões relacionadas com chamadas, veja a Referência de permissões.
Atribuir um número de telefone ao bot
A atribuição de um número de telefone ao bot envolve três passos:
- Criar uma instância de aplicação.
- Atribua licenças do Microsoft 365 à sua instância de aplicação.
- Atribua um número de telefone à instância da aplicação (apenas administrador de inquilinos).
Criar uma instância de aplicativo
Se ainda não tiver sido instalado, um administrador de inquilinos tem de instalar o módulo do Teams para o PowerShell. O administrador de inquilinos tem de iniciar sessão com as respetivas credenciais antes de executar o cmdlet.
Para criar uma nova instância de aplicação, o administrador de inquilinos 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 da aplicação
Atribua uma licença de utilizador virtual à instância da aplicação. Para obter detalhes, veja Licença de utilizador virtual do sistema telefónico.
Atribua um plano de chamadas à instância da aplicação. Para obter detalhes, consulte Planos de chamadas para o Microsoft 365.
Atribuir um número de telefone à instância da aplicação (apenas administrador de inquilinos)
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 Obter números de telefone para os seus utilizadores.
Para atribuir o número de telefone à instância da aplicação, o administrador de inquilinos atribui um número de telefone de serviço (formato+11D) através do seguinte cmdlet:
PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>
Para obter mais informações, consulte Set-CsPhoneNumberAssignment.
Anular a atribuição de um número de telefone do bot
Utilize o seguinte cmdlet para anular a atribuição de 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 anular a atribuição do número, pode atribuir um número diferente ao bot com o seguinte cmdlet:
PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>