ボットの電話番号を管理する
この記事では、Microsoft Graph のクラウド通信 API を使用して、電話番号を介して到達可能なボットを作成する方法について説明します。 ボットを作成するときは、次の用語をよく理解しておくと役立ちます。
アプリケーション: Azure でホストされているアプリケーション ( ボットとも呼ばれます)。
アプリケーション インスタンス: ボットで使用できる電話番号に割り当てることができる disabled-user オブジェクト。 これは リソース アカウントとも呼ばれます。 これは、電話番号をボットに割り当てることができる唯一の方法です。
次の図に示すように、1 つのアプリケーションに複数のアプリケーション インスタンスを含め、各テナントに複数のアプリケーション インスタンスを含めることができます。
前提条件: ボットを登録する
開始するには、指示に従って 通話ボットを登録します。 コードで使用するには、ボット ID、Microsoft アプリ ID、Microsoft アプリ パスワードなどの構成値が必要です。
ボットに次のアクセス許可を追加します。 テナント管理者は、次のアクセス許可にも同意する必要があります。
- Calls.AccessMedia.All
- Calls.Initiate.All
- Calls.JoinGroupCall.All
- Calls.JoinGroupCallAsGuest.All
呼び出し関連のアクセス許可の詳細については、「アクセス許可リファレンス」を 参照してください。
ボットに電話番号を割り当てる
ボットに電話番号を割り当てるには、次の 3 つの手順が必要です。
- アプリケーション インスタンスを作成します。
- アプリケーション インスタンスに Microsoft 365 ライセンスを割り当てます。
- アプリケーション インスタンスに電話番号を割り当てます (テナント管理者のみ)。
テナントにアプリケーション インスタンスを作成します。
まだインストールされていない場合は、テナント管理者が PowerShell 用 の Teams モジュール をインストールする必要があります。 テナント管理者は、コマンドレットを実行する前に資格情報を使用してサインインする必要があります。
新しいアプリケーション インスタンスを作成するために、テナント管理者は次のコマンドレットを実行します。
PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <user@contoso.com> -ApplicationId <app_id> -DisplayName <bot_display_name>
詳細については、「New-CsOnlineApplicationInstance」を参照してください。
アプリケーション インスタンスに Microsoft 365 ライセンスを割り当てる
仮想ユーザー ライセンスをアプリケーション インスタンスに割り当てます。 詳細については、「 電話システム仮想ユーザー ライセンス」を参照してください。
呼び出し元のプランをアプリケーション インスタンスに割り当てます。 詳細については、「 Microsoft 365 のプランの呼び出し」を参照してください。
アプリケーション インスタンスに電話番号を割り当てる (テナント管理者のみ)
組織内でユーザーを設定し、電話をかけたり受けたりする前に、ユーザーの電話番号を取得する必要があります。 詳細については、「 ユーザーの電話番号を取得する」を参照してください。
アプリケーション インスタンスに電話番号を割り当てるには、テナント管理者は次のコマンドレットを使用してサービス電話番号 (+11D 形式) を割り当てます。
PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>
詳細については、「 Set-CsPhoneNumberAssignment」を参照してください。
ボットの電話番号の割り当てを解除する
電話番号の割り当てを解除するには、次のコマンドレットを使用します。
PS C:\> Remove-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>
ボットの電話番号を更新する
番号の割り当てを解除した後、次のコマンドレットを使用して、ボットに別の番号を割り当てることができます。
PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>