Skip to content

Webhook Overview

A webhook is a mechanism that allows one application to send real-time data to another whenever a specific event occurs. It’s essentially a lightweight API event-driven communication. Webhooks are widely used to notify systems of updates, trigger workflows, or integrate services without requiring the recipient to constantly poll the server. A Webhook ID is a unique identifier assigned to a webhook, typically by the service or application managing the webhook

Two Methods to Create a Webhook

Method 1: By using the Webhook in the AIV application.

  1. Click on the humburger Icon menu and navigate to the Master Data section, then select Webhook.

    webhook image

  2. This action will take you to the Webhook page. Click the Create Webhook button to initiate the creation of a new webhook.

    webhook image

  3. Once you click on the Create Webhook button, a dialog box will appear as shown below:

    webhook image

  4. Enter the following details in the Create Webhook dialog box:

  • Name: Provide any name you wish to assign.

  • POST: Enter the desired URL.

  • Headers: Add the necessary key and value pairs.

    webhook image

  • Body:

    • Select either the None or Raw radio button.

    • If you select Raw, choose the appropriate type from the dropdown list.

      webhook image

  1. Click the Save button, then navigate to the Document section and click on the Report tab.

    webhook image

  2. As depicted below, when you double-click on any report from the Reports page, the Schedule dialog box appears. Navigate to the Output tab, tick the checkbox for Webhook, and select any webhook from the dropdown list.

    webhook image

  3. Click the Run button to view the output, as shown below:

    webhook image

  4. When you click on Run, you can inspect the output and retrieve the webhook ID, as shown below:

    webhook image

Method 2: By using the Postman

  1. Click on the humburger Icon menu and navigate to the API Key section. An API Tokens page will appear, as shown below:

    webhook image

  2. In the API Tokens section, enter Name and Days fields, then click on the Create API Token button.

  1. Once you click on the Create API Token button, the details will be added to the table.

  2. Enter the following details in the Postman:

  • Name: Provide any name you wish to assign.

  • POST: Enter the desired URL.

  • Headers: Add the necessary key and value pairs.

    webhook image

  • When you click on Body, you can inspect the output and retrieve the webhook ID, as shown below:

    webhook image

  • Body:

    • Select either the None or Raw radio button.

    • If you select Raw, choose the appropriate type from the dropdown list.

      webhook image

  1. Click on the Send button to receive the output, as shown below:

    webhook image

  2. After clicking the Send button, the output will appear, as shown below:

    webhook image

Third party integration apps using webhook

Slack

  1. Log in to Slack and create an account if you don’t have one.

  2. Create a workspace by selecting Create a new workspace and providing necessary details.

  3. Go to Slack API, click Your Apps, and create a new app in your workspace.

  4. Open your terminal and type ng http to start the Angular app (if needed).

  5. In your app settings, go to Slash Commands and click Create New Command.

  6. Define the command, ensuring it starts with a / (e.g.,/mycommand).

  7. In OAuth & Permissions, add the required scopes like chat

    and commands.

  8. Add channel details and ID for the slash command to be used in specific channels.

  9. Install other apps by clicking on Apps in the sidebar and browsing the directory.