API and Integration
      Back to home
      1. Smartocto Knowledgebase
      2. Implementations
      3. API and Integration

      Smartocto Realtime: Receive notifications in Slack

      You’re about to connect your Slack Workspace with smartocto to receive notifications. In this document we describe what actions you should take, to receive notifications. To setup a successful connection to smartocto, please add a user per webhook-url and fill in the details. For each Slack channel in the workspace, an individual Slack Webhook-url is necessary.

      Instructions

      1. Visit api.slack.com/apps where you can find all your Slack-apps. One app can have more than one Slack Webhook-url.

      2. Click on Create an App to setup a new app.
        NOTE: If you already have an app connected to your workspace, which you can use to add a webhook-url, go to step 4.

      3. Enter a clear app-name which tells what the app does, for example ‘smartocto notifications’. Next, select your workspace:
      4. Select Incoming Slack Webhooks. 
      5. Activate the Incoming Slack Webhooks by switching the off-toggle (1) to on as displayed below. Next click on Add New Slack Webhook to Workspace (2) to finish.
      6. Select which channel should show the information, received by the party who sends information to the Slack Webhook-url.
      7. After selecting the channel, you’ll see information about your Slack Webhook-url, like displayed below. Copy the Slack Webhook-url (starts with hooks.slack.com/services…)
      8. In the next steps you'll add the webhook-url to a profile in smartocto Realtime to receive the notifications.

      Add webhook to Realtime

      To connect the notifications stream to your Slack channel, you need to create a user, add the Slack webhook-url via the Settings for the user and select notifications:

      1. Add a user for the realtime system.
      2. Activate the user.
      3. Login with the user credentials.
      4. Go to the Settings for the user.
        realtime-settings-icon
      5. Add the Slack webhook-url with the name of the channel.Realtime-add-slack-webhook-and-channel
      6. Enable the notifications.
        realtime-enable-mail-notifications
      7. Check the checkboxes for the channel Slack on the notifications you want to send to Slack.
        Realtime-check-slack-checkbox
      8. When checking the boxes, immediately the new generated selected notifications are sent to the Slack webhook-url.

      How to test

      New notifications for the type(s) you selected, should come in the next time they are generated.

       

      Resources