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.
Anwendungs-instance: Ein benutzerdeaktives Objekt, 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 Anwendung instance.
- Weisen Sie Ihrer Anwendung Microsoft 365-Lizenzen instance zu.
- Weisen Sie der Anwendung instance (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 Anwendung instance 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 Anwendung instance
Weisen Sie Ihrer Anwendung instance eine lizenz für virtuelle Benutzer zu. Weitere Informationen finden Sie unter Lizenz für virtuelle Benutzer des Telefonsystems.
Weisen Sie Ihrer Anwendung einen Anrufplan instance zu. Weitere Informationen finden Sie unter Anrufpläne für Microsoft 365.
Zuweisen einer Telefonnummer zur Anwendung instance (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 Anwendung instance 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>