Partager via


Utiliser l’API Microsoft Graph à utiliser avec Microsoft Teams

Microsoft Teams est une plateforme qui facilite le travail en équipe via la messagerie instantanée dans Office 365. Dans cet espace de travail, vous pouvez notamment accéder aux calendriers, fichiers, notes OneNote, plans du Planificateur et plannings Shifts d’une équipe. Vous pouvez utiliser microsoft API Graph pour intégrer les fonctionnalités de Microsoft Teams.

Cas d’utilisation courants

Le tableau suivant répertorie les cas d’usage courants pour les API Microsoft Teams dans Microsoft Graph.

Cas d'utilisation Ressources REST Voir aussi
Créer et gérer des équipes, des groupes et des canaux équipe, canal, groupe créer une équipe, lister les équipes, créer un canal
Ajouter des onglets, gérer ou installer des applications dans le catalogue d’applications Microsoft Teams teamsTab, teamsAppInstallation créer teamsTab, lister teamsTab, répertorier les applications
Créer des canaux et des conversations pour envoyer et recevoir des messages de conversation channel, chat,chatMessage créer un canal, lister le canal, envoyer chatMessage
Utiliser des étiquettes pour classifier des utilisateurs ou des groupes en fonction d’attributs communs au sein d’une équipe teamworkTag, teamworkTagMember list teamworkTag, create teamworkTag
Créer et recevoir des appels, appeler des enregistrements ou récupérer des coordonnées de réunion call, callRecords répondre, inviter des participants
Connecter des bots aux appels et implémenter une réponse vocale interactive (IVR) Appel Scénarios IVR
Créer et récupérer des réunions en ligne ou case activée la présence et l’activité des utilisateurs onlineMeetings, presence create onlineMeetings, meetingAttendanceReport
Créez et gérez l’intégration de la main-d’œuvre avec des équipes, des horaires, des cartes de temps ou des congés dans votre organization workforceIntegration, schedule, shift, timeOffReason create workforceIntegration, create schedule, create shift, create timeOff
Utiliser l’API d’apprentissage des employés pour s’intégrer à Viva Learning employee learning, learningProvider, learningContent list learningProviders, list learningContents

Scénarios IVR

Voici les scénarios de réponse vocale interactive (IVR) pris en charge par les API appelantes dans Microsoft Graph :

  • Lire une invite audio , par exemple lorsqu’un appel est placé dans la file d’attente d’un agent du service clientèle.
  • Enregistrez une réponse  : par exemple, pour enregistrer l’audio de l’appelant, généralement après avoir entendu une invite avec des options.
  • Abonnez-vous aux tonalités , par exemple, lorsque vous souhaitez connaître les sons DTMF sélectionnés par l’appelant, généralement après avoir entendu l’invite audio.
  • Annuler le traitement multimédia : par exemple, lorsque vous souhaitez annuler les opérations playPrompt ou recordResponse qui peuvent être en cours.

Limites de Microsoft Teams

Les limites Microsoft Teams de performances et de capacités testées sont décrites dans les Limites et spécifications de Microsoft Teams. Ces limites s’appliquent en utilisant directement Microsoft Teams ou à l'aide des API Microsoft Graph. Comme chaque équipe dispose d'un groupe correspondant et que chaque groupe est un objet d’annuaire, les limites du nombre de groupes et du nombre d'objets d'annuaire (« ressources ») peuvent également entrer en jeu.

Les fichiers dans les canaux sont stockés dans SharePoint. Les Limites de SharePoint Online s’appliquent.

Voir également les Seuils de limitation pour les services Microsoft Teams.

Équipes et groupes

Dans Microsoft Graph, Microsoft Teams est représenté par une ressource group. Les groupes Microsoft Teams et Office 365 facilitent la collaboration en groupe. Presque toutes les fonctionnalités de groupe s'appliquent aux groupes Microsoft Teams et Microsoft 365, telles que le calendrier de groupe, les fichiers, les notes, la photo, les plans, etc. La principale différence entre un groupe Teams et un groupe Microsoft 365 est le mode de communication entre les membres. Les membres de l’équipe communiquent via une conversation permanente dans le contexte d’une équipe spécifique. Les membres d’un groupe Microsoft 365 communiquent via des conversations de groupe, c’est-à-dire des conversations par e-mail sur Outlook.

Dans tous les groupes dotés d’une équipe, la propriété resourceProvisioningOptions contient une ressource « Team ».

Remarque : la propriété Group.resourceProvisioningOptions peut être modifiée. Nous vous déconseillons d’ajouter ou de supprimer « Team » dans cette collection. Sinon, vous obtiendrez des résultats incorrects quand vous répertorierez toutes les équipes.

Voici les différences entre les équipes et les groupes au niveau de l’API :

Modification des appartenances dans Microsoft Teams

Cas d’utilisation Verbe URL
Ajouter un membre POST /teams/{team-id}/members
Supprimer un membre SUPPRIMER /teams/{team-id}/members/{membership-id}
Mettre à jour le rôle d’un membre PATCH /teams/{team-id}/members/{membership-id}
Mettre à jour une équipe PATCH /teams/{team-id}

Conditions d'interrogation

Si votre application effectue des interrogations pour déterminer si une ressource a changé, vous ne pouvez le faire qu’une fois par jour. (teamsAsyncOperation est une exception car elle est conçue pour être interrogée fréquemment). Si vous devez prendre plus régulièrement connaissance des modifications, vous devez créer un abonnement à cette ressource et recevoir des notifications de modifications (webhooks). Si vous ne trouvez pas le support concernant le type d’abonnement dont vous avez besoin, nous vous invitons à nous envoyer des commentaires via Forum d'idées sur la plateforme pour développeurs Microsoft 365.

Lorsque vous effectuez une interrogation relatives à de nouveaux messages, vous devez indiquer une plage de dates en cas de prise en charge. Pour plus d’informations, consultez Obtenir des messages de conversation delta pour un utilisateur.

L’interrogation effectue plusieurs fois une opération GET (OBTENIR) sur une ressource pour déterminer si celle-ci a changé. Vous pouvez GET la même ressources plusieurs fois par jour, à condition qu'il ne s'agisse pas d'une interrogation. Par exemple, il est possible d’obtenir /me/joinedTeams chaque fois que l’utilisateur visite/actualise votre page web, mais il n’est pas possible d’obtenir /me/joinedTeams dans une boucle toutes les 30 secondes pour actualiser cette page web.

Les applications qui ne suivant pas ces exigences en matière d’interrogation sont considérées comme étant en violation avec les Conditions d’utilisation des API Microsoft. Cela peut entraîner une limitation supplémentaire ou la suspension ou l'arrêt de votre utilisation des API Microsoft.