{"id":17758,"date":"2016-06-13T10:26:26","date_gmt":"2016-06-13T10:26:26","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&#038;p=2650"},"modified":"2019-05-24T09:25:09","modified_gmt":"2019-05-24T08:25:09","slug":"integrating-with-snap-ci","status":"publish","type":"post","link":"https:\/\/multisite.korebots.com\/v9-0\/docs\/bots\/bot-store\/adding-bots\/integrating-with-snap-ci\/","title":{"rendered":"Adding a Snap CI Bot"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row via_grid cols_1 laptops-cols_inherit tablets-cols_inherit mobiles-cols_1 valign_top type_default stacking_default\"><div class=\"wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><p>Kore.ai provides integration for a built-in <em>Snap CI<\/em>\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly\u00a0from the\u00a0Kore.ai application. To use the <em>Snap CI<\/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>Snap CI<\/em>, and the\u00a0notification messages that you want. This topic describes the <em>Snap CI<\/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><span style=\"line-height: 1.42857;\">.<\/span><\/p>\n<h1><span class=\"ez-toc-section\" id=\"About_the_Koreai_Bot_for_Snap_CI\"><\/span><span class=\"wysiwyg-font-size-x-large\">About the Kore.ai Bot for\u00a0Snap CI<\/span><span class=\"ez-toc-section-end\"><\/span><\/h1>\n<p><img decoding=\"async\" class=\"logo2 alignleft\" src=\"\/wp-content\/uploads\/sites\/22\/DIYSnapLogo-2-300x80.png\" alt=\"DIYSnapLogo\" \/><em>Snap CI<\/em> handles your build and delivery infrastructure using continuous delivery without requiring hardware.<\/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>Developer Tools<\/strong>\u00a0&#8211; This Bot is available in the Kore.ai application in the\u00a0<strong>Developer Tools\u00a0<\/strong>category.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h1><span class=\"ez-toc-section\" id=\"Configuring_Snap_CI\"><\/span><a id=\"webhook\"><\/a>Configuring Snap CI<span class=\"ez-toc-section-end\"><\/span><\/h1>\n<p><span style=\"font-size: 14px; line-height: 1.42857;\">To configure a <\/span><em style=\"font-size: 14px; line-height: 1.42857;\">Snap CI<\/em><span style=\"font-size: 14px; line-height: 1.42857;\"> webhook for Kore.ai, you must have a <\/span><em style=\"font-size: 14px; line-height: 1.42857;\">Snap CI<\/em><span style=\"font-size: 14px; line-height: 1.42857;\">\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 <\/span><em style=\"font-size: 14px; line-height: 1.42857;\">Snap CI<\/em><span style=\"font-size: 14px; line-height: 1.42857;\">\u00a0system administrator for\u00a0your company. For more information, see the <\/span><a style=\"font-size: 14px; line-height: 1.42857; background-color: #ffffff;\" href=\"https:\/\/docs.snap-ci.com\/getting-started\/\" target=\"_blank\" rel=\"noopener noreferrer\">Getting Started<\/a><span style=\"font-size: 14px; line-height: 1.42857;\">\u00a0in the<\/span><em style=\"font-size: 14px; line-height: 1.42857;\">Snap CI<\/em><span style=\"font-size: 14px; line-height: 1.42857;\"> documentation.<\/span><\/p>\n<p>To get started configuring the webhook in <em>Snap CI<\/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>Snap CI<\/em>.<\/li>\n<li>A valid Username and Password for an account with <em>Snap CI<\/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>Snap CI<\/em>\u00a0webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in <em>Snap CI<\/em>. The following URL is an example webhook URL.<br \/>\n<span class=\"wysiwyg-color-blue\" style=\"color: #0000ff;\">https:\/\/app.kore.com\/hooks\/c6089802f36250c179dcb1aa29afd24c<\/span><\/p>\n<h2><span class=\"ez-toc-section\" id=\"Configuring_Webhook\"><\/span><span class=\"wysiwyg-font-size-large\">Configuring Webhook<\/span><span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>This procedure describes the steps in <em>Snap CI<\/em>\u00a0to configure a webhook using a Kore.ai webhook URL endpoint.<\/p>\n<ol>\n<li>Log on to <em>Snap CI<\/em>, and then on the <strong>Your Builds<\/strong> page, select your repository that you want to add a webhook to, and then on the top menu bar, click <strong>Notifications<\/strong>.<\/li>\n<li>On the <strong>Notifications<\/strong> page, on the lefthand navigation menu, click <strong>Webhook.<\/strong><\/li>\n<li>In the <strong>Webhook URL<\/strong> dialog, in the <strong>URL<\/strong> field, enter the\u00a0Kore.ai webhook URL for the alert, and then click <strong>Save<\/strong>.<\/li>\n<\/ol>\n<p>For more information, see <a href=\"https:\/\/docs.snap-ci.com\/notifications\/webhook-notifications\/\" target=\"_blank\" rel=\"noopener noreferrer\">Webhook Notifications<\/a> in the <em>Snap CI<\/em>\u00a0documentation.<br \/>\nYou can setup message notifications to your Kore.ai account using a <em>Snap CI<\/em>\u00a0webhook. Click\u00a0<img loading=\"lazy\" decoding=\"async\" class=\"inline alignnone\" src=\"\/wp-content\/uploads\/sites\/22\/newtask.png\" alt=\"\" width=\"30\" height=\"34\" \/>, click <strong>Get notified when&#8230;<\/strong>, click <strong>Build\u00a0Updates<\/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-snap-ci\/#webhook\">Configuring Snap CI\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\"><\/span><em><span class=\"wysiwyg-font-size-x-large\">Next Steps<\/span><\/em><span class=\"ez-toc-section-end\"><\/span><\/h1>\n<p>After the webhook is configured in <em>Snap CI<\/em>, when any of the events occur in <em>Snap CI<\/em>, a message is displayed on the <strong>Bots<\/strong> tab in the <strong>Messages<\/strong> section for the Kore.ai account.<\/p>\n<\/div><\/div><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><\/section>\n","protected":false},"excerpt":{"rendered":"Kore.ai provides integration for a built-in Snap CI\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly\u00a0from the\u00a0Kore.ai application. To use the Snap CI\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 Snap CI, 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":[43],"tags":[],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/17758"}],"collection":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/comments?post=17758"}],"version-history":[{"count":2,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/17758\/revisions"}],"predecessor-version":[{"id":21162,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/17758\/revisions\/21162"}],"wp:attachment":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/media?parent=17758"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/categories?post=17758"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/tags?post=17758"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}