> 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/fr/automatisation/runbooks/runbook-references/org/phone/add-or-remove-call-queue-agents.md).
# Ajouter ou supprimer des agents d’une file d’attente d’appels
Ajouter ou supprimer des agents d’une file d’attente d’appels Teams
### Description
Ajoute les utilisateurs sélectionnés en tant qu’agents attribués individuellement d’une file d’attente d’appels Teams ou les retire de cette liste. Les agents provenant d’un groupe, d’une équipe ou d’un planning Shifts ne sont pas touchés ; la sortie indique à la place où ils sont gérés. Les utilisateurs sans Enterprise Voice sont ignorés avec la raison correspondante. Les détails sur les vérifications et les limites se trouvent dans la documentation du runbook (docs.realmjoin.com).
### Fonctionnement
Une file d’attente d’appels reçoit ses agents par exactement l’un des trois moyens suivants, et le mode est choisi dans le centre d’administration Teams sous « Réponse aux appels » :
* **Utilisateurs et groupes** – les agents sont attribués individuellement, via des groupes, ou les deux. C’est le seul mode que le runbook modifie. Il ajoute les utilisateurs sélectionnés à la liste des agents attribués individuellement ou les en retire, et laisse les groupes attribués exactement tels qu’ils sont.
* **Une équipe et un canal** – chaque membre de l’équipe de ce canal est un agent. Le runbook affiche l’équipe et le canal puis s’arrête sans effectuer de changement, car l’appartenance est gérée dans l’équipe.
* **Un planning Shifts** – les agents proviennent d’un groupe de planification dans l’application Shifts. Le runbook affiche l’équipe à l’origine du planning puis s’arrête sans effectuer de changement.
Avant toute écriture, le runbook répertorie les agents actuels et vérifie chaque utilisateur sélectionné. Les utilisateurs qui ne peuvent pas devenir agents sont ignorés avec la raison, et les autres sont tout de même traités. L’ajout d’un utilisateur qui est déjà agent, ou la suppression d’un utilisateur qui ne l’est pas, est signalé comme « Aucune action effectuée » et ne change rien.
Deux situations arrêtent l’exécution avant toute modification : la file d’attente se retrouverait avec plus de 20 agents attribués individuellement, ou une suppression laisserait la file d’attente sans aucun agent ni groupe. Dans ce second cas, conservez d’abord un agent ou assignez un groupe ou une équipe à la file d’attente dans le centre d’administration Teams.
Après la modification, le runbook relit la file d’attente d’appels et compare la liste des agents à ce qui a été demandé. Une différence est signalée comme avertissement afin qu’elle puisse être vérifiée dans le centre d’administration Teams.
### Exigences pour les agents
* Un agent a besoin d’une licence Teams Phone avec Enterprise Voice activé. Les utilisateurs qui n’en disposent pas sont ignorés avec cette raison ; configurez Teams Phone pour eux et relancez le runbook.
* Les agents qui prennent des appels dans l’application Teams doivent être en mode de mise à niveau TeamsOnly. Un autre mode est signalé comme avertissement, et l’utilisateur est tout de même ajouté.
* Seuls les comptes utilisateur standards peuvent être agents. Les comptes de ressource et les invités sont ignorés.
* Microsoft autorise 20 agents attribués individuellement par file d’attente d’appels, et jusqu’à 200 agents lorsqu’ils passent par des groupes. Utilisez un groupe pour les équipes plus importantes.
* Les changements de licence et de stratégie mettent du temps à atteindre le service Teams. Après l’ajout d’une nouvelle licence Teams Phone, il peut falloir environ une heure avant qu’un utilisateur puisse être affecté comme agent.
* Un utilisateur qui devient agent via un groupe peut nécessiter jusqu’à huit heures avant que la file d’attente n’offre le premier appel.
### Notes et limites
* Le runbook ne modifie jamais l’appartenance d’un groupe ou d’une équipe. Une file d’attente qui obtient ses agents d’un groupe, d’un canal d’équipe ou d’un planning Shifts est signalée avec l’endroit où ses membres sont gérés.
* Les files d’attente qui mélangent des utilisateurs attribués individuellement et des groupes sont prises en charge. Seules les attributions individuelles sont modifiées ; les groupes restent intacts et leurs membres sont toujours agents.
* La liste des agents d’une file d’attente d’appels est l’expansion propre au service des utilisateurs et des membres de groupe, et elle est mise en cache. Un utilisateur qui vient d’être ajouté à l’un des groupes attribués peut encore être signalé comme n’étant pas agent, et un utilisateur retiré d’un groupe peut encore apparaître pendant un certain temps.
* Vider complètement la liste des agents n’est pas possible ici volontairement. La suppression du dernier agent d’une file d’attente sans groupes est refusée, car une file d’attente sans agents ne peut pas recevoir d’appels. Faites-le dans le centre d’administration Teams si c’est vraiment voulu.
* Les noms des groupes, des équipes et des canaux proviennent de Microsoft Graph. Sans les autorisations facultatives correspondantes, le runbook affiche à la place les ID des objets et fonctionne exactement de la même manière.
### Emplacement
Organisation → Téléphone → Ajouter ou supprimer des agents de file d’attente d’appels
**Nom complet du runbook**
rjgit-org\_phone\_add-or-remove-call-queue-agents
### Détails
| Propriété | Valeur |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
| Version | 1.0.0 |
| Modules requis | RealmJoin.RunbookHelper (>= 0.8.10)
MicrosoftTeams (>= 7.9.0)
Microsoft.Graph.Authentication (>= 2.41.2)
|
| Planifiable | non |
### Autorisations
#### Autorisations d’application
* **Type**: Microsoft Graph
* Organization.Read.All
* *Requis par la connexion Teams PowerShell basée sur une application (Connect-MicrosoftTeams -Identity) pour lire les informations du locataire*
* Channel.ReadBasic.All *(facultatif — fonctionnalité : noms des groupes, des équipes et des canaux dans la sortie)*
* *Résout le nom du canal d’une file d’attente d’appels prise en charge par un canal d’équipe*
* GroupMember.Read.All *(facultatif — fonctionnalité : noms des groupes, des équipes et des canaux dans la sortie)*
* *Résout les noms d’affichage des groupes et des équipes Shifts attribués à la file d’attente d’appels*
* Team.ReadBasic.All *(facultatif — fonctionnalité : noms des groupes, des équipes et des canaux dans la sortie)*
* *Répertorie les équipes du propriétaire du canal pour trouver l’équipe derrière le canal de réponse*
#### rôles RBAC
* Administrateur Teams
* *Requis pour exécuter Get-CsCallQueue, Set-CsCallQueue et Get-CsOnlineUser via Teams PowerShell basé sur une application*
### Paramètres
#### CallQueueName
Nom exact de la file d’attente d’appels tel qu’affiché dans le centre d’administration Teams. La casse n’a pas d’importance, mais le nom doit correspondre exactement à une seule file d’attente.
| Propriété | Valeur |
| -------------------------- | --------------------------------- |
| Obligatoire | vrai |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Nom de la file d’attente d’appels |
#### UserIds
Utilisateurs à ajouter ou à supprimer, plusieurs à la fois. Pour fonctionner comme agent, un utilisateur a besoin d’une licence Teams Phone avec Enterprise Voice activé.
| Propriété | Valeur |
| -------------------------- | ------------ |
| Obligatoire | vrai |
| Valeur par défaut | |
| Type | String\[] |
| Nom d’affichage du portail | Utilisateurs |
#### Supprimer
Ajouter des utilisateurs en tant qu’agents les place dans la liste des agents attribués individuellement. Supprimer des utilisateurs en tant qu’agents les en retire ; les agents provenant d’un groupe ou d’une équipe restent inchangés.
| Propriété | Valeur |
| -------------------------- | ------- |
| Obligatoire | faux |
| Valeur par défaut | Faux |
| Type | Booléen |
| Nom d’affichage du portail | Action |
**Options du portail**
| Option du portail | Valeur |
| -------------------------------------------- | ------ |
| Ajouter des utilisateurs en tant qu’agents | faux |
| Supprimer des utilisateurs en tant qu’agents | vrai |
[Retour à l’aperçu de la référence du runbook](/fr/automatisation/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/fr/automatisation/runbooks/runbook-references/org/phone/add-or-remove-call-queue-agents.md?ask=&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.