Exemple d\'utilisation du Microsoft Teams package

Dans cet exemple, vous allez créer une automatisation pour envoyer une alerte d\'incident P1 à un canal Microsoft Teams spécifique, notifier directement l\'ingénieur d\'assistance d\'astreinte par chat, et enregistrer la conversation du canal dans les archives d\'incidents.

Procédure

  1. Créer une automatisation.
    1. Dans le panneau de gauche, cliquez sur Automatisation.

      La liste des robots et des formulaires disponibles s\'affiche.

    2. Cliquez sur Créer un robot.
    3. Saisissez le nom du robot : MSTeams_demo.
    4. Cliquez sur Créer et modifier.
  2. Connectez-vous à Microsoft Teams pour établir une session afin d\'authentifier et d\'exécuter toutes les actions Teams ultérieures.
    1. Double-cliquez ou faites glisser l\'Microsoft Teams > Se connecter action.
    2. Dans le champ Connexion OAuth2, saisissez MSTeam.
    3. Dans le champ Nom d\'utilisateur, saisissez office365_dev@automationanywhere.store
    4. Sélectionnez Default Session locale.
  3. Extraire l\'ID de l\'équipe spécifique.
    1. Faites glisser l\'action Microsoft Teams > Obtenir l\'équipe par son nom ou double-cliquez dessus.
    2. Dans le champ Nom de session, utilisez la même session que celle que vous avez utilisée pour vous connecter à Microsoft Teams, c\'est-à-dire Default.
    3. Dans le champ Nom de l\'équipe, saisissez Support Ops.
      Remarque : L\'équipe Support Ops doit exister dans l\'application Microsoft Teams.
    4. Dans le champ Attribuer l\'ID d\'équipe à une variable, saisissez $TeamID$
  4. Extraire l\'ID de canal unique d\'un canal spécifique au sein de l\'équipe Support Ops.
    1. Faites glisser l\'action Microsoft Teams > Obtenir le canal par son nom ou double-cliquez dessus.
    2. Dans le champ Nom de session, utilisez la même session que celle que vous avez utilisée pour vous connecter à Microsoft Teams, c\'est-à-dire Default.
    3. Dans le champ ID d\'équipe, saisissez $TeamID$.
    4. Dans le champ Nom du canal, saisissez Gestion des incidents.
      Remarque : Ce canal doit exister dans l\'application Microsoft Teams.
    5. Dans le champ Attribuer l\'ID du canal à une variable, créez une nouvelle variable nommée $ChannelID$.
  5. Publier l\'alerte dans le canal de gestion des incidents.
    Remarque : L\'hypothèse ici est que l\'application externe déclenche cette automatisation pour envoyer le message d\'alerte au canal Gestion des incidents.
    1. Faites glisser l\'action Microsoft Teams > Envoyer un message de canal ou double-cliquez dessus.
    2. Dans le champ ID d\'équipe, saisissez $TeamID$
    3. Dans le champ ID du canal, saisissez $ChannelID$
    4. Dans le champ Message, saisissez le message suivant :

      ID d\'incident : INC-2025-08-13-045

      Gravité : P1 – Critique pour l\'entreprise

      Détecté à : 13-Aug-2025 02:48 PM IST

      Description : L\'API de traitement des commandes renvoie des erreurs 500. Toutes les nouvelles commandes échouent lors du traitement.

      Impact : Les clients E-commerce ne peuvent pas finaliser les transactions.

      Étapes suivantes : L\'ingénieur d\'astreinte doit enquêter immédiatement sur les journaux de l\'API et l\'intégrité de la base de données.

    5. Dans le champ Attribuer l\'ID du message à une variable, créez une nouvelle variable nommée $MessageId$ pour stocker l\'ID du message d\'alerte.
  6. Récupérer les informations utilisateur de l\'ingénieur d\'assistance.
    1. Faites glisser l\'action Microsoft Teams > Obtenir les informations de l\'utilisateur ou double-cliquez dessus.
    2. Dans le champ Nom de session, sélectionnez la même session que celle que vous avez utilisée pour vous connecter à Microsoft Teams, c\'est-à-dire Default.
    3. Dans le champ Nom d\'utilisateur, créez une nouvelle variable pour stocker l\'adresse e-mail de l\'utilisateur afin de récupérer ses informations. Variable créée : $email$ (par exemple, tony.dean@office.store)
    4. Dans le champ Attribuer les informations de l\'utilisateur à une variable, sélectionnez l\'option Dictionnaire. Saisissez $user_dict$ pour enregistrer les informations de l\'utilisateur.
  7. Informer l\'Ingénieur via un message de chat direct.
    1. Faites glisser l\'action Microsoft Teams > Envoyer un message de chat ou double-cliquez dessus.
    2. Dans le champ Nom de session, sélectionnez la même session que celle que vous avez utilisée pour vous connecter à Microsoft Teams, c\'est-à-dire Default.
    3. Dans le champ Envoyer un message à > Adresse e-mail, spécifiez $user_dict{email}$
    4. Dans le champ Message, saisissez le message suivant :

      Bonjour $user_dict{displayName}$,

      un incident critique P1 a été détecté : Échec de l\'API de traitement des commandes. ID d\'incident : INC-2025-08-13-045 Détecté : 13-Aug-2025 02:48 PM IST Impact : Toutes les nouvelles commandes échouent.

      Veuillez rejoindre immédiatement la passrelle Incident : Lien du ticket pour Teams Meeting : Lien ServiceNow

      Alerte automatisée de A360 MS Teams Bot.

    5. Dans le champ Attribuer l\'ID du message à une variable, créez une nouvelle variable nommée $user_msgid$.
  8. Confirmer que le message est envoyé à l\'ingénieur.
    1. Faites glisser l\'action Microsoft Teams > Zone de message ou double-cliquez dessus.
    2. Dans le champ Entrer le message à afficher, saisissez Message envoyé à l\'ingénieur d\'assistance.
  9. Extraire et enregistrer l\'historique de discussion du canal.
    1. Double-cliquez ou faites glisser la Boucle action.
    2. Dans le champ déroulant d\'itérateur de boucle, sélectionnez l\'itérateur Microsoft Teams > Pour chaque message dans un canal.
    3. Dans le champ Nom de session, utilisez la même session que celle que vous avez utilisée pour vous connecter à Microsoft Teams, c\'est-à-dire Default.
    4. Dans le champ ID d\'équipe, saisissez $TeamID$
    5. Dans le champ ID du canal, saisissez $ChannelID$
    6. Dans le champ Date de début, créez une nouvelle variable nommée $start_dt$ avec la valeur 8/13/2025 03:00 PM IST (UTC+5.30) Calcutta Asia
    7. Dans le champ Date de fin, créez une nouvelle variable nommée $end_dt$ avec la valeur 8/14/2025 12:00 AM IST (UTC+5.30) Calcutta Asia
    8. Dans le champ Attribuer les détails du message à une variable, créez une variable nommée $ChannelMessageDetails$ pour stocker les messages du canal.
  10. Extraire les informations du message à l\'intérieur de l\'action Boucle.
    Remarque : Seuls les messages de groupe sont extraits et non les fils individuels.

    Faites glisser l\'Dictionnaire > Obtenir action pour chaque clé pour extraire sa valeur depuis $ChannelMessageDetails$:
    Clé Variable
    $ChannelMessageDetails (msg_id)$ $msg_id$
    $ChannelMessageDetails (msg)$ $msg$
    $ChannelMessageDetails (sentByUserID)$ $sentByUserID$
    $ChannelMessageDetails (sentByUsername)$ $sentByUsername$
    $ChannelMessageDetails (createdDateTime)$ $createdDateTime$
    $ChannelMessageDetails (modifiedDateTime)$ $modifiedDateTime$
  11. Consignez les informations du message du canal dans le fichier journal des incidents à l\'intérieur de l\'action boucle.
    • Double-cliquez ou faites glisser l\'action Journalisation > Journaliser les variables dans un fichier.
    • Dans le champ Chemin du fichier de sortie, entrez C:\output\Incident Log File.txt.
    • À partir de l\'option Lors de la journalisation, sélectionnez Ajouter au fichier journal existant.
    • Sélectionnez l\'option Sélection personnalisée pour identifier les variables à journaliser. Sélectionnez la variable suivante :
      • $createdDateTime$
      • $modifiedDateTime$
      • $msg$
      • $msg_id$
      • $sentByUserID$
      • $sentByUserName$
  12. Se déconnecter de Microsoft Teams.
    1. Double-cliquez ou faites glisser l\' Microsoft Teams > Se déconnecter action.
    2. Dans le champ Nom de session, sélectionnez la même session que celle que vous avez utilisée pour vous connecter à Microsoft Teams, c\'est-à-dire Default.
  13. Utilisez l\'Fichier > Ouvrir action pour ouvrir le fichier journal des incidents. Les informations ci-dessous seront affichées dans le fichier .txt.
    Clé Valeur
    msg_id Par exemple, 1692210012345
    msg

    Alerte d\'incident critique – Action requise

    ID d\'incident : INC-2025-08-13-045

    Gravité : P1 – Critique pour l\'entreprise

    Détecté à : 13-Aug-2025 02:48 PM IST

    Description : L\'API de traitement des commandes renvoie des erreurs 500. Toutes les nouvelles commandes

    ne peuvent pas être traitées.

    Impact : Les clients E-commerce ne peuvent pas finaliser les transactions.

    Étapes suivantes : L\'ingénieur d\'astreinte doit enquêter sur les journaux API et l\'intégrité de la base de données

    immédiatement.
    sentbyuserid par exemple, a-user-guid
    createddatetime 2025-08-13T14:50:12Z
    modifieddatetime 2025-08-13T14:50:12Z
    sentbyusername Par exemple, tony.dean@office.store