Installer de manière proactive votre bot pour les utilisateurs à l’aide de Microsoft Graph

Si vous devez envoyer des messages à des utilisateurs qui n’ont pas installé ou n’ont pas déjà interagi avec votre application, par exemple pour diffuser des informations importantes à tous les utilisateurs de votre organization, vous pouvez utiliser microsoft API Graph pour installer votre bot de manière proactive pour ces utilisateurs. Pour que votre bot puisse faire passer un message proactif à un utilisateur, il doit être installé en tant qu’application personnelle ou dans une équipe où l’utilisateur est membre.

Cet article explique comment utiliser Microsoft Graph pour case activée status d’installation et installer votre bot par programmation. Après l’installation, consultez Envoyer un message de bienvenue personnel pour savoir comment récupérer l’ID de conversation et envoyer un message 1:1 à l’utilisateur.

Autorisations

Les autorisations de type de ressource Microsoft Graph teamsAppInstallation vous aident à gérer le cycle de vie d’installation de votre application pour toutes les étendues d’utilisateur (personnel) ou d’équipe (canal) au sein de la plateforme Microsoft Teams :

Pour utiliser ces autorisations, vous devez ajouter une clé webApplicationInfo à votre manifeste d’application (précédemment appelé manifeste d’application Teams) avec les valeurs suivantes :

• id : VOTRE ID d’application Microsoft Entra.
• ressource : URL de ressource pour l’application

Activer l’installation proactive du bot et de la messagerie proactive

Créer et publier votre bot de messagerie proactive pour Teams

Pour commencer, vous avez besoin d’un bot pour Teams avec des fonctionnalités de messagerie proactive qui se trouve dans l’App Store de votre organization ou dans le Magasin Teams.

Obtenir teamsAppId pour votre application

Vous pouvez effectuer ce teamsAppId des façons suivantes :

• À partir du catalogue d’applications de votre organisation :

  Informations de référence sur la page Microsoft Graph :teamsApp, type de ressource

  Demande HTTP GET :

  GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$filter=externalId eq '{IdFromManifest}'
  

  La demande doit retourner un teamsApp objet id, qui est l’ID d’application généré par le catalogue de l’application. Cela diffère de l’ID que vous avez fourni dans le manifeste de votre application :

  {
    "value": [
      {
        "id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5",
        "externalId": "f31b1263-ba99-435a-a679-911d24850d7c",
        "name": "Test App",
        "version": "1.0.1",
        "distributionMethod": "Organization"
      }
    ]
  }
  

  Remarque

  Lorsque l’application se trouve dans le Magasin Teams, est teamsAppId identique à IdFromManifest et ne externalId doit pas être utilisé dans ce cas.

• Si votre application a déjà été chargée pour un utilisateur dans l’étendue personnelle :

  Informations de référence sur la page Microsoft Graph :Lister les applications installées pour l’utilisateur

  Demande HTTP GET :

  GET https://graph.microsoft.com/v1.0/users/{user-id}/teamwork/installedApps?$expand=teamsApp&$filter=teamsApp/externalId eq '{IdFromManifest}'
  

• Si votre application a déjà été chargée pour un canal dans l’étendue de l’équipe :

  Informations de référence sur la page Microsoft Graph :Répertorier les applications dans l’équipe

  Demande HTTP GET :

  GET https://graph.microsoft.com/v1.0/teams/{team-id}/installedApps?$expand=teamsApp&$filter=teamsApp/externalId eq '{IdFromManifest}'
  

  Conseil

  Pour affiner la liste des résultats, vous pouvez filtrer n’importe quel champ de l’objet teamsApp.

Déterminer si votre bot est installé pour un destinataire de message

Vous pouvez déterminer si votre bot est installé pour un destinataire de message comme suit :

Informations de référence sur la page Microsoft Graph :Lister les applications installées pour l’utilisateur

Demande HTTP GET :

GET https://graph.microsoft.com/v1.0/users/{user-id}/teamwork/installedApps?$expand=teamsApp&$filter=teamsApp/id eq '{teamsAppId}'

La requête renvoie aux :

• Tableau vide si l’application n’est pas installée.
• Tableau avec un objet teamsAppInstallation unique si l’application est installée.

Installez votre application.

Vous pouvez installer votre application comme suit :

Informations de référence sur la page Microsoft Graph :Installer l’application pour l’utilisateur

Demande HTTP POST

POST https://graph.microsoft.com/v1.0/users/{user-id}/teamwork/installedApps
Content-Type: application/json

{
   "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/{teamsAppId}"
}

Si l’utilisateur a Microsoft Teams en cours d’exécution, l’installation de l’application se produit immédiatement. Un redémarrage peut être nécessaire pour afficher l’application installée.

Pour les étapes suivantes, consultez Envoyer un message de bienvenue personnel pour savoir comment récupérer l’ID de conversation et envoyer un message 1:1 à l’utilisateur.

Exemple de code

Exemples de code d’application de messagerie supplémentaires

Voir aussi

• Gérer les stratégies de mise en application dans Teams
• Messagerie proactive avec le Kit de développement logiciel (SDK) Teams
• Envoyer des notifications de flux d’activité aux utilisateurs dans Microsoft Teams
• Ajouter une application à l’équipe - Microsoft Graph v1.0
• Limites du service Microsoft Teams