{"id":17747,"date":"2016-06-13T09:54:51","date_gmt":"2016-06-13T09:54:51","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&amp;p=2624"},"modified":"2016-06-13T09:54:51","modified_gmt":"2016-06-13T09:54:51","slug":"integrating-with-pagerduty","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/bot-store\/adding-bots\/integrating-with-pagerduty\/","title":{"rendered":"Adding a PagerDuty Bot"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p>Kore.ai provides integration for a built-in <em>PagerDuty<\/em>\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly\u00a0from the\u00a0Kore.ai application. To use the <em>PagerDuty<\/em>\u00a0Bot, 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 <em>PagerDuty<\/em>, and the\u00a0notification messages that you want. This topic describes the <em>PagerDuty<\/em>\u00a0built-in Bot\u00a0for Kore.ai.\u00a0For more information about other Kore.ai Bots, see <a style=\"line-height: 1.42857;background-color: #ffffff\" href=\"\/docs\/bots\/about-kore-bots\/addingbots\/\">\u00a0Adding Bots<\/a>.<\/p>\n<h1><span class=\"ez-toc-section\" id=\"About_the_Koreai_Bot_for_PagerDuty\"><span class=\"wysiwyg-font-size-x-large\">About the Kore.ai Bot for\u00a0PagerDuty<\/span><\/span><\/h1>\n<p><img decoding=\"async\" class=\"logo2 alignleft\" src=\"\/wp-content\/uploads\/sites\/35\/DIYPagerDutyLogo.png\" alt=\"DIYPagerDutyLogo\" \/><em>PagerDuty<\/em>\u00a0is\u00a0an alarm aggregation and dispatching service for system administrators and support teams. It collects alerts from your monitoring tools, gives you an overall view of all of your monitoring alarms, and generates alerts if there\u2019s a problem.<\/p>\n<table border=\"0\" width=\"645\">\n<tbody>\n<tr>\n<td><strong>Integration Type<\/strong><\/td>\n<td><strong>Webhook<\/strong> &#8211; Connect to this Bot using a webhook integration where the web application pushes\u00a0message notifications in near real time.<\/td>\n<\/tr>\n<tr>\n<td><strong>Category<\/strong><\/td>\n<td><strong>Project Management<\/strong>\u00a0&#8211; This Bot is available in the Kore.ai application in the\u00a0<strong>Project Management\u00a0<\/strong>category.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h1><span class=\"ez-toc-section\" id=\"Configuring_PagerDuty\"><a id=\"webhook\"><\/a><span class=\"wysiwyg-font-size-x-large\">Configuring PagerDuty<\/span><\/span><\/h1>\n<p>To configure a <em>PagerDuty<\/em> webhook for Kore.ai, you must have a <em>PagerDuty<\/em>\u00a0account with administrator access as well as API access to configure a webhook. If you don&#8217;t, you&#8217;ll need to contact the <em>PagerDuty<\/em>\u00a0system administrator for\u00a0your company. For more information, see the\u00a0<a href=\"https:\/\/support.pagerduty.com\/hc\/en-us\/articles\/202830040-Understanding-PagerDuty-user-roles\" target=\"_blank\" rel=\"noopener noreferrer\">Understanding PagerDuty User Roles<\/a>\u00a0in the <em>PagerDuty<\/em> documentation.<br \/>\nTo get started configuring the webhook in <em>PagerDuty<\/em>, you&#8217;ll need two\u00a0things:<\/p>\n<ol>\n<li>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\u00a0<em>PagerDuty<\/em>.<\/li>\n<li>A valid Username and Password for an account with <em>PagerDuty<\/em>\u00a0API access.<\/li>\n<\/ol>\n<p>The webhook URL is account-specific and cannot be transferred to any other account. This means that if you configure a <em>PagerDuty<\/em>\u00a0webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in <em>PagerDuty<\/em>. The following URL is an example webhook URL.<br \/>\n<span style=\"color: #0000ff\">https:\/\/company.kore.com\/hooks\/c6089802f36250c179dcb1aa29afd24c<\/span><\/p>\n<h2><span class=\"ez-toc-section\" id=\"Configuring_Webhook\"><span class=\"wysiwyg-font-size-large\">Configuring Webhook<\/span><\/span><\/h2>\n<p>This procedure describes the steps in <em>PagerDuty<\/em>\u00a0to configure a webhook using a Kore.ai webhook URL endpoint.<br \/>\nFirst you will create a service, and then for that service, you can add a webhook.<\/p>\n<ol>\n<li>Log on to <em>PagerDuty<\/em>, point to\u00a0<strong>Configuration<\/strong> on the top menu\u00a0bar, and then click\u00a0<strong>Services<\/strong>. The <strong>Services<\/strong> page is displayed.<\/li>\n<li>On the <strong>Services<\/strong> tab, click <strong>Add a New Service<\/strong>. The <strong>Add a Service<\/strong> page is displayed.<\/li>\n<li>In the <strong>Name<\/strong> field, enter a name for the service\u00a0to use in the <em>PagerDuty<\/em> application.<\/li>\n<li>Leave <strong>Escalation Policy<\/strong> and <strong>Notification Urgency<\/strong> set to default settings.<\/li>\n<li>In the <strong>Integration type<\/strong> field, select <strong>Use our API directly<\/strong>, and then click <strong>Add Service<\/strong>. The new\u00a0<strong>Service<\/strong> page is displayed.<\/li>\n<li>In the <strong>Webhooks<\/strong> section for the service you created, click <strong>Add a webhook<\/strong>.<\/li>\n<li>In the <strong>Name<\/strong> field, enter a name for the webhook\u00a0to use in the <em>PagerDuty<\/em> application.<\/li>\n<li>In the\u00a0<strong>Endpoint URL<\/strong> field, enter the\u00a0Kore.ai webhook URL for the alert, and then click <strong>Save\u00a0<\/strong>to save and close the <strong>Webhooks<\/strong> dialog.<\/li>\n<\/ol>\n<p>For more information, see <a href=\"https:\/\/support.pagerduty.com\/hc\/en-us\/articles\/202830320-Webhooks-\" target=\"_blank\" rel=\"noopener noreferrer\">Webhooks<\/a> in the <em>PagerDuty<\/em>\u00a0documentation.<br \/>\nAfter you are connected, you can perform tasks for\u00a0<em>PagerDuty<\/em>\u00a0directly from the Kore.ai application and setup message notifications to get notified in the Kore.ai application when an event occurs in\u00a0<em>PagerDuty<\/em>.<br \/>\nThe following table describes\u00a0<em>PagerDuty<\/em>\u00a0tasks that you can integrate with Kore.ai.<\/p>\n<table border=\"0\" width=\"90%\">\n<tbody>\n<tr>\n<th><strong>TASK<\/strong><\/th>\n<th>TO CONFIGURE THIS TASK&#8230;<\/th>\n<\/tr>\n<tr>\n<td><strong>Resolve Incident<\/strong><\/td>\n<td>In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select an <strong>Incident<\/strong><\/li>\n<li>and then, select a <strong>Requester<\/strong>.<\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pagerduty resolveincid<\/span>\u00a0\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<tr>\n<td><strong>Reassign Incident<\/strong><\/td>\n<td>In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select an <strong>Incident<\/strong><\/li>\n<li>select a <strong>Requester<\/strong><\/li>\n<li>and then, select an <strong>Assignee<\/strong><\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pagerduty reassignincid<\/span>\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<tr>\n<td><strong>Acknowledge Incident<\/strong><\/td>\n<td>In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select an <strong>Incident<\/strong><\/li>\n<li>and then, select a <strong>Requester<\/strong>.<\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pagerduty ackincid<\/span>\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>You can setup message notifications to your Kore.ai account using a <em>PagerDuty<\/em>\u00a0webhook. Click\u00a0<img loading=\"lazy\" decoding=\"async\" class=\"inline alignnone\" src=\"\/wp-content\/uploads\/sites\/35\/newtask.png\" alt=\"\" width=\"30\" height=\"34\" \/>, click <strong>Get notified when&#8230;<\/strong>, click <strong>Incident Updates<\/strong>, and then\u00a0in\u00a0the <strong>Setup Task\u00a0<\/strong>dialog:<\/p>\n<ul>\n<li>click the <strong>Activate<\/strong> button to generate a Webhook URL.<\/li>\n<li>copy and save the URL, or click <strong>Email Instructions<\/strong> to send the URL to an email account. For more information, see <a href=\"\/docs\/bots\/about-kore-bots\/addingbots\/integrating-with-pagerduty\/#webhook\">Configuring PagerDuty\u00a0Webhooks<\/a>.<\/li>\n<li>optionally customize the <strong>Task Name\u00a0<\/strong><\/li>\n<li>optionally customize the <strong>Short Description<\/strong><\/li>\n<li>enable or disable <strong>Mute task notifications<\/strong>.<\/li>\n<\/ul>\n<h1><span class=\"ez-toc-section\" id=\"Next_Steps\"><em><span class=\"wysiwyg-font-size-x-large\">Next Steps<\/span><\/em><\/span><\/h1>\n<p>After the webhook is configured in <em>PagerDuty<\/em>, when any of the events occur in <em>PagerDuty<\/em>, a message is displayed on the <strong>Bots<\/strong> tab in the <strong>Messages<\/strong> section for the Kore.ai account.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"Kore.ai provides integration for a built-in PagerDuty\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly\u00a0from the\u00a0Kore.ai application. To use the PagerDuty\u00a0Bot, 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 PagerDuty, and the\u00a0notification messages that you want. This...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[176],"tags":[],"class_list":["post-17747","post","type-post","status-publish","format-standard","hentry","category-adding-bots"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17747","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/comments?post=17747"}],"version-history":[{"count":0,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17747\/revisions"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=17747"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=17747"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=17747"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}