Kore.ai provides integration for a built-in Mercurial Bot that you can use to display message notifications and execute tasks directly from the Kore.ai application. To use the Mercurial 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 Mercurial, and the notification messages that you want. This topic describes the Mercurial built-in Bot for Kore.ai. For more information about other Kore.ai Bots, see Adding Bots.
About the Kore.ai Bot for Mercurial
Mercurial is a cross-platform, distributed revision control tool for software developers.
|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 Mercurial webhook for Kore.ai, you must have a Mercurial account with administrator access as well as API access to configure a webhook. If you don’t, you’ll need to contact the Mercurial system administrator for your company. For more information, see A Tutorial on Using Mercurial in the Mercurial documentation.
To get started configuring the webhook in Mercurial, you’ll need 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 Mercurial.
The webhook URL is account-specific and cannot be transferred to any other account. This means that if you configure a Mercurial webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in Mercurial. The following URL is an example webhook URL.
This procedure describes the steps in Mercurial to configure a webhook using a Kore.ai webhook URL endpoint.
To complete this procedure, you must download the kore-hook-script.py file, save it to yourMercurial repository, and then modify the file with the Kore.ai webhook URL. After you add the file, you must update the existing hgrc file in the same directory of your repository to define the events that trigger alerts.
- Download the kore-hook-script.py file using the link at the bottom of this page in theArticle Attachments section, and then save the file to the Mercurial repository in the root of the <MyRepo>/.hg/ directory for the repository that you want to add the webhook to.
- In a text editor of your choice, open the kore-hook-script.py file, and then set the property for the Kore.ai webhook URL by modifying the following line:
url = “https://app.kore.com/hooks/id”
with your Kore.ai webhook URL, and then Save the file.
- In the <MyRepo>/.hg/ directory, open the hgrc file in a text editor, and then add the following code that defines the triggers for alert notifications sent to your Kore.ai account.commit = python:.hg/kore-hook-script.py:commit
incoming = python:.hg/kore-hook-script.py:incoming
outgoing = python:.hg/kore-hook-script.py:outgoing
tag = python:.hg/kore-hook-script.py:tag
changegroup = python:.hg/kore-hook-script.py:changegroup
update = python:.hg/kore-hook-script.py:update
- Save the file and commit changes to the repository.
For more information, see Handling repository events with hooks in the Mercurial: The Definitive Guide.
You can setup message notifications to your Kore.ai account using a Mercurial webhook. Click , click Get notified when…, click Repository 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 Mercurial Webhooks.
- optionally customize the Task Name
- optionally customize the Short Description
- enable or disable Mute task notifications.
After the webhook is configured in Mercurial, when any of the defined events occur in Mercurial, a message is displayed on the Bots tab in the Messages section for the Kore.ai account.