{"id":17749,"date":"2016-06-13T10:15:56","date_gmt":"2016-06-13T10:15:56","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&amp;p=2630"},"modified":"2016-06-13T10:15:56","modified_gmt":"2016-06-13T10:15:56","slug":"integrating-with-pivotal-tracker","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/bot-store\/adding-bots\/integrating-with-pivotal-tracker\/","title":{"rendered":"Adding a Pivotal Tracker 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>Pivotal Tracker<\/em>\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly\u00a0from the\u00a0Kore.ai application. To use the <em>Pivotal Tracker<\/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>Pivotal Tracker<\/em>, and the\u00a0notification messages that you want. This topic describes the <em>Pivotal Tracker<\/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\/\">Adding Bots<\/a>.<\/p>\n<h1><span class=\"ez-toc-section\" id=\"About_the_Koreai_Bot_for_Pivotal_Tracker\"><span class=\"wysiwyg-font-size-x-large\">About the Kore.ai Bot for\u00a0Pivotal Tracker<\/span><\/span><\/h1>\n<p><img decoding=\"async\" class=\"logo2 alignleft\" src=\"\/wp-content\/uploads\/sites\/35\/DIYPivotalTrackerLogo-2-300x170.png\" alt=\"DIYPivotalTrackerLogo\" \/><em>Pivotal Tracker<\/em> is an agile project management tool that shows software teams their work in progress and allows them to track upcoming milestones.<\/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_Pivotal_Tracker\"><a id=\"webhook\"><\/a><span class=\"wysiwyg-font-size-x-large\">Configuring Pivotal Tracker\u00a0<\/span><\/span><\/h1>\n<p>To configure a <em>Pivotal Tracker<\/em>\u00a0webhook for Kore.ai, you must have a <em>Pivotal Tracker<\/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>Pivotal Tracker<\/em>\u00a0system administrator for\u00a0your company. For more information, see the\u00a0<a href=\"http:\/\/www.pivotaltracker.com\/help\/gettingstarted\" target=\"_blank\" rel=\"noopener noreferrer\">Getting Started<\/a>\u00a0in the <em>Pivotal Tracker<\/em>\u00a0documentation.<br \/>\nTo get started configuring the webhook in <em>Pivotal Tracker<\/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 <em>Pivotal Tracker<\/em>.<\/li>\n<li>A valid Username and Password for an account with <em>Pivotal Tracker<\/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>Pivotal Tracker<\/em>\u00a0webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in <em>Pivotal Tracker<\/em>. The following URL is an example webhook URL.<br \/>\n<span class=\"wysiwyg-color-blue\" 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>Pivotal Tracker<\/em>\u00a0to configure a webhook using a Kore.ai webhook URL endpoint.<\/p>\n<ol>\n<li>Log on to <em>Pivotal Tracker<\/em>, and then on the <strong>Projects<\/strong> page, click the\u00a0<strong>Settings<\/strong> <img decoding=\"async\" class=\"icon\" src=\"\/wp-content\/uploads\/sites\/35\/DIYSettingsIcon-2.png\" alt=\"DIYSettingsIcon\" \/>\u00a0icon\u00a0for the project that you want to add a webhook to. The <strong>Project<\/strong> page is displayed.<\/li>\n<li>On the <strong>Projects<\/strong> page top menu bar, click <strong>Integrations<\/strong>. The <strong>Integration<\/strong> page is displayed.<\/li>\n<li>In the <strong>Activity Web Hook<\/strong> section, enter the\u00a0Kore.ai webhook URL for the alert, and then click <strong>Add<\/strong>.<\/li>\n<\/ol>\n<p>For more information, see <a href=\"http:\/\/www.pivotaltracker.com\/help\/integrations?version=v5#activity_web_hook\" target=\"_blank\" rel=\"noopener noreferrer\">Activity Webhook<\/a> in the <em>Pivotal Tracker<\/em>\u00a0documentation.<\/p>\n<p class=\"note\"><strong>Note:<\/strong> By default, all events for this Bot\u00a0generate Kore.ai alert messages. To reduce the number of notifications, this Bot\u00a0may have\u00a0filters that can be defined when\u00a0you set up the alert in your Kore.ai account.<\/p>\n<p>After you are connected, you can perform tasks for\u00a0<em>Pivotal Tracker<\/em>\u00a0directly from the Kore.ai application and setup message notifications to get notified in the Kore.ai application when an event occurs in <em>Pivotal Tracker<\/em>.<br \/>\nThe following table describes\u00a0<em>Pivotal Tracker<\/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>Add Story<\/strong><\/td>\n<td>In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select a\u00a0<strong>Project<\/strong><\/li>\n<li>enter a <strong>Name<\/strong><\/li>\n<li>select a <strong>Story Type<\/strong><\/li>\n<li>enter a <strong>Description<\/strong><\/li>\n<li>and then, enter <strong>Labels<\/strong><\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pivotal addstory<\/span>\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<tr>\n<td><strong>Change Status<\/strong><\/td>\n<td>In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select a\u00a0<strong>Project<\/strong><\/li>\n<li>select a <strong>Story<\/strong><\/li>\n<li>and then, select\u00a0a <strong>State<\/strong>.<\/li>\n<\/ul>\n<p>In a space room, you can enter the<span style=\"color: #0000ff\"> @pivotal changestate<\/span>\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<tr>\n<td><strong>Comment on a Story<\/strong><\/td>\n<td>In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select a\u00a0<strong>Project<\/strong><\/li>\n<li>select a <strong>Story<\/strong><\/li>\n<li>and then, enter a <strong>Comment<\/strong>.<\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pivotal commentstory<\/span>\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<tr>\n<td><strong>Create Project<\/strong><\/td>\n<td>In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>enter a <strong>Name<\/strong><\/li>\n<li>and then, select an\u00a0<strong>Account<\/strong>.<\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pivotal newproj<\/span>\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<tr>\n<td><strong>Create Task<\/strong><\/td>\n<td>In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select a <strong>Project<\/strong><\/li>\n<li>select a <strong>Story<\/strong><\/li>\n<li>and then, enter a <strong>Description<\/strong>.<\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pivotal createtask<\/span>\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<tr>\n<td><strong>Delete a Story<\/strong><\/td>\n<td>\u00a0In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select a <strong>Project<\/strong><\/li>\n<li>and then, select a <strong>Story<\/strong>.<\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pivotal deletestory<\/span>\u00a0<strong>Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n<tr>\n<td><strong>Update Story<\/strong><\/td>\n<td>\u00a0In the <strong>Perform Task<\/strong> dialog,<\/p>\n<ul>\n<li>select a <strong>Project<\/strong><\/li>\n<li>select a <strong>Story<\/strong><\/li>\n<li>enter a <strong>Name<\/strong><\/li>\n<li>enter a <strong>Description<\/strong><\/li>\n<li>and then, enter <strong>Labels<\/strong><\/li>\n<\/ul>\n<p>In a space room, you can enter the <span style=\"color: #0000ff\">@pivotal updatestory<\/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>Pivotal Tracker<\/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>, and then click one of the following <em>Pivotal Tracker<\/em>\u00a0webhook described in the following table.<\/p>\n<table border=\"0\" width=\"90%\">\n<tbody>\n<tr>\n<th>TASK<\/th>\n<th>TO CONFIGURE THIS TASK&#8230;<\/th>\n<\/tr>\n<tr>\n<td><strong>Pivotal Tracker Events<\/strong><\/td>\n<td>In the <strong>Setup Task<\/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\u00a0<a href=\"\/docs\/bots\/about-kore-bots\/addingbots\/integrating-with-pivotal-tracker\/#webhook\">Configuring Pivotal Tracker\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<li>and then, optionally customize the interval for message notifications in the\u00a0<strong>Check for updates<\/strong>\u2026 section<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td><strong>Get story assigned to you<\/strong><\/td>\n<td>In the <strong>Setup Task<\/strong> dialog,<\/p>\n<ul>\n<li>select a\u00a0<strong>Project<\/strong><\/li>\n<li>optionally customize the\u00a0<strong>Task Name<\/strong><\/li>\n<li>optionally customize the\u00a0<strong>Short Description<\/strong><\/li>\n<li>enable or disable\u00a0<strong>Mute task notifications<\/strong><\/li>\n<li>and then, optionally customize the interval for message notifications in the\u00a0<strong>Check for updates<\/strong>\u2026 section<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\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>Pivotal Tracker<\/em>, when any of the events occur in <em>Pivotal Tracker<\/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 Pivotal Tracker\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly\u00a0from the\u00a0Kore.ai application. To use the Pivotal Tracker\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 Pivotal Tracker, and the\u00a0notification messages that...","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-17749","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\/17749","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=17749"}],"version-history":[{"count":0,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17749\/revisions"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=17749"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=17749"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=17749"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}