> 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/de/automatisierung/runbooks/runbook-references/org/phone/add-or-remove-call-queue-agents.md).

# Anrufwarteschlangen-Agenten hinzufügen oder entfernen

Agenten einer Teams-Anrufwarteschlange hinzufügen oder entfernen

### Beschreibung

Fügt die ausgewählten Benutzer als einzeln zugewiesene Agents einer Teams-Anrufwarteschlange hinzu oder entfernt sie aus dieser Liste. Agents, die aus einer Gruppe, einem Team oder einem Schichtplan stammen, werden nicht angetastet; die Ausgabe sagt stattdessen, wo sie verwaltet werden. Benutzer ohne Enterprise Voice werden mit dem Grund übersprungen. Details zu den Prüfungen und Grenzen stehen in der Runbook-Dokumentation (docs.realmjoin.com).

### So funktioniert es

Eine Anrufwarteschlange erhält ihre Agents auf genau eine von drei Arten, und die Art wird im Teams admin center unter "Call answering" ausgewählt:

* **Benutzer und Gruppen** - Agents werden einzeln, über Gruppen oder über beides zugewiesen. Das ist der einzige Modus, den das Runbook ändert. Es fügt die ausgewählten Benutzer zur Liste der einzeln zugewiesenen Agents hinzu oder entfernt sie daraus und lässt die zugewiesenen Gruppen genau so, wie sie sind.
* **Ein Team und ein Kanal** - Jedes Mitglied des Teams dieses Kanals ist ein Agent. Das Runbook gibt Team und Kanal aus und bricht ohne Änderung ab, weil die Mitgliedschaft im Team verwaltet wird.
* **Ein Schichtplan** - Agents stammen aus einer Planungsgruppe in der Shifts-App. Das Runbook gibt das Team hinter dem Plan aus und bricht ohne Änderung ab.

Bevor etwas geschrieben wird, listet das Runbook die aktuellen Agents auf und prüft jeden ausgewählten Benutzer. Benutzer, die kein Agent werden können, werden mit dem Grund übersprungen, und die übrigen werden trotzdem verarbeitet. Einen Benutzer hinzuzufügen, der bereits ein Agent ist, oder einen Benutzer zu entfernen, der keiner ist, wird als "No action taken" gemeldet und ändert nichts.

Zwei Situationen stoppen die Ausführung, bevor eine Änderung vorgenommen wird: Die Warteschlange würde am Ende mehr als 20 einzeln zugewiesene Agents haben, oder eine Entfernung würde dazu führen, dass die Warteschlange überhaupt keine Agents und keine Gruppen mehr hat. Im zweiten Fall müssen Sie zuerst einen Agenten behalten oder einer Warteschlange im Teams admin center eine Gruppe oder ein Team zuweisen.

Nach der Änderung liest das Runbook die Anrufwarteschlange erneut ein und vergleicht die Liste der Agents mit der Anforderung. Eine Abweichung wird als Warnung gemeldet, damit sie im Teams admin center überprüft werden kann.

### Voraussetzungen für Agents

* Ein Agent benötigt eine Teams Phone-Lizenz mit aktivierter Enterprise Voice. Benutzer ohne diese Lizenz werden mit diesem Grund übersprungen; richten Sie Teams Phone für sie ein und führen Sie das Runbook erneut aus.
* Agents, die Anrufe in der Teams-App annehmen, müssen sich im TeamsOnly-Upgrademodus befinden. Ein anderer Modus wird als Warnung gemeldet, und der Benutzer wird trotzdem hinzugefügt.
* Nur reguläre Benutzerkonten können Agents sein. Ressourcenkonten und Gäste werden übersprungen.
* Microsoft erlaubt 20 einzeln zugewiesene Agents pro Anrufwarteschlange und bis zu 200 Agents, wenn sie über Gruppen kommen. Verwenden Sie für größere Teams eine Gruppe.
* Änderungen an Lizenzen und Richtlinien benötigen Zeit, um den Teams-Dienst zu erreichen. Nach einer neuen Teams Phone-Lizenz kann es etwa eine Stunde dauern, bis ein Benutzer als Agent zugewiesen werden kann.
* Bis eine Warteschlange dem ersten Anruf anbietet, kann es bei einem Benutzer, der über eine Gruppe zum Agenten wird, bis zu acht Stunden dauern.

### Hinweise und Einschränkungen

* Das Runbook ändert niemals die Mitgliedschaft einer Gruppe oder eines Teams. Eine Warteschlange, die ihre Agents aus einer Gruppe, einem Teamkanal oder einem Schichtplan bezieht, wird mit dem Ort gemeldet, an dem ihre Mitglieder verwaltet werden.
* Warteschlangen, die einzeln zugewiesene Benutzer mit Gruppen mischen, werden unterstützt. Nur die individuellen Zuweisungen werden geändert; die Gruppen bleiben unverändert und ihre Mitglieder sind weiterhin Agents.
* Die Agentenliste einer Anrufwarteschlange ist die dienstseitige Auflösung von Benutzern und Gruppenmitgliedern und wird zwischengespeichert. Ein Benutzer, der gerade zu einer der zugewiesenen Gruppen hinzugefügt wurde, kann trotzdem noch als nicht Agent gemeldet werden, und ein aus einer Gruppe entfernter Benutzer kann noch eine Weile gelistet sein.
* Das vollständige Leeren der Agentenliste ist hier absichtlich nicht möglich. Das Entfernen des letzten Agents einer Warteschlange ohne Gruppen wird abgelehnt, weil eine Warteschlange ohne Agents keine Anrufe entgegennehmen kann. Tun Sie das im Teams admin center, wenn es wirklich beabsichtigt ist.
* Gruppen-, Team- und Kanalnamen stammen aus Microsoft Graph. Ohne die optionalen Berechtigungen dafür gibt das Runbook stattdessen die Objekt-IDs aus und funktioniert genau gleich.

### Ort

Organisation → Telefon → Agents der Anrufwarteschlange hinzufügen oder entfernen

**Vollständiger Runbook-Name**

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

### Details

| Eigenschaft          | Wert                                                                                                                  |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Version              | 1.0.0                                                                                                                 |
| Erforderliche Module | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>MicrosoftTeams (>= 7.9.0)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Planbar              | nein                                                                                                                  |

### Berechtigungen

#### Anwendungsberechtigungen

* **Typ**: Microsoft Graph
  * Organization.Read.All
    * *Erforderlich für die app-basierte Teams PowerShell-Anmeldung (Connect-MicrosoftTeams -Identity), um Tenant-Informationen zu lesen*
  * Channel.ReadBasic.All *(optional — Feature: Gruppen-, Team- und Kanalnamen in der Ausgabe)*
    * *Ermittelt den Kanalnamen einer Anrufwarteschlange, die von einem Teamkanal beantwortet wird*
  * GroupMember.Read.All *(optional — Feature: Gruppen-, Team- und Kanalnamen in der Ausgabe)*
    * *Ermittelt die Anzeigenamen der Gruppen und Shifts-Teams, die der Anrufwarteschlange zugewiesen sind*
  * Team.ReadBasic.All *(optional — Feature: Gruppen-, Team- und Kanalnamen in der Ausgabe)*
    * *Listet die Teams des Kanalbesitzers auf, um das Team hinter dem antwortenden Kanal zu finden*

#### RBAC-Rollen

* Teams-Administrator
  * *Erforderlich, um Get-CsCallQueue, Set-CsCallQueue und Get-CsOnlineUser über app-basierte Teams PowerShell auszuführen*

### Parameter

#### CallQueueName

Exakter Name der Anrufwarteschlange, wie im Teams admin center angezeigt. Groß- und Kleinschreibung sind egal, aber der Name muss genau zu einer Warteschlange passen.

| Eigenschaft           | Wert                        |
| --------------------- | --------------------------- |
| Erforderlich          | wahr                        |
| Standardwert          |                             |
| Typ                   | Zeichenfolge                |
| Anzeigename im Portal | Name der Anrufwarteschlange |

#### UserIds

Benutzer, die gleichzeitig hinzugefügt oder entfernt werden sollen. Um als Agent zu arbeiten, benötigt ein Benutzer eine Teams Phone-Lizenz mit aktivierter Enterprise Voice.

| Eigenschaft           | Wert      |
| --------------------- | --------- |
| Erforderlich          | wahr      |
| Standardwert          |           |
| Typ                   | String\[] |
| Anzeigename im Portal | Benutzer  |

#### Entfernen

Benutzer als Agents hinzufügen setzt sie auf die Liste der einzeln zugewiesenen Agents. Benutzer als Agents entfernen nimmt sie daraus heraus; Agents, die aus einer Gruppe oder einem Team stammen, bleiben unverändert.

| Eigenschaft           | Wert     |
| --------------------- | -------- |
| Erforderlich          | falsch   |
| Standardwert          | Falsch   |
| Typ                   | Boolesch |
| Anzeigename im Portal | Aktion   |

**Portaloptionen**

| Portaloption                   | Wert   |
| ------------------------------ | ------ |
| Benutzer als Agents hinzufügen | falsch |
| Benutzer als Agents entfernen  | wahr   |

[Zur Übersicht der Runbook-Referenz zurück](https://docs.realmjoin.com/de/automatisierung/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/de/automatisierung/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.
