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.

Before you begin

Role required: admin

Create a Token

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

Before you begin

Role required: admin

Procedure

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.

   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!.

Before you begin

Role required: admin

Procedure

1. Navigate to All > Aha! Spoke > Webhook > Webhook Registries.

2. Select New.

3. Fill the form.

   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.

Before you begin

Role required: admin

Procedure

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.

Before you begin

Role required: admin

About this task

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.

Procedure

1. Navigate to All > Aha! Spoke > Webhook > Webhook Routing Policies.

2. Select New.

3. Fill the form.

1. Select Submit.