ボットの電話番号を管理するManage phone numbers for bots

この記事では、電話番号を通じて到達可能な bot を作成する方法について説明します。This article describes how to create a bot that is reachable through a phone number. Bot を作成すると、次の用語を理解するのに役立ちます。As you create your bot, it will be helpful to be familiar with the following terms:

  • アプリケーション – Azure でホストされているアプリケーション。 botとも呼ばれます。Application – An application that is hosted on Azure, also referred to as a bot.

  • アプリケーションインスタンス – bot が使用できる電話番号に割り当てることができる、無効なユーザーオブジェクト。Application instance – A disabled-user object that can be assigned to a phone number that can be used by a bot. これは、 リソースアカウントとも呼ばれます。This is also known as a resource account. これは、bot に電話番号を割り当てることができる唯一の方法です。This is the only way a phone number can be assigned to a bot.

1つのアプリケーションは複数のアプリケーションインスタンスを持つことができ、各テナントは次の図に示すように、複数のアプリケーションインスタンスを持つことができます。One application can have multiple application instances, and each tenant can have multiple application instances, as shown in the following image.

1つ以上のアプリケーションインスタンスを含むテナントの電話番号を示す画像

前提条件-ボットの登録Prerequisite - Register a bot

開始するには、指示に従って 呼び出しボットを登録します。To get started, follow the instructions to register a calling bot. コードで使用するために、bot ID、Microsoft アプリ ID、Microsoft アプリパスワードなどの構成値が必要です。You’ll need config values such as bot ID, Microsoft app ID, and Microsoft app password to use in your code.

次のアクセス許可を bot に追加します。Add the following permissions to your bot. テナント管理者は、これらのアクセス許可にも同意する必要があります。A tenant admin needs to consent to these permissions as well:

  • Calls.AccessMedia.AllCalls.AccessMedia.All
  • Calls.Initiate.AllCalls.Initiate.All
  • Calls.JoinGroupCall.AllCalls.JoinGroupCall.All
  • JoinGroupCallAsGuest を呼び出します。Calls.JoinGroupCallAsGuest.All

通話関連のアクセス許可の詳細については、「 アクセス許可の参照」を参照してください。For more information about call-related permissions, see the Permissions reference.

Bot に電話番号を割り当てるAssign a phone number to your bot

Bot に電話番号を割り当てるには、3つの手順が必要です。Assigning a phone number to your bot involves three steps:

  1. アプリケーションインスタンスを作成します。Create an application instance.
  2. 仮想ユーザーライセンスをアプリケーションインスタンスに割り当てます。Assign a virtual user license to your application instance.
  3. アプリケーションインスタンスに電話番号を割り当てます (テナント管理者のみ)。Assign a phone number to the application instance (only tenant admin).

アプリケーションインスタンスを作成するCreate an application instance

まだインストールされていない場合は、テナント管理者が PowerShell 用の Skype For Business Online モジュール をインストールする必要があります。If it hasn't been installed already, a tenant admin needs to install the Skype for Business Online Module for PowerShell. テナント管理者は、コマンドレットを実行する前に、資格情報を使用してサインインする必要があります。The tenant admin must sign in using their credentials before running the cmdlet.

新しいアプリケーションインスタンスを作成するには、テナント管理者が次のコマンドレットを実行します。To create a new application instance, the tenant admin runs the following cmdlet.

PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <user@contoso.com> -ApplicationId “<app_id>” -DisplayName "<bot_display_name>"

アプリケーションインスタンスが作成されたら、sync コマンドレットを使用します。When the application instance is created, use the sync cmdlet.

PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <application_instance_id>

仮想ユーザーライセンスをアプリケーションインスタンスに割り当てるAssign a virtual user license to your application instance

仮想ユーザーライセンスをアプリケーションインスタンスに割り当てます。Assign a virtual user license to your application instance. 詳細については、「 Phone system virtual user license」を参照してください。For details, see Phone system virtual user license.

アプリケーションインスタンスへの電話番号の割り当て (テナント管理者のみ)Assign a phone number to the application instance (only tenant admin)

アプリケーションインスタンスに電話番号を割り当てるには、テナント管理者に次のようにします。To assign the phone number to the application instance, the tenant admin:

  1. テナント管理者として Teams 管理センターにサインインします。Signs in to the Teams admin center as a tenant admin.
  2. Teams 管理センターの > 音声 > 電話番号にジャンプします。Goes to Teams Admin center > Voice > Phone Numbers.
  3. 次のコマンドレットを使用して、サービス電話番号 (+ 11D 形式) を割り当てます。Assigns a service phone number (+11D format) using the following cmdlet.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber <phone_number>

Bot の電話番号の割り当てを解除するUnassign a bot phone number

電話番号の割り当てを解除するには、次のコマンドレットを使用します。Use the following cmdlet to unassign a phone number.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber $null

注: 現時点では、直接ルーティング (DR) 番号ではなく、オンライン番号のみが使用できます。Note: Currently this only works with online numbers and not direct routing (DR) numbers. これは既知の問題です。This is a known issue.

Bot の電話番号を更新するUpdate a bot phone number

番号の割り当てを解除した後、次のコマンドレットを使用して bot に別の番号を割り当てることができます。After unassigning the number, you can assign a different number to the bot by using the following cmdlet.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber <new phone_number>

関連項目See also