Configurer un webhook bidirectionnel pour le Aha! spoke

Configurez un webhook pour vous abonner aux événements du Aha! compte avec une URL de ServiceNow rappel.

Avant de commencer

Rôle requis : admin

Procédure

1. Générez l’URL de rappel webhook à partir de votre ServiceNow instance.
   1. Connectez-vous à votre ServiceNow instance en tant qu’administrateur.
   2. Accédez à Aha! Spoke > Webhook > Registres Webhook.
   3. Ouvrez l’enregistrement Webhook Aha.
   4. Cliquez sur URL de rappel.
      L’URL de rappel webhook est générée et affichée.

      

   5. Copiez et enregistrez l’URL de rappel webhook.
2. Spécifiez les politiques d’acheminement des webhooks dans votre ServiceNow instance.
   1. Connectez-vous à votre ServiceNow instance en tant qu’administrateur.
   2. Accédez à Aha! Spoke > Webhook > Politiques d’acheminement de Webhook.
   3. Ouvrez l’enregistrement de la politique d’acheminement des Aha! webhooks.
   4. Spécifiez la condition qui doit être remplie.
   5. Pour Réponse, sélectionnez le flux secondaire requis qui doit être déclenché lorsque la condition spécifiée est remplie.
      Dans l’enregistrement de politique d’acheminement par défaut, le flux secondaire des webhooks Traiter Aha est sélectionné en tant que Réponse.
   6. Cliquez sur Mettre à jour.
3. Enregistrez l’URL de rappel webhook dans Aha! le compte.
   1. Connectez-vous à votre Aha! compte en tant qu’administrateur.
   2. Accédez à 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é.

Créer un jeton

Créez un jeton qui sera incorporé dans l’URL de rappel de 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 intégré à l’URL.

4. Sélectionnez Envoyer.

Créer un Aha! webhook dans ServiceNow

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

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à 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 au webhook. Entrez api/sn_aha_spoke/aha_webhook.
   Jeton	Option permettant de spécifier le jeton que vous avez créé. Voir Créer un jeton.

4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
5. Sélectionnez l’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 à 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 une politique d’acheminement de 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 dans le module 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 section Aha! Un spoke pour plus d’informations sur les champs pris en charge par la politique d’acheminement et les flux secondaires par défaut. Pour utiliser d’autres champs dans votre flux secondaire personnalisé et personnaliser les conditions de la politique d’acheminement, effectuez les étapes suivantes.

Procédure

1. Accédez à 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. Cliquez sur l'icône de recherche ( ). Sélectionnez le flux secondaire requis dans la liste Document . Remarque : Assurez-vous que le nom de la table est Flux [sys_hub_flow].

4. Sélectionnez Envoyer.