Kore.ai provides integration for a built-in Gitblit Bot that you can use to display message notifications and execute tasks directly from the Kore.ai application. To use the Gitblit Bot, you just need to add the Bot to your Kore.ai account, and then configure the settings for the Bot, such as authentication to access Gitblit, and the notification messages that you want. This topic describes the Gitblit built-in Bot for Kore.ai. For more information about other Kore.ai Bots, see Adding Bots.
About the Kore.ai Bot for Gitblit
Gitblit is an open-source, pure Java stack for managing, viewing, and serving Git repositories. It’s designed primarily as a tool for small workgroups who want to host centralized repositories.
|Integration Type||Webhook – Connect to this Bot using a webhook integration where the web application pushes message notifications in near real time.|
|Category||Developer Tools – This Bot is available in the Kore.ai application in the Developer Tools category.|
To configure a Gitblit webhook for Kore.ai, you must have a Gitblit account with administrator access as well as API access to configure a webhook. If you don’t, you’ll need to contact the Gitblit system administrator for your company.
To get started configuring the webhook in Gitblit, you’ll need two things:
- The Kore.ai webhook URL provided when you set up an alert in your Kore.ai account for each alert that you want to enable in Gitblit.
- A valid Username and Password for an account with Gitblit API access.
The webhook URL is account-specific and cannot be transferred to any other account. This means that if you configure a Gitblit webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in Gitblit. The following URL is an example webhook URL.
This procedure describes the steps in Gitblit to configure a webhook using a Kore.ai webhook URL endpoint. To configure a Kore.ai webhook for Gitblit, you must download and modify a file called kore.groovy, and then place that file into your Gitblit installation directory as described in the following procedure.
- Download the kore.groovy file using the link at the bottom of this page in the Article Attachments section, and save to your Gitblit installation directory, for example, the <MyGitblitHome>/data/groovy directory.
- In a text editor of your choice, open the kore.groovy file, and then set the property for the Kore.ai webhook URL to:
def koreUrl = “https://app.kore.com/hooks/id”
and then save.
- In the <MyGitblitHome>/data/ directory, open the gitblit.properties file in the text editor and modify the following settings as:
groovy.preReceiveScripts = kore.groovy
groovy.postReceiveScripts = kore.groovy
- Save and publish the files.
For more information, see Webhooks in the Gitblit documentation.
Note: By default, all events for this Bot generate Kore.ai alert messages. To reduce the number of notifications, this Bot may have filters that can be defined when you set up the alert in your Kore.ai account.
You can setup message notifications to your Kore.ai account using a Gitblit webhook. Click , click Get notified when…, click Commit Updates, and then in the Setup Task dialog:
- click the Activate button to generate a Webhook URL.
- copy and save the URL, or click Email Instructions to send the URL to an email account. For more information, see Configuring Gitblit Webhooks.
- optionally customize the Task Name
- optionally customize the Short Description
- enable or disable Mute task notifications.
After the webhook is configured in Gitblit, when any of the events occur in Gitblit, a message is displayed on the Bots tab in the Messages section for the Kore.ai account.