Set up bi-directional webhook for the GitHub spoke
Configure webhook to subscribe to GitHub with a ServiceNow callback URL.
[Omitted video] Description: Demonstrates setting up bi-directional webhook for the GitHub spoke.
Before you begin
- Request Integration Hub subscription
- Activate the GitHub spoke
- Role required: admin
Register GitHub webhook in ServiceNow
Register a GitHub in ServiceNow to notify the ServiceNow app when certain events occur in GitHub.
Before you begin
Role required: admin
Procedure
Navigate to All > GitHub Webhooks > GitHub Webhook Registries.
Click New.
On the form, fill in the fields.
Field Description Name Unique name to identify the record. For example, GitHub webhook.Description Description of the record. Right-click the form header and click Save.
Click Callback URL.
The system displays the Webhook Callback URL and Webhook Secret.
Values of the generated Webhook Callback URL and Webhook Secret.
- Copy and record the values of Webhook Callback URL and Webhook Secret.
Result
The GitHub webhook is registered in your ServiceNow instance.
Add Callback URL in GitHub
Provide Webhook Callback URL in GitHub account to create webhook.
Before you begin
Role required: admin
Procedure
Log in to your GitHub account.
Navigate to the required repository.
Select Settings.
On the left panel, select, Webhooks.
Select Add Webhook.
Enter Webhook Callback URL in Payload URL and Secret in Secret.
See the GitHub Developer documentation for instructions on creating and configuring a webhook.
Note: GitHub spoke supports application/json payload. Configure the GitHub webhook accordingly. See the GitHub Developer documentation for instructions on creating and configuring a webhook.
Result
The Callback URL is added in the GitHub account. You can create routing policies and subflows as per your requirement. See Customize a bi-directional webhook for information regarding creating new routing policies and subflows.
Customize bi-directional webhook in the GitHub spoke
Create webhook routing policy and subflow as per your requirement in the GitHub spoke.
Before you begin
Role required: admin
About this task
The default routing policy in the GitHub WebHook Routing Policies modules triggers the relevant GitHub subflow and notifies the ServiceNow app when certain events occur in GitHub. See GitHub Spoke for information about the GitHub fields that the default routing policy supports and the GitHub events that the subflows support. To use any other fields in your custom subflow and customize conditions in the routing policy, perform these steps.
Procedure
Navigate to All > Process Automation > Workflow Studio.
Click Subflows.
Create a copy of the required subflow.
Customize the required subflow as per your requirement and publish it.
See Building subflows for more information about creating and using subflows and GitHub Spoke for information about the GitHub fields that the default routing policy supports and the GitHub events that the subflows support.
Navigate to GitHub Webhooks > GitHub WebHook Routing Policies.
Click New.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Label | Unique label to identify the routing policy. |
| Default answer | Option to specify if this is the default answer. Default answer is applicable when the conditions are not met. |
| Condition | Conditions to be met when the required events occur in GitHub. See GitHub Spoke for information about the supported fields. |
| Answer | Subflow that has to be triggered when the specified conditions are met.1. Click the Lookup icon. 2. Select the required subflow from the Document: list. Note: Ensure that the Table name is |
Click Submit.
Note: These routing policies are saved in the Decision tables. Users are cautioned against directly updating or modifying data in these tables.
Result
Routing policy and subflow are created.