Kore.ai provides integration for a built-in Airbrake Bot that you can use to display message notifications and execute tasks directly from the Kore.ai application. To use the Airbrake 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 Airbrake, and the notification messages that you want. This topic describes the Airbrake built-in Bot for Kore.ai. For more information about other Kore.ai Bots, see Adding Bots.

About the Kore.ai Bot for Airbrake

DIYAirbrakeLogoAirbrake is an application error reporting service that allows developers to build better software by providing detailed error reports in their applications. Airbrake provides insight to your applications in a production environment. Error reports describe what error happened, the portion of the code that caused the error, and allows the you to easily recreate the error for troubleshooting and fixing.

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.

 

Configuring Airbrake 

To configure an Airbrake webhook for Kore.ai, you must have an Airbrake account with administrator access as well as API access to configure a webhook. If you don’t, you’ll need to contact the Airbrake system administrator for your company. For more information, see Webhooks in the Airbrake documentation.
To get started configuring the webhook in Airbrake, you’ll need two things:

  1. 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 Airbrake.
  2. A valid Username and Password for an account with Airbrake API access.

The webhook URL is account-specific and cannot be transferred to any other account. This means that if you configure an Airbrake webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in Airbrake. The following URL is an example webhook URL.
https://app.kore.com/hooks/c6089802f36250c179dcb1aa29afd24c

Configuring Webhook

This procedure describes the steps in Airbrake to configure a webhook using a Kore.ai webhook URL endpoint.

  1. Log on to Airbrake, and then on the top menu bar, click Create new project. or select an existing project to add a webhook to.
  2. Click the Settings DIYSettingsIcon icon. The Edit Project page is displayed.
  3. On the left navigation menu, in the General Settings section, click Integrations, and then click Webhook. The Webhook Integration page is displayed.
  4. In the URL field, enter the Kore.ai webhook URL for the alert.
  5. Select Active to enable the webhook after save.
  6. Click Save to save the webhook configuration and close the dialog.

For more information, see Webhooks in the Airbrake documentation.
You can setup message notifications to your Kore.ai account using a Airbrake  webhook. Click , click Get notified when…, click Error notifications via Webhook, 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 Airbrake Webhooks.
  • optionally customize the Task Name 
  • optionally customize the Short Description
  • enable or disable Mute task notifications.

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.

Next Steps

After the webhook is configured in Airbrake, when any of the events occur in Airbrake,a message is displayed on the Bots tab in the Messages section for the Kore.ai account.