Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Microsoft Graph API permite a las aplicaciones administrar los estados de presencia del usuario en varias sesiones, lo que garantiza actualizaciones de disponibilidad precisas y dinámicas.
Sesiones de presencia
Un usuario puede tener varias sesiones de presencia porque el usuario puede estar en varios clientes de Teams (escritorio, móvil y web). Cada cliente de Teams tiene una sesión de presencia independiente y la presencia del usuario es un estado agregado de todas las sesiones subyacentes.
De forma similar, una aplicación puede tener su propia sesión de presencia para un usuario y poder actualizar el estado.
La precedencia siguiente se usa para cómo se agregan los estados de sesión, con "A > B" que representa que A tiene prioridad sobre B:
- Estados de nivel de sesión de estado > preferidos por el usuario (el estado preferido por el usuario invalida los estados de nivel de sesión)
- Entre los estados de nivel de sesión: DoNotDisturb > Busy > Available > Away
Nota: Cuando cambia la presencia de un usuario en Microsoft Graph, dado que el cliente de Teams usa el modo de sondeo, se tarda unos minutos en actualizar el estado de presencia.
Permutaciones de estados de presencia
| Estado de Teams | Disponibilidad o actividad de Graph |
|---|---|
| Disponible | available/available |
| Disponible, fuera de la oficina | available / outOfOffice |
| Ocupado | busy/busy |
| En una llamada | busy / inACall |
| En reunión | busy / inAMeeting |
| En una llamada, fuera de la oficina | busy / inACall + OOF |
| No molestar | doNotDisturb / doNotDisturb |
| Presentando | doNotDisturb / presenting |
| Lejos | away / away |
| Enseguida regreso | beRightBack / beRightBack |
| Aparece sin conexión | offline / offWork |
| Fuera de la oficina | outOfOffice |
Nota:
El método setPresence no admite la configuración de los estados de presencia Fuera de la oficina (OOF) o En una reunión directamente. Estos estados se administran automáticamente en función de los eventos de calendario y las configuraciones de buzón, y el intento de establecerlos a través del método setPresence no tiene ningún efecto.
Para reflejar "Fuera de la oficina" en presencia, use la API de eventos estableciendo la propiedad showAs de un evento oofde calendario en o configurando la configuración de autorreplicación del usuario mediante mailboxSettings.
El estado "En una reunión" se refleja automáticamente durante los eventos programados de reunión del calendario y no requiere actualizaciones manuales de presencia.
Tiempo de espera, expiración y mantenimiento activo
Una sesión de presencia puede agotar el tiempo de espera y expirar, por lo que la aplicación debe llamar a la presencia: setPresence API antes del tiempo de espera, para mantener el estado de la sesión; o antes de la expiración, para mantener activa la sesión.
Una sesión de presencia puede agotar el tiempo de espera si la disponibilidad es Available y el tiempo de espera es de cinco minutos. Cuando se agota el tiempo de espera, el estado de presencia se desvanece en fases. Por ejemplo, si una aplicación establece la sesión de presencia como Available/Available, el estado cambiaría a Available/AvailableInactive en cinco minutos con el primer tiempo de espera, a continuación Away/Away , en otros cinco minutos con el segundo tiempo de espera.
Use expirationDuration para configurar la expiración de una sesión de presencia; de lo contrario, la expiración predeterminada es de cinco minutos. Los valores válidos van de cinco minutos a cuatro horas, después de lo cual la sesión se convierte Offlineen .
Dominios de confianza para la visibilidad y la interacción entre inquilinos
Configure el acceso externo en el Centro de administración de Teams para que solo las organizaciones asociadas previstas puedan ver y actuar en presencia de los usuarios. En el Centro de administración de Teams (acceso externo de usuarios>), permita todos los dominios o agregue dominios específicos a la lista Permitir en Reuniones y chatear con organizaciones de Microsoft 365 de confianza. Los usuarios de esas organizaciones de confianza pueden ver la presencia del usuario. La presencia entre inquilinos requiere confianza mutua y el asociado también debe permitir el dominio. Los dominios que no son de confianza (o están bloqueados) no pueden ver la presencia ni iniciar interacciones controladas por presencia. Para obtener más información, consulte Especificar organizaciones de Microsoft 365 de confianza.