Configurer un webhook bidirectionnel pour le Microsoft Spoke Teams Graph

  • Rversion finale: Xanadu
  • Mis à jour 6 sept. 2024
  • 3 minutes de lecture

    • Configurez un webhook pour vous abonner à Microsoft Teams avec une URL de rappel ServiceNow.

    Avant de commencer

    • Demander l’abonnement requis au Centre d’intégration
    • Activez l’option Microsoft Spoke Teams Graph
    • Rôle requis : administrateur

    Enregistrer un webhook Microsoft Teams Graph dans l’instance ServiceNow

    Enregistrez Microsoft Teams dans votre instance ServiceNow pour notifier l’application ServiceNow lorsque certains événements se produisent dans Microsoft Teams.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Microsoft Teams Graph Spoke > Registre Webhook.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs suivants du formulaire :
      Nom Nom permettant d’identifier le registre webhook. Par exemple, le registre de webhook MS Teams Graph.
      État du client État du client
      Chemin d'accès Chemin d’accès au webhook Microsoft Teams Graph. Ce champ est renseigné automatiquement vers api/sn_msteams_ahv2/ms_teams_webhook.
      Description Description du registre Webhook.
    4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    5. Cliquez sur URL de rappel.
      Le système remplit automatiquement l’URL de rappel webhook.

    Créer un abonnement à un webhook pour un canal

    Créez un abonnement à un webhook pour le canal requis dans une équipe en testant le flux secondaire S’abonner au webhook.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Automatisation des processus > Studio de workflow.
    2. Cliquez sur Flux secondaires.
    3. Ouvrez le flux secondaire S’abonner au webhook .
    4. Cliquez sur Test.
    5. Renseignez ces valeurs sur le formulaire.
      Champ Description
      Nom d'enregistrement du registre webhook Nom de l’enregistrement de webhook que vous avez fourni lors de l’enregistrement du webhook dans l’instance ServiceNow. Par exemple, le registre de webhook MS Teams Graph.
      Type de changement Type de changement dans la ressource abonnée qui doit envoyer une notification de changement. Les valeurs prises en charge sont : créé, mis à jour et supprimé. Vous pouvez fournir plusieurs valeurs séparées par des virgules.
      ID de l'équipe Identificateur unique de l’équipe.
      ID de canal Identificateur unique du canal.
      Figure 1. Tester le flux secondaire S’abonner au webhook
      Testez le flux secondaire S’abonner au webhook pour les types de changements requis.
    6. Cliquez sur Exécuter le test.
      L’abonnement pour le canal requis est créé.

      Reportez-vous à la section Création de flux secondaires pour plus d’informations sur le test des flux secondaires.

    Personnaliser un flux secondaire de spoke

    Personnalisez le flux secondaire requis qui est expédié avec le spoke en créant une copie de celui-ci.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Automatisation des processus > Studio de workflow.
    2. Cliquez sur Flux secondaires.
    3. Ouvrez le flux secondaire requis qui est fourni avec le spoke Microsoft Teams Graph.
      Par exemple, le flux secondaire Traiter les notifications entrantes .
    4. Cliquez sur l’icône Actions supplémentaires ( menu Actions supplémentaires) et sélectionnez Copier le flux secondaire.
    5. Dans Nouveau nom de flux, saisissez un nom unique que vous souhaitez donner au flux secondaire copié.
      Par exemple, copie du flux secondaire Traiter les notifications entrantes .
    6. Cliquez sur Copier.
      Une copie du flux secondaire est créée.
    7. Personnalisez le flux secondaire en fonction de vos besoins et publiez-le.
      Pour plus d’informations sur la création et l’utilisation de flux secondaires, consultez Création de flux secondaires .

    Configurer la politique décisionnelle de Webhook Microsoft Teams Graph

    Créez une politique d’acheminement de webhook et un flux secondaire en fonction de vos besoins.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Microsoft Teams Graph Spoke > Politique de décision Webhook
    2. Cliquez sur Nouveau.
    3. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Décision
      Champ Description
      Étiquette Étiquette unique pour identifier la politique d’acheminement.
      Réponse

      Flux secondaire qui doit être déclenché lorsque les conditions sont remplies.

      1. Cliquez sur l’icône Rechercher.
      2. Sélectionnez le flux secondaire requis dans la liste Document :. Par exemple, Copie du traitement des notifications entrantes.
      Réponse par défaut Option permettant de spécifier si cette réponse est la réponse par défaut. La réponse par défaut s’applique lorsque les conditions ne sont pas remplies.
      Condition Conditions à remplir lorsque le webhook entrant fournit des données à partir de Microsoft Teams.
    4. Cliquez sur Envoyer.
      Remarque :
      Ces politiques d’acheminement sont enregistrées dans les tables de décision. Les utilisateurs sont mis en garde contre la mise à jour ou la modification directe des données de ces tables.