{"id":17748,"date":"2016-06-13T10:13:53","date_gmt":"2016-06-13T10:13:53","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&amp;p=2626"},"modified":"2016-06-13T10:13:53","modified_gmt":"2016-06-13T10:13:53","slug":"integrating-with-papertrail","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/bot-store\/adding-bots\/integrating-with-papertrail\/","title":{"rendered":"Adding a Papertrail 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 <i>Papertrail<\/i>\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly from your messaging\u00a0channel such as Kore.ai Messenger. To use the\u00a0<i>Papertrail<\/i>\u00a0Bot, you just need to add the Bot to your messaging channel, and then configure the settings for the Bot, such as authentication to access\u00a0<i>Papertrail<\/i>, and the\u00a0notification messages that you want.\u00a0For more information about other Kore.ai Bots, see <a href=\"\/docs\/bots\/about-kore-bots\/addingbots\/\">Adding Bots<\/a>.<\/p>\n<h1><span class=\"ez-toc-section\" id=\"About_the_Koreai_Bot_for_Papertrail\"><span class=\"wysiwyg-font-size-x-large\">About the Kore.ai Bot for\u00a0Papertrail<\/span><\/span><\/h1>\n<p><img decoding=\"async\" class=\"logo2 alignleft\" src=\"\/wp-content\/uploads\/sites\/35\/DIYPapertrailLogo-2-300x67.png\" alt=\"DIYPapertrailLogo\" \/><em>Papertrail<\/em>\u00a0enables IT professionals, developer operations, and\u00a0developers to quickly and easily collect, monitor, search, interpret, and act on logging data\u00a0by\u00a0providing a simplified view into the rich log data generated by the infrastructure and applications within that infrastructure. You can use this Bot to\u00a0alert you when an incoming log message matches your search criteria.<\/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>Monitoring &amp; Analytics<\/strong>\u00a0&#8211; This Bot is available in the Kore.ai application in the\u00a0<strong>Monitoring &amp; Analytics<\/strong> category.<\/td>\n<\/tr>\n<tr>\n<td><strong>Channels<\/strong><\/td>\n<td><strong>Kore.ai<\/strong>\u00a0&#8211; This Bot is available in the Kore.ai Messenger application.<br \/>\n<strong>Spark<\/strong>\u00a0&#8211; This Bot is available in the Cisco Spark messaging application.<br \/>\n<strong>Slack<\/strong>\u00a0&#8211; This Bot is available in the Slack messaging application.<br \/>\n<strong>Skype<\/strong>\u00a0&#8211; This Bot is available in the Skype messaging application.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h1><span class=\"ez-toc-section\" id=\"Configuring_Papertrail\"><a id=\"webhook\"><\/a><span class=\"wysiwyg-font-size-x-large\">Configuring Papertrail\u00a0<\/span><\/span><\/h1>\n<p>To configure a <em>Papertrail<\/em> webhook for Kore.ai, you must have a <em>Papertrail<\/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>Papertrail<\/em>\u00a0system administrator for\u00a0your company. For more information, see the <a href=\"http:\/\/help.papertrailapp.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">Papertrail Knowledgebase<\/a>.<br \/>\nTo get started configuring the webhook in <em>Papertrail<\/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 messaging channel\u00a0for each alert that you want to enable in\u00a0<em>Papertrail<\/em>.<\/li>\n<li>A valid <strong>Username<\/strong> and <strong>Password<\/strong> for an account with <em>Papertrail<\/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>Papertrail<\/em>\u00a0webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in <em>Papertrail<\/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_Tasks\"><span class=\"wysiwyg-font-size-large\">Configuring Webhook Tasks<\/span><\/span><\/h2>\n<p>This procedure describes the steps in <em>Papertrail<\/em>\u00a0to configure a webhook using a Kore.ai webhook URL endpoint.<br \/>\nFirst you must create and save a search, then create an alert in <em>Papertrail<\/em> for that search, and then configure the <em>Papertrail<\/em> alert for a webhook.<\/p>\n<ol>\n<li>Log on to <em>Papertrail<\/em>, and then on the <strong>Dashboard<\/strong>\u00a0page, in the <strong>Searches<\/strong> field, click <strong>All Events<\/strong>. The <strong>All Systems<\/strong> page is displayed.<\/li>\n<li>At the bottom of the page, enter search terms in the <strong>Search<\/strong> field that you want an alert for, such as <span style=\"color: #0000ff\"><em><span class=\"wysiwyg-color-blue\">warning<\/span><\/em><\/span> or <em><span class=\"wysiwyg-color-blue\">error<\/span><\/em>, click <strong>Search<\/strong>, and then click <strong>Save Search<\/strong>.<\/li>\n<li>In the <strong>Create a New Search<\/strong>\u00a0field, enter a name for the search used in the <em>Papertrail\u00a0<\/em>application, for example, <em><span class=\"wysiwyg-color-blue\"><span style=\"color: #0000ff\">My<\/span> <span style=\"color: #0000ff\">Webhook for Errors and Warnings<\/span><\/span><\/em>, and then click <strong>Save &amp;\u00a0Setup an Alert<\/strong>.<\/li>\n<li>On the <strong>Create an Alert<\/strong> page, click <strong>Webhook<\/strong>. The <strong>Create Alert<\/strong> page is displayed.<\/li>\n<li>In the <strong>Alert Details<\/strong> section, in the <strong>Frequency<\/strong> field, select how frequent an alert is sent by\u00a0<em>Papertrail<\/em> when an event matches your search query.<\/li>\n<li>In the <strong>Webhook Details<\/strong> section, in the <strong>URL<\/strong> field, enter the\u00a0Kore.ai webhook URL for the alert, and then click <strong>Create Alert<\/strong>.<\/li>\n<li>The <strong>Create Alert<\/strong> page is closed and the alert is saved.<\/li>\n<\/ol>\n<p>For more information, see <a href=\"http:\/\/help.papertrailapp.com\/kb\/how-it-works\/web-hooks\/\" target=\"_blank\" rel=\"noopener noreferrer\">Webhooks<\/a> in the <em>Papertrail<\/em>\u00a0documentation.<br \/>\nTo\u00a0setup real-time notifications in your messaging channel\u00a0using a\u00a0<em>Papertrail<\/em>\u00a0webhook, for example, in the Kore.ai Messenger channel, 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>Log Search\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-papertrail\/#webhook\">Configuring Papertrail\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 click <strong>Finish<\/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, when any of the webhook events occur in <em>Papertrail<\/em>, a message is displayed in your preferred messaging channel.<\/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 Papertrail\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly from your messaging\u00a0channel such as Kore.ai Messenger. To use the\u00a0Papertrail\u00a0Bot, you just need to add the Bot to your messaging channel, and then configure the settings for the Bot, such as authentication to access\u00a0Papertrail, 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-17748","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\/17748","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=17748"}],"version-history":[{"count":0,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/17748\/revisions"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=17748"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=17748"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=17748"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}