> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/phone/add-or-remove-call-queue-agents.md).

# 通話キュー エージェントを追加または削除

Teams 通話キューのエージェントを追加または削除します

### 説明

Teams の通話キューの個別に割り当てられたエージェントとして選択したユーザーを追加するか、そのリストから削除します。グループ、チーム、またはシフト スケジュールから来るエージェントには影響しません。出力には、その代わりにどこで管理されているかが表示されます。Enterprise Voice がないユーザーは理由付きでスキップされます。チェックと制限の詳細は、runbook のドキュメント (docs.realmjoin.com) にあります。

### 仕組み

通話キューがエージェントを取得する方法は 3 つのうちの 1 つで、方法は Teams 管理センターの "Call answering" で選択されます:

* **ユーザーとグループ** - エージェントは、個別に、グループ経由で、またはその両方で割り当てられます。これは runbook が変更する唯一のモードです。選択したユーザーを個別に割り当てられたエージェントの一覧に追加するか、その一覧から削除し、割り当て済みのグループはそのまま保持します。
* **チームとチャネル** - そのチャネルのチームのすべてのメンバーがエージェントです。runbook はチームとチャネルを表示し、メンバーシップはチームで管理されているため、変更せずに停止します。
* **シフト スケジュール** - エージェントは Shifts アプリのスケジューリング グループから取得されます。runbook はスケジュールの背後にあるチームを表示し、変更せずに停止します。

何も書き込む前に、runbook は現在のエージェントを一覧表示し、選択した各ユーザーをチェックします。エージェントになれないユーザーは理由付きでスキップされ、残りはそのまま処理されます。すでにエージェントであるユーザーを追加したり、エージェントでないユーザーを削除したりしても、"No action taken" と報告され、何も変更されません。

2 つの状況では、変更が行われる前に runbook が停止します。キューに個別に割り当てられたエージェントが 20 人を超えることになる場合、または削除によってキューにエージェントもグループもまったく残らなくなる場合です。後者の場合は、まず Teams 管理センターで 1 人のエージェントを残すか、キューにグループまたはチームを割り当ててください。

変更後、runbook は通話キューを再度読み取り、エージェント一覧を要求内容と比較します。不一致は警告として報告されるため、Teams 管理センターで確認できます。

### エージェントの要件

* エージェントには、Enterprise Voice が有効になっている Teams Phone ライセンスが必要です。これがないユーザーはその理由でスキップされます。Teams Phone を設定してから、runbook を再実行してください。
* Teams アプリで通話を受けるエージェントは、TeamsOnly のアップグレード モードである必要があります。別のモードは警告として報告されますが、ユーザーは追加されたままです。
* エージェントになれるのは通常のユーザー アカウントのみです。リソース アカウントとゲストはスキップされます。
* Microsoft では、通話キューごとに個別に割り当てられるエージェントは 20 人まで、グループ経由の場合は最大 200 人まで許可されています。人数の多いチームではグループを使用してください。
* ライセンスやポリシーの変更が Teams サービスに反映されるまでには時間がかかります。新しい Teams Phone ライセンスを付与した後、ユーザーをエージェントとして割り当てられるようになるまで約 1 時間かかることがあります。
* グループ経由でエージェントになるユーザーは、キューが最初の通話を受け付けるまで最大 8 時間かかることがあります。

### 注記と制限

* runbook はグループやチームのメンバーシップを決して変更しません。エージェントをグループ、チーム チャネル、またはシフト スケジュールから取得するキューは、メンバーがどこで管理されているかとともに報告されます。
* 個別に割り当てられたユーザーとグループが混在するキューはサポートされています。変更されるのは個別の割り当てのみで、グループは変更されず、そのメンバーも引き続きエージェントです。
* 通話キューのエージェント一覧は、サービス側で展開されたユーザーとグループ メンバーの一覧であり、キャッシュされています。割り当て済みのグループの 1 つに追加されたばかりのユーザーは、まだエージェントではないと報告されることがありますし、グループから削除されたユーザーがしばらく一覧に残ることもあります。
* ここでは、意図的にエージェント一覧を完全に空にすることはできません。グループのないキューから最後のエージェントを削除することは拒否されます。エージェントのいないキューは通話を受けられないためです。本当にその意図がある場合は、Teams 管理センターで行ってください。
* グループ、チーム、チャネルの名前は Microsoft Graph から取得されます。これに必要なオプションのアクセス許可がない場合、runbook は代わりにオブジェクト ID を表示し、動作はまったく同じです。

### 場所

Organization → Phone → Add Or Remove Call Queue Agents

**完全な Runbook 名**

rjgit-org\_phone\_add-or-remove-call-queue-agents

### 詳細

| プロパティ    | 値                                                                                                                     |
| -------- | --------------------------------------------------------------------------------------------------------------------- |
| バージョン    | 1.0.0                                                                                                                 |
| 必須モジュール  | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>MicrosoftTeams (>= 7.9.0)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| スケジュール可能 | いいえ                                                                                                                   |

### 権限

#### アプリケーションのアクセス許可

* **種類**: Microsoft Graph
  * Organization.Read.All
    * *アプリベースの Teams PowerShell サインイン (Connect-MicrosoftTeams -Identity) でテナント情報を読み取るために必要*
  * Channel.ReadBasic.All *(オプション — 機能: 出力内のグループ、チーム、チャネル名)*
    * *チーム チャネルで応答される通話キューのチャネル名を解決します*
  * GroupMember.Read.All *(オプション — 機能: 出力内のグループ、チーム、チャネル名)*
    * *通話キューに割り当てられたグループとシフト チームの表示名を解決します*
  * Team.ReadBasic.All *(オプション — 機能: 出力内のグループ、チーム、チャネル名)*
    * *チャネル所有者のチームを一覧表示し、応答チャネルの背後にあるチームを見つけます*

#### RBAC ロール

* Teams 管理者
  * *アプリベースの Teams PowerShell で Get-CsCallQueue、Set-CsCallQueue、および Get-CsOnlineUser を実行するために必要*

### パラメーター

#### CallQueueName

Teams 管理センターに表示される通話キューの正確な名前。大文字小文字は区別されませんが、名前は 1 つのキューに正確に一致している必要があります。

| プロパティ   | 値      |
| ------- | ------ |
| 必須      | true   |
| 既定値     |        |
| 種類      | 文字列    |
| ポータル表示名 | 通話キュー名 |

#### UserIds

追加または削除するユーザー。複数を一度に指定できます。エージェントとして機能するには、ユーザーに Enterprise Voice が有効な Teams Phone ライセンスが必要です。

| プロパティ   | 値         |
| ------- | --------- |
| 必須      | true      |
| 既定値     |           |
| 種類      | String\[] |
| ポータル表示名 | ユーザー      |

#### 削除

ユーザーをエージェントとして追加すると、個別に割り当てられたエージェントの一覧に追加されます。ユーザーをエージェントとして削除すると、その一覧から削除されます。グループまたはチームから来るエージェントはそのままです。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     | False |
| 種類      | ブール値  |
| ポータル表示名 | アクション |

**ポータルのオプション**

| ポータル オプション       | 値     |
| ---------------- | ----- |
| ユーザーをエージェントとして追加 | false |
| ユーザーをエージェントとして削除 | true  |

[Runbook リファレンスの概要に戻る](/ja/zi-dong-hua/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/phone/add-or-remove-call-queue-agents.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.