Configurer un webhook bidirectionnel pour le Microsoft Spoke Teams Graph

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture

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

    Avant de commencer

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

    Enregistrer un webhook Microsoft Teams Graph dans l’instance ServiceNow

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

    Avant de commencer

    Rôle requis : admin

    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 webhooks 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 dans 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 à 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 : admin

    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 webhook que vous aviez fourni lors de l’enregistrement du webhook dans l’instance ServiceNow. Par exemple, le registre de webhooks 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 d’abonnement au webhook
      Testez le flux secondaire d’abonnement au webhook pour les types de changement requis.
    6. Cliquez sur Exécuter le test.
      L’abonnement pour le canal requis est créé.

      Voir 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 fourni avec le spoke en créant une copie de celui-ci.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Automatisation des processus > Studio de workflow.
    2. Cliquez sur Flux secondaires.
    3. Ouvrez le flux secondaire requis fourni avec le spoke Microsoft Teams Graph.
      Par exemple, Flux secondaire de traitement des notifications entrantes .
    4. Cliquez sur l’icône Actions supplémentaires (menu Actions supplémentaires), puis sélectionnez Copier le flux secondaire.
    5. Dans Nouveau nom de flux, saisissez un nom unique que vous souhaitez attribuer 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.
      Voir Création de flux secondaires pour plus d’informations sur la création et l’utilisation de flux secondaires.

    Configurer la politique de décision Webhook Microsoft Teams Graph

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

    Avant de commencer

    Rôle requis : admin

    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 de recherche.
      2. Sélectionnez le flux secondaire requis dans la liste Document :. Par exemple, Copie des notifications entrantes de processus.
      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 de Microsoft Teams.
    4. Cliquez sur Envoyer.
      Remarque :
      Ces politiques d’acheminement sont enregistrées dans les tables de décision. Les utilisateurs sont avertis de ne pas mettre à jour ou modifier directement les données de ces tables.