{"id":17760,"date":"2016-06-13T10:29:11","date_gmt":"2016-06-13T10:29:11","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&p=2654"},"modified":"2019-05-24T09:29:02","modified_gmt":"2019-05-24T08:29:02","slug":"integrating-with-subversion","status":"publish","type":"post","link":"https:\/\/multisite.korebots.com\/v9-0\/docs\/bots\/bot-store\/adding-bots\/integrating-with-subversion\/","title":{"rendered":"Adding a Subversion Bot"},"content":{"rendered":"

Kore.ai provides integration for a built-in Subversion<\/em> Bot that you can use to display message notifications and execute tasks directly from Kore.ai Messenger or other supported channels. To use the Subversion<\/em>\u00a0Bot, you just need to add the Bot to your channel, and then configure the settings for the Bot, such as authentication to access Subversion<\/em>, and the\u00a0notification messages that you want. This topic describes the Subversion<\/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\u00a0Subversion<\/span><\/span><\/h1>\n

\"DIYSubversionLogo\"Subversion<\/em> is a full-featured version control system originally designed to be a better concurrent versions system. You can use this Bot to get a notification when a commit is made in the configured repository.<\/p>\n\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>\nDeveloper Tools<\/strong>\u00a0– This Bot is available in the Kore.ai application in the\u00a0Developer Tools\u00a0<\/strong>category.<\/td>\n<\/tr>\n
Channels<\/strong><\/td>\nKore.ai<\/strong>\u00a0– This Bot is available in the Kore.ai Messenger application.
\nSpark<\/strong>\u00a0– This Bot is available in the Cisco Spark application.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

<\/span>Configuring Subversion\u00a0<\/span><\/span><\/h1>\n

To configure a Subversion<\/em> webhook for Kore.ai, you must have a Subversion<\/em>\u00a0account with administrator access as well as API access to configure a webhook. If you don’t, you’ll need to contact the Subversion<\/em>\u00a0system administrator for\u00a0your company.
\nTo get started configuring the webhook in Subversion<\/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\u00a0Subversion<\/em>.<\/li>\n
  2. A valid Username and Password for an account with Subversion<\/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 Subversion<\/em>\u00a0webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in Subversion<\/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 Subversion<\/em>\u00a0to configure a webhook using a Kore.ai webhook URL endpoint. In Subversion<\/em>, you must download the Kore.ai\u00a0subversion.pl<\/span> file, add your Kore.ai webhook URL to that file, and then point your Subversion<\/em> repository to that file.<\/p>\n

      \n
    1. Download the subversion.pl<\/span> file using the link at the bottom of this page in the Article Attachments<\/strong> section, and save to a local directory on the computer where you will run\u00a0Subversion<\/em> from, for example, \u00a0the\u00a0<\u00a0MySubversionHome\u00a0<\/em><\/strong>>\/properties\/<\/span>\u00a0directory.<\/li>\n
    2. In a text editor of your choice, open the subversion.pl<\/span>\u00a0file, and then set the property for the Kore.ai webhook URL by modifying the following line:
      \n
      \n

      my $koreWebhookUrl = “https:\/\/app.kore.com\/hooks\/id<\/strong>“;<\/span><\/p>\n<\/blockquote>\n

      with your Kore.ai Webhook URL, and then Save<\/strong>\u00a0the\u00a0file.<\/span><\/p>\n<\/li>\n

    3. In Subversion<\/em>, right-click on\u00a0your repository that you want to add the webhook to, and then click Properties<\/strong>.<\/li>\n
    4. On the Properties<\/strong> dialog, on the Hooks<\/strong> tab, in the Commit<\/strong> section, click Post-commit hook<\/strong>.<\/li>\n
    5. In the Post-commit hook<\/strong> dialog, enter the path to the modified subverison.pl<\/span> file, and then click OK<\/strong>.<\/li>\n<\/ol>\n

      For more information, see How to use Webhooks<\/a> in the SourceForge<\/em>\u00a0documentation.
      \nYou can setup message notifications to Kore.ai Messenger\u00a0using a Subversion<\/em>\u00a0webhook. Click\u00a0\"\", click Get notified when…<\/strong>, click Commit Notification<\/strong>, and then\u00a0in\u00a0the Setup Task\u00a0<\/strong>dialog:<\/p>\n