Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Microsoft API Graph permet aux applications de gérer les états de présence des utilisateurs sur plusieurs sessions, ce qui garantit des mises à jour de disponibilité précises et dynamiques.
Sessions de présence
Un utilisateur peut avoir plusieurs sessions de présence, car il peut être sur plusieurs clients Teams (bureau, mobile et web). Chaque client Teams a une session de présence indépendante et la présence de l’utilisateur est un état agrégé de toutes les sessions derrière.
De même, une application peut avoir sa propre session de présence pour un utilisateur et être en mesure de mettre à jour l’état.
La priorité suivante est utilisée pour la façon dont les états de session sont agrégés, avec « A > B » représentant que A a priorité sur B :
- États de session préférés > par l’utilisateur (l’état préféré par l’utilisateur remplace les états au niveau de la session)
- Parmi les états au niveau de la session : DoNotDisturb > Busy > Available Away >
Note: Quand la présence d’un utilisateur change dans Microsoft Graph, car le client Teams utilise le mode d’interrogation, la mise à jour de la présence status prend quelques minutes.
Permutations des états de présence
| État de Teams | Disponibilité / activité du graphique |
|---|---|
| Disponible | available/available |
| Disponible, absence du bureau | available / outOfOffice |
| Occupé(e) | busy/busy |
| Dans un appel | busy / inACall |
| En réunion | busy / inAMeeting |
| Dans un appel, absence du bureau | busy / inACall + OOF |
| Ne pas déranger | doNotDisturb / doNotDisturb |
| Présentant | doNotDisturb / presenting |
| Loin | away / away |
| On revient | beRightBack / beRightBack |
| Apparaître hors connexion | offline / offWork |
| Absent(e) du bureau | outOfOffice |
Remarque
La méthode setPresence ne prend pas en charge la définition des états de présence Absence du bureau (OOF) ou Dans une réunion directement. Ces états sont gérés automatiquement en fonction des événements de calendrier et des configurations de boîte aux lettres, et la tentative de les définir via la méthode setPresence n’a aucun effet.
Pour refléter « Absence du bureau » en présence, utilisez l’API d’événements en définissant la propriété showAs d’un événement oofde calendrier sur , ou configurez les paramètres d’authentification de l’utilisateur à l’aide de mailboxSettings.
L’état « En réunion » est automatiquement réperclé pendant les événements de réunion du calendrier planifiés et ne nécessite pas de mises à jour de présence manuelles.
Délai d’expiration, expiration et maintien en vie
Une session de présence peut expirer et expirer. L’application doit donc appeler l’API de présence : setPresence avant le délai d’expiration, afin de conserver l’état de la session ; ou avant l’expiration, pour maintenir la session active.
Une session de présence peut expirer si la disponibilité est Available et que le délai d’expiration est de cinq minutes. Lorsqu’il expire, l’état de présence s’estompe par étapes. Par exemple, si une application définit la session de présence sur Available/Available, l’état passe à Available/AvailableInactive dans cinq minutes avec le premier délai d’expiration, puis Away/Away dans cinq autres minutes avec le deuxième délai d’expiration.
Utilisez expirationDuration pour configurer l’expiration d’une session de présence ; sinon, l’expiration par défaut est de cinq minutes. Les valeurs valides sont comprises entre cinq minutes et quatre heures, après quoi la session devient Offline.
Domaines approuvés pour la visibilité et l’interaction de la présence entre locataires
Configurez l’accès externe dans le Centre d’administration Teams, afin que seules les organisations partenaires prévues puissent voir et agir sur la présence de vos utilisateurs. Dans le Centre d’administration Teams (Utilisateurs > Accès externe), autorisez tous les domaines ou ajoutez des domaines spécifiques à la liste Autoriser sous Réunions et conversation avec des organisations Microsoft 365 approuvées. Les utilisateurs de ces organisations approuvées peuvent afficher la présence des utilisateurs. La présence interlocataire nécessite une confiance mutuelle, et le partenaire doit également autoriser votre domaine. Les domaines qui ne sont pas approuvés (ou qui sont bloqués) ne peuvent pas voir la présence ou être en mesure d’initier des interactions basées sur la présence. Pour plus d’informations, consultez Spécifier des organisations Microsoft 365 approuvées.