---
title: "Configure a bot"
url: https://docs.catalyst.zoho.com/en/tutorials/githubbot/python/configure-bot/
description: "Build an extension on Zoho Cliq using Catalyst Integration Functions, that enables you to access and work with your GitHub repositories using a Cliq bot"
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: tutorial
related_links:
  - name: "Integration Functions"
    url: /en/serverless/help/functions/integration-functions
---

# Configure the Bot as an Incoming Webhook Notifier

Next, let's configure the bot as an incoming webhook notifier, that performs actions when the webhook URL is invoked on GitHub. You can do this in the following way:

1. Generate a webhook token on the Cliq bot
2. Obtain the App key of your extension
3. Obtain the webhook handler URL of your extension
4. Create a webhook on GitHub and configure these values

We will discuss these actions in detail one after the other.

This webhook gets triggered whenever a commit is pushed to one of the repositories on your Git account. When that event occurs, GitHub makes an HTTP request to the URL webhook handler URL with the credentials that we configure. It will pass the details of that push event to Cliq, and the Cliq bot will notify you of it and display the details.

### Generate a WebHook Token

You can generate a webhook token on Cliq as described below. The webhook token is authenticated by the authenticate button function that we configured in the previous step.

1. Search for the GitHub bot in your Cliq account. Select the bot and click **Continue**.

![search_bot](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/search_bot.webp)

2. Provide permission for the bot to access your account details.

![allow_access](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/allow_access.webp)
 
    The chat will be activated.

3. Type **"webhooktoken"** in the chat and press **Enter**. Then click **Create Webhook**.

![create_webhook](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/create_webhook.webp)

4. Click **Create Webhook**.  In the pop up that appears, we will need to enter the webhook token of the bot.

![webhook_popup](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/webhook_popup.webp)

To fetch the webhook token, click on the **Profile** icon in the top right corner of the page.

![click_profile](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/click_profile.webp)

Click **Bots & Tools**.

![bots_and_tools](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/bots_and_tools.webp)

Click on **Webhook Tokens** in the Integrations menu.

![webhook_tokens](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/webhook_tokens.webp)

Click **Generate New Token** and copy the generated token.

![copy_token](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/copy_token.webp)

Paste the token value in the pop-up and click **Submit**.

![paste_token](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/paste_token.webp)

### Obtain the App Key

You can obtain the App Key of the extension in the following way:

1. Click on the **GitHubExt** extension from the extensions page in the [Cliq developer console](https://cliq.zoho.com/developer), then navigate to the **Connectors** section.

2. Copy the Sandbox App Key of your extension.

![sandbox_key](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/sandbox_key.webp)

This key will be the value of the `appkey` parameter in the URL that we will configure on GitHub.

### Obtain the Webhook Handler URL

You can obtain the Webhook Handler URL of the extension in the following way:

1. Navigate back to your Cliq account and click on your profile picture. Click on **Bots & Tools** in the menu section.

  ![select_bots_tools](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/select_bots_tools.webp)

2. Click on the **GitHub Bot** from your bots list. This will open a side panel. Copy the URL displayed under _Incoming WebHook Endpoint_.

![incoming_webhook_endpoint](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/incoming_webhook_endpoint.webp)

This will be the baseURL that we will configure on GitHub.

### Create a Webhook on GitHub

The complete URL to configure on GitHub is:

**_baseURL_?`appkey`\={{_appkey_}}&`zapikey`\={{_zapikey_}}**

where _baseURL_ is the webhook handler URL, `appkey` is the sandbox App Key of your extension, and `zapikey` is the webhook token generated on Cliq.

For example:

**https:<span></span>//cliq.zoho.com/company/org_id/api/v2/githubbot/incoming?appkey={{_appkey_}}&zapikey={{_zapikey_}}**

Let's now add this URL on GitHub in the following way:

1. Open your [GitHub](https://github.com/) account and navigate to any one of your repositories.

2. Open your **repository's settings**, then click **Webhooks -> Add webhook**. 

![add_webhook](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/add_webhook.webp)

3. Enter the URL in the format specified above, substituting the values of `appkey` and `zapikey`. Configure the webhook as shown below.

![configure_url](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/configure_url.webp)

You can select the events that you would like to be notified about.

4. Click **Add webhook**.

![configure_events](https://catalyst-docs-development.zohostratus.in/images/tutorials/githubbot/python/configure_events.webp)

This webhook will now enable alerts for the configured events in your repository.