次の方法で共有

コマンドレットを使用して通話キューを作成する

  • [アーティクル]
  • 適用対象:
    Microsoft Teams, Skype for Business

前提条件

  1. コンピューターに PowerShell をインストールします。

    • コンピューターをWindows PowerShell用に設定する

    • MSTeams モジュールがインストール済み

      Install-Module -Name MicrosoftTeams -Force -AllowClobber

    • Microsoft Graph モジュールがインストールされました

      Install-Module -Name Microsoft.Graph -Force -AllowClobber

  2. テナント管理権限があることを確認します。

  3. Microsoft Teams 電話を購入します。

  4. この記事で説明するエージェント、配布リスト、および Teams チャネルは既に作成されています。

注意

このシナリオで使用される Teams チャネル コマンドレットは、Teams PowerShell モジュールのパブリック プレビュー バージョンの一部です。 詳細については、「 Teams PowerShell パブリック プレビューのインストール 」および「 PowerShell リリース ノートMicrosoft Teams」を参照してください。

MicrosoftTeams モジュールが既にインストールされているユーザーは、最新のバージョンがインストールされていることを確認するために Update-Module MicrosoftTeams する必要があります。

シナリオ

このシナリオでは、次の 3 つの呼び出しキューを作成します。

  • Sales Call Queue
  • 呼び出しキューのサポート
  • 施設コラボレーション呼び出しキュー

Sales Call Queue の情報:

  • 自動応答の背後に入れ子になった: はい
  • PSTN からの直接呼び出し: いいえ
  • 言語: 米国英語
  • あいさつ: なし
  • 保留音: オーディオ ファイルを再生する
    • ファイル名: sales-hold-in-queue-music.wav
  • 通話応答: ユーザー
    • Bill@contoso.com
    • Mary@contoso.com
  • 会議モード: オン
  • ルーティング方法: アテンダント
  • プレゼンス ベースのルーティング: オフ
  • 通話エージェントは、通話の受け取りをオプトアウトできます: はい
  • 通話エージェントのアラート時間: 15
  • 呼び出しオーバーフロー処理: 200
    • リダイレクト先: Adele@contoso.com
  • 呼び出しタイムアウト処理: 120 秒
    • リダイレクト先: Adele@contoso.com

通話キューのサポート情報:

  • 自動応答の背後に入れ子になった: はい
  • PSTN からの直接呼び出し: いいえ
  • 言語: 英国英語
  • あいさつ: オーディオ ファイルを再生する
    • ファイル名: support-greeting.wav
  • 保留音: オーディオ ファイルを再生する
    • ファイル名: support-hold-in-queue-music.wav
  • 通話応答: 配布リストをサポートする
    • Support@contoso.com
  • 会議モード: オン
  • ルーティング方法: 最長アイドル
  • プレゼンス ベースのルーティング: N/A – アイドル時間が最も長いため、既定では オン
  • 通話エージェントは通話の取り消しをオプトアウトできます: いいえ
  • 通話エージェントのアラート時間: 15
  • 呼び出しオーバーフロー処理: 200
    • リダイレクト: 共有ボイスメールをサポートする
      • オーディオ ファイルを再生する (support-shared-voicemail-greeting.wav)
      • 文字起こしが有効
  • 通話タイムアウト処理: 45 分
    • リダイレクト: 共有ボイスメールをサポートする
      • TTS: "お待たせし、ボイスメールに通話を転送しています。
      • 文字起こしが有効

施設コラボレーション呼び出しキュー情報:

  • 自動応答の背後に入れ子になった: いいえ
  • PSTN からの直接呼び出し: いいえ (内部呼び出しのみ)
  • 言語: フランス語 FR
  • あいさつ: なし
  • 保留音: 既定
  • 通話応答: チーム: 機能
  • 通話応答チャネル: ヘルプ デスク
    • チャネル所有者: Fred@contoso.com
  • 会議モード: オン
  • ルーティング方法: ラウンド ロビン
  • プレゼンス ベースのルーティング: オン
  • 通話エージェントは通話の取り消しをオプトアウトできます: いいえ
  • 通話エージェントのアラート時間: 15
  • 呼び出しオーバーフロー処理: 200
    • 切断
  • 通話タイムアウト処理: 45 分
    • 切断

ログイン

メッセージが表示されたら、Teams 管理者の資格情報を入力します。

$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential
Connect-MgGraph -Credential $credential

Sales Queue

オーディオ ファイルを作成する

d:\\を、コンピューターに wav ファイルが格納されているパスに置き換えます。

$content = [System.IO.File]::ReadAllBytes('d:\sales-hold-in-queue-music.wav')
$audioFileSalesHoldInQueueMusicID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "sales-hold-in-queue-music.wav" -Content $content).ID

ユーザー ID を取得する

$userAdeleID = (Get-CsOnlineUser -Identity "sip:adele@contoso.com").Identity
$userSalesBillID = (Get-CsOnlineUser -Identity "sip:bill@contoso.com").Identity
$userSalesMaryID = (Get-CsOnlineUser -Identity "sip:mary@contoso.com").Identity

サポートされている言語の一覧を取得する

Get-CsAutoAttendantSupportedLanguage

通話キューの作成

New-CsCallQueue -Name "Sales" -AgentAlertTime 15 -AllowOptOut $true -MusicOnHoldAudioFileID $audioFileSalesHoldInQueueMusicID -OverflowAction Forward -OverflowActionTarget $userAdeleID -OverflowThreshold 200 -TimeoutAction Forward -TimeoutActionTarget $userAdeleID -TimeoutThreshold 120 -RoutingMethod Attendant -ConferenceMode $true -User @($userSalesBillID, $userSalesMaryID) -LanguageID "en-US"

ライセンスの種類を取得する

Get-MgSubscribedSku

リソース アカウントを作成して割り当てる

通話キューは自動応答の背後に入れ子になっているので、電話番号はここで必要ありません。

  • ApplicationID
    • 自動応答: ce933385-9390-45d1-9512-c8d228074e07
    • 通話キュー: 11cd3e2e-fccb-42ad-ad00-878b93575e07

(PHONESYSTEM_VIRTUALUSER)後に表示されるライセンスの種類は、Get-MgSubscribedSku コマンドレットによって一覧表示されるライセンスの種類である必要があります。

New-CsOnlineApplicationInstance -UserPrincipalName Sales-RA@contoso.com -DisplayName "Sales" -ApplicationID "11cd3e2e-fccb-42ad-ad00-878b93575e07"

Update-MgUser -UserId "Sales-RA@contoso.com" -UsageLocation US

Set-MgUserLicense -UserId "Sales-RA@contoso.com" -AddLicenses @(contoso:PHONESYSTEM_VIRTUALUSER) -RemoveLicenses @()

$applicationInstanceID = (Get-CsOnlineUser -Identity "Sales-RA@contoso.com").Identity
$callQueueID = (Get-CsCallQueue -NameFilter "Sales").Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($applicationInstanceID) -ConfigurationID $callQueueID -ConfigurationType CallQueue

サポート キュー

オーディオ ファイルを作成する

d:\\を、コンピューターに wav ファイルが格納されているパスに置き換えます。

$content1 = [System.IO.File]::ReadAllBytes('d:\support-greeting.wav')
$audioFileSupportGreetingID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-greeting.wav" -Content $content1).ID

$content2 = [System.IO.File]::ReadAllBytes('d:\support-hold-in-queue-music.wav')
$audioFileSupportHoldInQueueMusicID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-hold-in-queue-music.wav" -Content $content2).ID

$content3 = [System.IO.File]::ReadAllBytes('d:\support-shared-voicemail-greeting.wav')
$audioFileSupportSharedVoicemailGreetingID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-shared-voicemail-greeting.wav" -Content $content3).ID

サポート チーム グループ ID を取得する

$teamSupportID = (Get-Team -DisplayName "Support").GroupID

サポートされている言語の一覧を取得する

Get-CsAutoAttendantSupportedLanguage

通話キューの作成

New-CsCallQueue -Name "Support" -AgentAlertTime 15 -AllowOptOut $false -DistributionLists $teamSupportID -WelcomeMusicAudioFileID $audioFileSupportGreetingID -MusicOnHoldAudioFileID $audioFileSupportHoldInQueueMusicID -OverflowAction SharedVoicemail -OverflowActionTarget $teamSupportID -OverflowThreshold 200 -OverflowSharedVoicemailAudioFilePrompt $audioFileSupportSharedVoicemailGreetingID -EnableOverflowSharedVoicemailTranscription $true -TimeoutAction SharedVoicemail -TimeoutActionTarget $teamSupportID -TimeoutThreshold 2700 -TimeoutSharedVoicemailTextToSpeechPrompt "We're sorry to have kept you waiting and are now transferring your call to voicemail." -EnableTimeoutSharedVoicemailTranscription $true -RoutingMethod LongestIdle -ConferenceMode $true -LanguageID "en-US"

ライセンスの種類を取得する

Get-MgSubscribedSku

リソース アカウントの作成と割り当て

通話キューは自動応答の背後に入れ子になっているので、電話番号はここで必要ありません。

  • ApplicationID
    • 自動応答: ce933385-9390-45d1-9512-c8d228074e07
    • 通話キュー: 11cd3e2e-fccb-42ad-ad00-878b93575e07

(PHONESYSTEM_VIRTUALUSER)後に表示されるライセンスの種類は、Get-MgSubscribedSku コマンドレットによって一覧表示されるライセンスの種類である必要があります。

New-CsOnlineApplicationInstance -UserPrincipalName Support-RA@contoso.com -DisplayName "Support" -ApplicationID "11cd3e2e-fccb-42ad-ad00-878b93575e07"

Update-MgUser -UserId "Support-RA@contoso.com" -UsageLocation US

Set-MgUserLicense -UserId "Support-RA@contoso.com" -AddLicenses @(contoso:PHONESYSTEM_VIRTUALUSER) -RemoveLicenses @()

$applicationInstanceID = (Get-CsOnlineUser -Identity "Support-RA@contoso.com").Identity
$callQueueID = (Get-CsCallQueue -NameFilter "Support").Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($applicationInstanceID) -ConfigurationID $callQueueID -ConfigurationType CallQueue

施設コラボレーション呼び出しキュー

施設チーム グループ ID を取得する

$teamFacilitiesGroupID = (Get-Team -DisplayName "Facilities").GroupID

施設ヘルプ デスク チーム チャネル ID を取得する

Get-TeamChannel -GroupId $teamFacilitiesGroupID
$teamFacilitiesHelpDeskChannelID = "{assign ID from output of above command}"

施設ヘルプ デスク チャネルの所有者ユーザー ID を取得する

$teamFacilitiesHelpDeskChannelUserID = (Get-TeamChannelUser -GroupId $teamFacilitiesGroupID -DisplayName "Help Desk" -Role Owner).UserId

リソース アカウント ID の呼び出しに代わって取得する

$oboResourceAccountID = (Get-CsOnlineUser -Identity "MainAA-RA@contoso.com").Identity

サポートされている言語の一覧を取得する

Get-CsAutoAttendantSupportedLanguage

通話キューの作成

New-CsCallQueue -Name "Facilities" -AgentAlertTime 15 -AllowOptOut $false -ChannelId $teamFacilitiesHelpDeskChannelID -ChannelUserObjectId $teamFacilitiesHelpDeskChannelUserID  -ConferenceMode $true -DistributionList $teamFacilitiesGroupID -LanguageID "fr-FR" -OboResourceAccountIds $oboResourceAccountID -OverflowAction DisconnectWithBusy -OverflowThreshold 200 -RoutingMethod RoundRobin -TimeoutAction Disconnect -TimeoutThreshold 2700 -UseDefaultMusicOnHold $true

ライセンスの種類を取得する

Get-MgSubscribedSku

リソース アカウントを作成して割り当てる

通話キューは自動応答の背後に入れ子になっているので、電話番号はここで必要ありません。

  • ApplicationID
    • 自動応答: ce933385-9390-45d1-9512-c8d228074e07
    • 通話キュー: 11cd3e2e-fccb-42ad-ad00-878b93575e07

(PHONESYSTEM_VIRTUALUSER)後に表示されるライセンスの種類は、Get-MgSubscribedSku コマンドレットによって一覧表示されるライセンスの種類である必要があります。

New-CsOnlineApplicationInstance -UserPrincipalName Facilities-RA@contoso.com -DisplayName "Facilities" -ApplicationID "11cd3e2e-fccb-42ad-ad00-878b93575e07"

Update-MgUser -UserId "Facilities-RA@contoso.com" -UsageLocation US

Set-MgUserLicense -UserId "Facilities-RA@contoso.com" -AddLicenses @(contoso:PHONESYSTEM_VIRTUALUSER) -RemoveLicenses @()

$applicationInstanceID = (Get-CsOnlineUser -Identity "Facilities-RA@contoso.com").Identity
$callQueueID = (Get-CsCallQueue -NameFilter "Facilities").Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($applicationInstanceID) -ConfigurationID $callQueueID -ConfigurationType CallQueue

Teams 自動応答と通話キューの計画

Microsoft Teams 電話で得られる内容は次のとおりです。

コマンドレットを使用して自動応答を作成する