Configurer un webhook bidirectionnel pour le Aha! spoke

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture
  • Configurez un webhook pour vous abonner aux événements du Aha! compte avec une ServiceNow URL de rappel.

    Avant de commencer

    Rôle requis : admin

    Créer un jeton

    Créez un jeton qui sera incorporé dans l’URL de rappel vers Aha!.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Dans le filtre de navigation, saisissez token_verification.list.
      Le système affiche les enregistrements dans la table Vérifications des jetons.
    2. Sélectionnez Nouveau.
    3. Renseignez les champs du formulaire.
      Tableau 1. Formulaire de vérification de jeton
      Champ Description
      Nom Option permettant de fournir un nom unique pour identifier le jeton. Par exemple, Aha ! Jeton d’URL de rappel.
      Description Option permettant de fournir une description du jeton.
      Jeton Option permettant de fournir un jeton d’authentification unique. Ce jeton est chiffré et incorporé à l’URL.
    4. Sélectionnez Soumettre.

    Créer un Aha! webhook dans ServiceNow

    Enregistrez un Aha! webhook pour avertir l’application lorsque certains événements se produisent dans Aha!.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Aha! Spoke > Webhook > Registres Webhook.
    2. Sélectionnez Nouveau.
    3. Remplissez le formulaire.
      Tableau 2. Aha! Registre Webhook
      Champ Description
      Nom Option permettant d’identifier l’enregistrement de façon unique.
      Chemin d'accès Option permettant de fournir le chemin d’accès du webhook. Entrez api/sn_aha_spoke/aha_webhook.
      Jeton Option permettant de spécifier le jeton que vous avez créé. Consultez Créer un jeton.
    4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    5. Sélectionnez URL de rappel.
      Le système affiche l’URL de rappel webhook.
    6. Copiez et enregistrez l’URL de rappel webhook.

    Ajouter une URL de rappel à Aha!

    Enregistrez l’URL de rappel webhook dans le Aha! compte.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Connectez-vous à votre Aha! compte en tant qu’administrateur.
    2. Accédez à la Paramètres > Compte.
    3. Créez un webhook d’activité en cliquant sur + à côté de Intégrations.
    4. Cliquez sur + Webhook d’activité dans la vignette Webhook d’activité .
    5. Renseignez ces valeurs sur le formulaire.
      Champ Description
      Hook URL URL de rappel Webhook que vous avez copiée à partir de l’instance ServiceNow .
      Activités sélectionnées Activités ou événements auxquels vous souhaitez vous abonner.
    6. Cliquez sur Ajouter une activité.

    Définir la politique d’acheminement du webhook

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

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    La politique d’acheminement par défaut du module de politique de décision Webhook Aha déclenche le flux secondaire Traiter les webhooks Aha et avertit l’application ServiceNow lorsque certains événements se produisent dans Aha!. Consultez la rubrique Aha! Rayon pour plus d’informations sur les champs pris en charge par la politique d’acheminement par défaut et les flux secondaires. Pour utiliser d’autres champs dans votre flux secondaire personnalisé et personnaliser les conditions dans la politique d’acheminement, procédez comme suit.

    Procédure

    1. Accédez à la Tous > Aha! Spoke > Webhook > Politiques d’acheminement des Webhooks.
    2. Sélectionnez Nouveau.
    3. Remplissez le formulaire.
      Tableau 3. Formulaire Décision
      Champ Description
      Étiquette Étiquette unique pour identifier la politique d’acheminement.
      Réponse par défaut Option permettant de spécifier s’il s’agit de 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 les événements requis se produisent dans Aha!.
      Réponse Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies
      1. Cliquez sur l'icône de recherche ( icône de recherche).
      2. Sélectionnez le flux secondaire requis dans la liste Documents .
        Remarque :
        Assurez-vous que le nom de la table est Flux [sys_hub_flow].
    4. Sélectionnez Soumettre.