{"id":17753,"date":"2016-06-13T10:20:14","date_gmt":"2016-06-13T10:20:14","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&p=2638"},"modified":"2019-05-24T09:18:48","modified_gmt":"2019-05-24T08:18:48","slug":"integrating-with-runscope","status":"publish","type":"post","link":"https:\/\/multisite.korebots.com\/v9-0\/docs\/bots\/bot-store\/adding-bots\/integrating-with-runscope\/","title":{"rendered":"Adding a Runscope Bot"},"content":{"rendered":"

Kore.ai provides integration for a built-in Runscope<\/em>\u00a0Bot\u00a0that you can use to display\u00a0message notifications and execute tasks directly\u00a0from the\u00a0Kore.ai application. To use the Runscope<\/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 Runscope<\/em>, and the\u00a0notification messages that you want. This topic describes the Runscope<\/em>\u00a0built-in Bot\u00a0for Kore.ai.\u00a0For more information about other Kore.ai Bots, see Adding Bots<\/a>.<\/p>\n

<\/span>About the Kore.ai Bot for\u00a0Runscope<\/span><\/span><\/h1>\n

\"\"Runscope<\/em> provides complete logging for all of your API traffic. With logs, you can track down troublesome API calls with a powerful search engine. You can also debug problems with logging\u00a0details of all\u00a0API requests and responses, private or public.<\/p>\n\n\n\n\n
Integration Type<\/strong><\/td>\nWebhook<\/strong> – Connect to this Bot using a webhook integration where the web application pushes\u00a0message notifications in near real time.<\/td>\n<\/tr>\n
Category<\/strong><\/td>\nMonitoring & Analytics<\/strong>\u00a0– This Bot is available in the Kore.ai application in the\u00a0Monitoring & Analytics\u00a0<\/strong>category.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

<\/span><\/a>Configuring Runscope<\/span><\/span><\/h1>\n

To configure a Runscope<\/em> webhook for Kore.ai, you must have a Runscope<\/em>\u00a0account with administrator access as well as API access to configure a webhook. If you don’t, you’ll need to contact the Runscope<\/em>\u00a0system administrator for\u00a0your company. For more information, see the\u00a0Runscope Documentation<\/a>.
\nTo get started configuring the webhook in Runscope<\/em>, you’ll need two\u00a0things:<\/p>\n

    \n
  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\u00a0Runscope<\/em>.<\/li>\n
  2. A valid Username and Password for an account with Runscope<\/em>\u00a0API access.<\/li>\n<\/ol>\n

    The webhook URL is account-specific and cannot be transferred to any other account. This means that if you configure a Runscope<\/em>\u00a0webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in Runscope<\/em>. The following URL is an example webhook URL.
    \nhttps:\/\/app.kore.com\/hooks\/c6089802f36250c179dcb1aa29afd24c<\/span><\/p>\n

    <\/span>Configuring Webhook<\/span><\/span><\/h2>\n

    This procedure describes the steps in Runscope<\/em>\u00a0to configure a webhook using a Kore.ai webhook URL endpoint.<\/p>\n

      \n
    1. Log on to Runscope<\/em>, and then on the lefthand navigation menu, click\u00a0All Tests<\/strong>. The API Tests<\/strong> page is displayed.<\/li>\n
    2. In the first field, select your test that you want to add a webhook to, and then click Edit Test<\/strong>.<\/li>\n
    3. On the< My Test Name<\/em> ><\/strong> page\u00a0page, in the Test Settings<\/em> section, click Notifications<\/strong>.<\/li>\n
    4. On the Notification<\/strong> page, in the Callback URLs<\/strong> field, enter the\u00a0Kore.ai webhook URL for the alert.<\/li>\n
    5. At the top of the\u00a0< My Test Name<\/em> ><\/strong> page, click Save<\/strong>.<\/li>\n<\/ol>\n

      For more information, see Webhook Notifications<\/a> in the Runscope<\/em>\u00a0documentation.
      \nAfter you are connected, you can perform tasks for\u00a0Runscope<\/em>\u00a0directly from the Kore.ai application and setup message notifications to get notified in the Kore.ai application when an event occurs in\u00a0Runscope<\/em>.
      \nThe following table describes\u00a0Runscope<\/em>\u00a0tasks that you can integrate with Kore.ai.<\/p>\n\n\n\n\n\n\n\n
      TASK<\/strong><\/th>\nTO CONFIGURE THIS TASK…<\/th>\n<\/tr>\n
      Clear Bucket<\/strong><\/td>\nIn the Perform Task<\/strong> dialog, select a Bucket<\/strong>.
      \nIn a space room, you can enter the @runscope clearbucket<\/span>\u00a0Bot<\/strong>command to invoke and configure this task.<\/td>\n<\/tr>\n
      Create\u00a0Bucket<\/strong><\/td>\nIn the Perform Task<\/strong> dialog,<\/p>\n
        \n
      • enter a Bucket Name<\/strong><\/li>\n
      • and then, select a Team<\/strong>.<\/li>\n<\/ul>\n

        In a space room, you can enter the @runscope newbucket\u00a0<\/span>Bot<\/strong>command to invoke and configure this task.<\/td>\n<\/tr>\n

      Create Request<\/strong><\/td>\nIn the Perform Task<\/strong> dialog,<\/p>\n
        \n
      • select a Bucket<\/strong><\/li>\n
      • select a Request Method<\/strong><\/li>\n
      • enter a Request URL<\/strong><\/li>\n
      • enter a Request Body<\/strong><\/li>\n
      • select a Request Body Encoding<\/strong><\/li>\n
      • enter a Request Timestamp<\/strong><\/li>\n
      • and then, enter a Response Status<\/strong><\/li>\n<\/ul>\n

        In a space room, you can enter the @runscope newreq<\/span>\u00a0Bot<\/strong> command to invoke and configure this task.<\/td>\n<\/tr>\n

      Delete Bucket<\/strong><\/td>\nIn the Perform Task<\/strong> dialog, select a Bucket<\/strong>.
      \nIn a space room, you can enter the @runscope deletebucket<\/span>\u00a0\u00a0Bot<\/strong>command to invoke and configure this task.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      You can setup message notifications to your Kore.ai account using a Runscope<\/em>\u00a0webhook. Click\u00a0\"\", click Get notified when…<\/strong>, click API Health Notifications<\/strong>, and then\u00a0in\u00a0the Setup Task\u00a0<\/strong>dialog:<\/p>\n