Telefonnummer für Bots verwalten
In diesem Artikel wird beschrieben, wie Sie die Cloudkommunikations-API in Microsoft Graph verwenden, um einen Bot zu erstellen, der über eine Telefonnummer erreichbar ist. Wenn Sie Ihren Bot erstellen, ist es hilfreich, mit den folgenden Begriffen vertraut zu sein:
Anwendung: Eine Anwendung, die in Azure gehostet wird und auch als Bot bezeichnet wird.
Anwendungsinstanz: Ein deaktiviertes Benutzerobjekt, das einer Telefonnummer zugewiesen werden kann, die von einem Bot verwendet werden kann. Dies wird auch als Ressourcenkonto bezeichnet. Nur so kann einem Bot eine Telefonnummer zugewiesen werden.
Eine Anwendung kann über mehrere Anwendungsinstanzen verfügen, und jeder Mandant kann mehrere Anwendungsinstanzen aufweisen, wie in der folgenden Abbildung dargestellt.
Voraussetzung: Registrieren eines Bots
Befolgen Sie zunächst die Anweisungen zum Registrieren eines aufrufenden Bots. Sie benötigen Konfigurationswerte wie Bot-ID, Microsoft-App-ID und Microsoft-App-Kennwort, um sie in Ihrem Code verwenden zu können.
Fügen Sie Ihrem Bot die folgenden Berechtigungen hinzu. Ein Mandantenadministrator muss auch diesen Berechtigungen zustimmen:
- Calls.AccessMedia.All
- Calls.Initiate.All
- Calls.JoinGroupCall.All
- Calls.JoinGroupCallAsGuest.All
Weitere Informationen zu aufrufbezogenen Berechtigungen finden Sie in der Referenz zu Berechtigungen.
Zuweisen einer Telefonnummer zu Ihrem Bot
Das Zuweisen einer Telefonnummer zu Ihrem Bot umfasst drei Schritte:
- Erstellen Sie eine Anwendungsinstanz.
- Weisen Sie Ihrer Anwendungsinstanz Microsoft 365-Lizenzen zu.
- Weisen Sie der Anwendungsinstanz (nur Mandantenadministrator) eine Telefonnummer zu.
Erstellen einer Anwendungsinstanz
Wenn es noch nicht installiert wurde, muss ein Mandantenadministrator das Teams-Modul für PowerShell installieren. Der Mandantenadministrator muss sich mit seinen Anmeldeinformationen anmelden, bevor er das Cmdlet ausführt.
Um eine neue Anwendungsinstanz zu erstellen, führt der Mandantenadministrator das folgende Cmdlet aus:
PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <user@contoso.com> -ApplicationId <app_id> -DisplayName <bot_display_name>
Weitere Informationen finden Sie unter New-CsOnlineApplicationInstance.
Zuweisen von Microsoft 365-Lizenzen zu Ihrer Anwendungsinstanz
Weisen Sie Ihrer Anwendungsinstanz eine virtuelle Benutzerlizenz zu. Weitere Informationen finden Sie unter Lizenz für virtuelle Benutzer des Telefonsystems.
Weisen Sie Ihrer Anwendungsinstanz einen Anrufplan zu. Weitere Informationen finden Sie unter Anrufpläne für Microsoft 365.
Zuweisen einer Telefonnummer zur Anwendungsinstanz (nur Mandantenadministrator)
Bevor Sie in Ihrer Organisation Benutzer für das Tätigen und Empfangen von Anrufen einrichten können, müssen Sie Telefonnummern für diese anfordern. Weitere Informationen finden Sie unter Abrufen von Telefonnummern für Ihre Benutzer.
Um die Telefonnummer der Anwendungsinstanz zuzuweisen, weist der Mandantenadministrator mithilfe des folgenden Cmdlets eine Diensttelefonnummer (+11D-Format) zu:
PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>
Weitere Informationen finden Sie unter Set-CsPhoneNumberAssignment.
Aufheben der Zuweisung einer Bottelefonnummer
Verwenden Sie das folgende Cmdlet, um die Zuweisung einer Telefonnummer aufzuheben:
PS C:\> Remove-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>
Aktualisieren einer Bottelefonnummer
Nach dem Aufheben der Zuweisung der Nummer können Sie dem Bot mithilfe des folgenden Cmdlets eine andere Nummer zuweisen:
PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>