Usar la API de Microsoft Graph para trabajar con Microsoft Teams
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Microsoft Teams es un área de trabajo basada en chat de Microsoft 365 que ofrece acceso integrado a calendarios, archivos, notas de OneNote, planes de Planner, programaciones de Turnos y otras aplicaciones específicas del equipo. Puede usar la Graph API de Microsoft para integrarse con las características de Microsoft Teams.
Casos de uso comunes
En la tabla siguiente se enumeran los casos de uso comunes de las API de Microsoft Teams en Microsoft Graph.
| Casos de uso | Recursos de REST | Vea también |
|---|---|---|
| Creación y administración de equipos, grupos y canales | equipo, canal, grupo | crear equipo, enumerar equipos, crear un canal |
| Agregar pestañas, administrar o instalar aplicaciones en el catálogo de aplicaciones de Microsoft Teams | teamsTab, teamsAppInstallation | create teamsTab, list teamsTab, list installedApps |
| Creación de canales y chats para enviar y recibir mensajes de chat | channel, chat, chatMessage | crear canal, enumerar canal, enviar chatMessage en un canal |
| Uso de etiquetas para clasificar usuarios o grupos en función de atributos comunes dentro de un equipo | teamworkTag, teamworkTagMember | list teamworkTag, create teamworkTag |
| Creación y recepción de llamadas, registros de llamadas o recuperación de coordenadas de reunión | call, callRecords | respuesta, invitar a participantes |
| Conexión de bots a llamadas e implementación de respuesta de voz interactiva (IVR) | call | Escenarios IVR |
| Creación y recuperación de reuniones en línea o comprobación de la presencia y actividad de los usuarios | onlineMeeting, presencia | create onlineMeeting, meetingAttendanceReport |
| Creación y administración de la integración de los empleados con turnos, programaciones, tarjetas de tiempo o tiempo de espera en la organización | workforceIntegration, schedule, shift, timeOff, timeOffReason | create workforceIntegration, create schedule, create shift, create timeOff |
| Uso de la API de aprendizaje de empleados para integrarse con Viva Learning | aprendizaje de empleados, learningProvider, learningContent | list learningProviders, list learningContents |
Escenarios IVR
A continuación se muestran los escenarios de respuesta de voz interactiva (IVR) que admiten las API de llamada de Microsoft Graph:
- Reproducir un símbolo del sistema de audio : por ejemplo, cuando se realiza una llamada en la cola de un agente de servicio al cliente.
- Grabar una respuesta : por ejemplo, para grabar el audio del autor de la llamada, normalmente después de escuchar un mensaje con opciones.
- Suscribirse a tonos : por ejemplo, cuando desee saber qué tonos DTMF seleccionó el autor de la llamada, normalmente después de escuchar el mensaje de audio.
- Cancelar el procesamiento multimedia : por ejemplo, cuando se desea cancelar cualquier operación playPrompt o recordResponse que pueda estar en proceso.
Límites de Microsoft Teams
Los límites de rendimiento y capacidad probados de Microsoft Teams se documentan en Límites y especificaciones de Microsoft Teams. Estos límites se aplican tanto si se usa Microsoft Teams directamente como si se usan las API de Microsoft Graph. Como cada equipo tiene un grupo correspondiente, y todos los grupos son objetos de directorio, también se pueden limitar el número de grupos y el número de objetos de directorio ("recursos").
Los archivos en canales se almacenan en SharePoint, por lo que se aplicarán los límites de SharePoint Online.
Vea también Limitación de servicios de Microsoft Teams.
Equipos y grupos
En Microsoft Graph, Microsoft Teams se representa mediante un recurso group. Los grupos de Microsoft Teams y Microsoft 365 abordan las diversas necesidades de colaboración en grupo. Casi todas las características que se basan en grupos se aplican a los grupos de Microsoft Teams y Microsoft 365, como el calendario de grupo, los archivos, las notas, las fotos, los planes, etcétera. La principal diferencia entre un team y un grupo de Microsoft 365 es el modo de comunicación entre los miembros. Los miembros de un equipo se comunican por chat persistente en el contexto de un equipo específico. Los miembros de un grupo de Microsoft 365 se comunican a través de las conversaciones del grupo, las cuales son conversaciones por correo electrónico que se ejecutan en el contexto de un grupo de Outlook.
Cualquier grupo que tiene un equipo tiene un equipo presenta una propiedad resourceProvisioningOptions que contiene "Equipo".
Nota: La propiedad Group.resourceProvisioningOptions puede cambiarse. No agregue ni quite "Equipo" de esa colección; en caso contrario, obtendrá resultados incorrectos cuando se enumeren todos los equipos.
Estas son las diferencias en el nivel de API entre equipos y grupos:
- El chat persistente solo está disponible para Microsoft Teams. Esta característica se representa jerárquicamente mediante los recursos channel y chatMessage.
- Las conversaciones en grupo solo están disponibles para grupos de Microsoft 365. Esta característica se representa jerárquicamente mediante los recursos conversation, conversationThread y post.
- El método List joined teams solo se aplica a Microsoft Teams.
- Las API de llamadas y reuniones en línea solo se aplican a Microsoft Teams.
- Vea también los problemas conocidos con estas API.
Cambios de pertenencia en Microsoft Teams
| Caso de uso | Verbo | URL |
|---|---|---|
| Agregar miembro | POST | /teams/{team-id}/members |
| Eliminar miembro | DELETE | /teams/{team-id}/members/{membership-id} |
| Actualizar el rol del miembro | PATCH | /teams/{team-id}/members/{membership-id} |
| Actualizar equipo | PATCH | /teams/{team-id} |
Requisitos de sondeo
Si la aplicación realiza un sondeo para ver si un recurso ha cambiado, solo puede hacerlo una vez al día. (teamsAsyncOperation es una excepción que está previsto que se sondee con frecuencia). Si necesita ver los cambios con mayor frecuencia, debe crear una suscripción a ese recurso y recibir notificaciones de cambios (webhooks). Si no encuentra soporte técnico para el tipo de suscripción que necesita, le recomendamos que envíe comentarios a través del Foro de ideas de la plataforma Microsoft 365 para Desarrolladores.
Cuando se sondea para ver si hay mensajes nuevos, se debe especificar un intervalo de fechas donde se admita. Para obtener más información, consulte Obtención de mensajes de chat delta para un usuario.
El sondeo está realizando una operación GET en un recurso una y otra vez para ver si el recurso ha cambiado. Es posible usar GET para obtener el mismo recurso varias veces al día, siempre y cuando no sea un sondeo. Por ejemplo, está bien obtener /me/joinedTeams cada vez que el usuario visita o actualiza la página web, pero no está bien obtener /me/joinedTeams en un bucle cada 30 segundos para actualizar esa página web.
Las aplicaciones que no cumplan con estos requisitos de sondeo se considerarán una violación de las Condiciones de uso de las API de Microsoft. Esto puede dar lugar a una limitación adicional o la suspensión o terminación del uso de las API de Microsoft.