Set up a bi-directional webhook for the Aha! spoke

Configure a webhook to subscribe to events in the Aha! account with a ServiceNow callback URL.

시작하기 전에

Role required: admin

Create a Token

Create a token that will be embedded in the callback URL to Aha!.

시작하기 전에

Role required: admin

프로시저

1. In the navigation filter, enter token_verification.list.
   The system displays records in the Token Verifications table.
2. Select New.
3. On the form, fill the fields.

   표 1. Token Verification form

   Field	Description
   Name	Option to provide a unique name to identify the token. For example, Aha! Callback URL token.
   Description	Option to provide a description of the token.
   Token	Option to provide a unique authentication token. This token is encrypted and embedded in the URL.

4. Select Submit.

Create an Aha! Webhook in ServiceNow

Register an Aha! webhook in to notify the app when certain events occur in Aha!.

시작하기 전에

Role required: admin

프로시저

1. Navigate to All > Aha! Spoke > Webhook > Webhook Registries.
2. Select New.
3. Fill the form.

   표 2. Aha! Webhook Registry

   Field	Description
   Name	Option to uniquely identify the record.
   Path	Option to provide the webhook path. Enter api/sn_aha_spoke/aha_webhook.
   Token	Option to specify the token you had created. See Create a Token.

4. Right-click the form header and click Save.
5. Select Callback URL.
   The system displays the webhook callback URL.
6. Copy and record the webhook callback URL.

Add callback URL to Aha!

Register the webhook callback URL to the Aha! account.

시작하기 전에

Role required: admin

프로시저

1. Log in to your Aha! account as an admin.
2. Navigate to Settings > Account.
3. Create an activity webhook by clicking + beside Integrations.
4. Click + Activity webhook in the Activity webhook tile.
5. On the form, fill these values.

   Field	Description
   Hook URL	Webhook callback URL you had copied from the ServiceNow instance.
   Selected Activities	Activities or events for which you want to subscribe.

6. Click Add activity.

Set webhook routing policy

Create a webhook routing policy and subflow as per your requirement.

시작하기 전에

Role required: admin

이 태스크 정보

The default routing policy in the Aha Webhook Decision Policy module triggers the Process Aha webhooks subflow and notifies the ServiceNow app when certain events occur in Aha!. See Aha! Spoke for information about the fields that the default routing policy and subflows support. To use any other fields in your custom subflow and customize conditions in the routing policy, perform these steps.

프로시저

1. Navigate to All > Aha! Spoke > Webhook > Webhook Routing Policies.
2. Select New.
3. Fill the form.

   표 3. Decision form

   Field	Description
   Label	Unique label to identify the routing policy.
   Default answer	Option to specify if this is the default answer. The default answer is applicable when the conditions are not met.
   Condition	Conditions to be met when the required events occur in Aha!.
   Answer	Subflow that must be triggered when the specified conditions are met. Click the lookup icon (). Select the required subflow from the Document list. 주: Ensure that the Table name is Flow [sys_hub_flow].

4. Select Submit.