Kore.ai provides integration for a built-in Wercker Bot that you can use to display message notifications and execute tasks directly from Kore.ai Messenger, or other supported channels. To use the Wercker Bot, you just need to add the Bot to Kore.ai Messenger, and then configure the settings for the Bot, such as authentication to access Wercker, and the notification messages that you want. This topic describes the Wercker built-in Bot for Kore.ai. For more information about other Kore.ai Bots, see Adding Bots.
About the Kore.ai Bot for Wercker
Wercker is an open automation platform for developing, building, and delivering your applications. This bot enables you to both run tests and run build processes for static applications.
|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.|
|Channels||Kore.ai – This Bot is available in the Kore.ai Messenger application.
Spark – This Bot is available in the Cisco Spark application.
To configure a Wercker webhook for Kore.ai, you must have a Wercker account with administrator access as well as API access to configure a webhook. If you don’t, you’ll need to contact the Wercker system administrator for your company. For more information, see the Documentation Overview in the Wercker documentation.
To get started configuring the webhook in Wercker, 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 Wercker.
- A valid Username and Password for an account with Wercker API access.
The webhook URL is account-specific and cannot be transferred to any other account. This means that if you configure a Wercker webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in Wercker. The following URL is an example webhook URL.
This procedure describes the steps in Wercker to configure a webhook using a Kore.ai webhook URL endpoint. In Wercker, you will create a custom wercker.yml file that must be saved in your repository. If you already have a wercker.yml file in your repository, skip to step 7.
- Log on to Wercker, and then on the top menu bar, click Create.
- In the Choose a Git Provider section, select your repository type.
- In the Select a repository section, select the repository that you want to create a wercker.yml file for, and then click Use selected repo.
- In the Select owner section, select your repository account, and then click Use selected owner.
- In the Configure access section, select wercker will checkout the code without using an SSH key, and then click Next step.
- In the Setup your wercker.yml file section, copy the code and pasted into a text editor of your choice, and then save the wercker.yml file to the root of your repository where you want to add a webhook to.
- In the text editor for the wercker.yml file, add the following code:
where the url parameter is set to the Kore.ai webhook URL for the alert.
- Save the file, and then commit your changes.
For more information, see Deploy in the Wercker documentation.
The following is an example of a wercker.yml file configured for a sample Kore.ai webhook.
After you are connected, you can perform tasks for Wercker directly from the Kore.ai application and setup message notifications to get notified in the Kore.ai application when an event occurs in Wercker.
You can integrate a Wercker action task with Kore.ai. To configure the Trigger Build task, click , click Trigger a Build, and then in the Perform Task dialog:
- enter a Username
- select an Application
- optionally enter a Branch
- optionally enter a Commit Hash
- and then, optionally enter a Message.
In a team room, you can enter the @wercker triggerbuild Bot command to invoke and configure this task.
You can setup message notifications to your Kore.ai account using a Wercker webhook. Click , click Get notified when…, click Build 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 Wercker Webhooks.
- optionally customize the Task Name
- optionally customize the Short Description
- enable or disable Mute task notifications.
After the webhook is configured in Wercker, when any of the events occur in Wercker, a message is displayed on the Bots page in Kore.ai Messenger.