Activer le lien profond pour accéder à Automation Co-Pilot dans Microsoft Teams

Ce sujet explique comment obtenir les identifiants requis et assembler un lien profond Microsoft Teams qui ouvre Automation Co-Pilot directement sur une demande spécifique dans Microsoft Teams.

Prérequis

Pour créer un lien profond fonctionnel, vous avez besoin des éléments suivants :
ID de l\'application
L\'ID de l\'application Microsoft Teams (parfois appelé ID d\'application Microsoft dans la configuration de l\'application Teams).
ID de l\'entité
L\'identifiant de l\'onglet Personnel (l\'onglet que vous souhaitez ouvrir dans Microsoft Teams).
ID de demande
La référence de demande Automation Co-Pilot que vous souhaitez que le lien ouvre.

Procédure

  1. Créez ou ouvrez votre application Teams (ID de l\'application).
    1. Ouvrez le Portail Développeur Microsoft Teams.
    2. Sélectionnez Applications.
      Si vous avez déjà une application pour Automation Co-Pilot, ouvrez-la. Sinon, sélectionnez Créer une nouvelle application et saisissez les informations requises telles que le nom, la description, les informations du développeur.
    3. Copiez l\'ID d\'application affiché pour l\'application (celui-ci est utilisé dans l\'URL de lien profond).
    Vous avez obtenu un ID d\'application.
    Par exemple :
    https://teams.microsoft.com/l/app/96bfc9ea-ffac-410d-96ca-df449bl83cl3?source=manage-apps-copy-link
    Ici, 96bfc9ea-ffac-410d-96ca-df449bl83cl3 (la partie après app/ est l\'ID d\'application.
    L\'<APP_ID> est créé.
  2. Configurez un onglet Personnel et capturez l\'ID d\'entité.
    1. Dans la même application dans le Portail Développeur Teams, allez à Fonctionnalités de l\'application.
    2. Localisez Application personnelle (ou l\'onglet Personnel selon l\'affichage du portail).
    3. Ajoutez un onglet Personnel (ou modifiez-le si vous en avez déjà un) et saisissez les informations suivantes, par exemple :
      • Nom : Automation Co-Pilot
      • URL de contenu : l\'URL Web que votre onglet charge (fournie par votre configuration Automation Co-Pilot)
      • URL du site Web (Facultatif mais recommandé) : une URL compatible avec les navigateurs
    4. Enregistrez la configuration.
    5. Copiez l\'ID d\'entité pour cet onglet Personnel.
    Vous avez obtenu un ID d\'entité. Par exemple, 0eff0783-9304-4daa -9f6e-dfe0e8d0cfb3
  3. Obtenez l\'ID de la demande (Automation Co-Pilot).

    Vous pouvez utiliser l\'une des méthodes suivantes pour capturer l\'ID de demande qui représente la demande que vous souhaitez que le lien profond ouvre.

    • Copier depuis la page de demande
      • Ouvrez Automation Co-Pilot et accédez à la demande.
      • Copiez la référence de la demande depuis l\'interface utilisateur (par exemple, Réf de demande),

        ou

      • Copiez-la depuis l\'URL si la référence de la demande apparaît dans le chemin.

      Les formats typiques observés dans les itinéraires sont requests/ref/<REQUEST_ID>. Par exemple, requests/ref/62-152

    • Copier à partir d\'une charge utile de notification (le cas échéant)

      Si votre processus envoie un message ou une notification contenant une référence de demande, copiez directement la référence de demande depuis cette charge utile.

    Vous avez obtenu l\'ID de la demande. Par exemple, requests/ref/62-152
  4. Générez le lien profond.
    Le lien profond de l\'onglet Personnel dans Teams utilise ce format :
    https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<DEEP_LINK_PARAMETER>

    Pour ouvrir une demande spécifique dans l\'onglet, transmettez un paramètre context Teams avec un subEntityId pointant vers l\'itinéraire de la demande. Pour générer le lien profond,

    1. Définissez la sous-entité route comme subEntityId = "requests/ref/<REQUEST_ID>". Par exemple, requests/ref/62-152.
    2. Créez le JSON de contexte comme {"subEntityId":"requests/ref/<REQUEST_ID>"}.
    3. Encodez le paramètre de contexte en URL.

      Teams s\'attend à ce que la chaîne de requête soit encodée. Le paramètre est généralement context=<JSON>. Par exemple, (avant encodage) : context={"subEntityId":"requests/ref/62-152"}.

      Encodez entièrement cette valeur en URL et ajoutez-la après ?.

    4. Exemple final de lien profond (modèle) : https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<URL_ENCODED_CONTEXT> où <URL_ENCODED_CONTEXT> est la forme encodée de : context={"subEntityId":"requests/ref/<REQUEST_ID>"}
  5. Testez le lien profond dans Microsoft Teams.
    1. Collez le lien profond dans un message de chat ou de canal Teams.
    2. Sélectionnez le lien.
    Teams ouvre l\'onglet de l\'application Automation Co-Pilot et accède directement à la demande souhaitée.