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

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

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

\"DIYSemaphoreLogo\"Semaphore<\/em>\u00a0is a hosted continuous-integration and deployment service for open source and private software projects. You can use this Bot to get notification messages for repository changes such as commit, or deploy.<\/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><\/a>Configuring Semaphore<\/span><\/span><\/h1>\n

To configure a Semaphore<\/em> webhook for Kore.ai, you must have a Semaphore<\/em>\u00a0account with administrator access as well as API access to configure a webhook. If you don’t, you’ll need to contact the Semaphore<\/em>\u00a0system administrator for\u00a0your company. For more information, see the\u00a0Semaphore Documentation<\/a>.
\nTo get started configuring the webhook in Semaphore<\/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\u00a0Semaphore<\/em>.<\/li>\n
  2. A valid Username and Password for an account with Semaphore<\/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 Semaphore<\/em>\u00a0webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in Semaphore<\/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 Semaphore<\/em>\u00a0to configure a webhook using a Kore.ai webhook URL endpoint.<\/p>\n

      \n
    1. Log on to Semaphore<\/em>, and then on the Your Projects<\/strong> page, select the project that you want to add a webhook to. The < Your Project Name<\/em> ><\/strong> page is displayed.<\/li>\n
    2. At the top of the page, click Project Settings<\/strong>. The Project Settings<\/strong> page is displayed.<\/li>\n
    3. On the left navigation menu, click Notifications<\/strong>. The Your Personal Email Notifications Settings<\/strong> page is displayed.<\/li>\n
    4. Click Webhooks<\/strong>. The Post-build webhooks<\/strong> page is displayed.<\/li>\n
    5. Click Add Webhook<\/strong>.<\/li>\n
    6. In the URL<\/strong> field, enter the\u00a0Kore.ai webhook URL for the alert.<\/li>\n
    7. Optionally, specify when Semaphore should create an alert in the Receive after<\/strong> field.<\/li>\n
    8. Click Save Settings<\/strong>.<\/li>\n<\/ol>\n

      For more information, see Notifications<\/a> in the Semaphore<\/em>\u00a0documentation.
      \nYou can setup message notifications to your Kore.ai account using a Semaphore<\/em>\u00a0webhook. Click\u00a0\"\", click Get notified when…<\/strong>, click Build<\/strong>\u00a0Update<\/strong>, and then\u00a0in\u00a0the Setup Task\u00a0<\/strong>dialog:<\/p>\n