Integrating with Slack – Valven

Slack Connection In Valven Atlas

Visit Connected Applications on the sidebar. Find Slack under Messaging and click Connect.

Configuring The Slack Account

Slack Configurations for Valven Atlas Cloud

Step 1: You will be redirected to Slack where you will need to authorize access to your organization.

Screenshot from 2023-11-28 16-54-25.png

Slack Configurations for Valven Atlas Onprem

Step 1: To create a Slack application, first go to https://api.slack.com/apps page.

Step 2: Click on the Create New App button at the top of the page.

Step 3: Select the "From a manifest" option.

Step 4: Select the related Workspace to develop your app in Valven Atlas.

Step 5: Apply the following manifest in JSON format to create the Slack application.

{
  "_metadata": {
    "major_version": 1,
    "minor_version": 1
  },
  "display_information": {
    "name": "Valven Atlas",
    "description": "Valven Atlas enables retrieving advanced insights on the software delivery process for the engineering teams",
    "background_color": "#0022ff",
    "long_description": "Valven Atlas, with the integration to git, issue management, automation systems like GitHub, Jira, Slack, Jenkins, enables retrieving advanced insights on the software delivery process for the engineering teams and individuals to improve the company performance with a better alignment on business decisions.\r\n\r\n*Well Organized Data, Better Decisions*\r\nCollect development data and interpret them in a way that can reflect the mistakes in the past and enable correct decisions in real-time and for the future.\r\n\r\n*Collaboration Highlights*\r\nReveal the steps and the journey of any issue, sprint, release, project to get a detailed overview and prevent any blockage.\r\n\r\n*Business Alignment*\r\nGet a detailed analysis of unplanned work, bug fixes, discussions, responses to understand how they affect the development process. Use the data to coordinate the business side with production.\r\n\r\n*Healthy Flow In Production*\r\nUnderstand the progress between each junction of the project and the time spent in issue transition from analysis to development or development to test processes to remove bottlenecks."
  },
  "features": {
    "bot_user": {
      "display_name": "Valven Atlas",
      "always_online": true
    },
    "app_home": {
      "home_tab_enabled": false,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": true
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "team:read",
        "channels:read",
        "groups:read",
        "im:read",
        "mpim:read",
        "chat:write",
        "users:read.email",
        "users:read",
        "im:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "app_mention"
      ]
    },
    "interactivity": {
      "is_enabled": true
    },
    "org_deploy_enabled": false,
    "socket_mode_enabled": true
  }
}

Copy and paste the manifest from the JSON tab.

Step 6: Click the Create button to finalize the Slack application creation.

Step 7: The information such as App ID, Client ID, Client Secret, etc can be reached on the opened App Detail page. After saving the information where you can access it when it is needed, Click on the "Install App" option at the left side of the page.

Step 8: Click on the "Install to <Workspace Name>"

Step 9: Click on the Allow button to create the Token and give permission to Valven Atlas to access your workspace.

Step 10: Open the Valven Atlas Connected Apps page as highlighted in the "Slack Connection In The Valven Atlas" section at the beginning of this guide. Then, copy the OAuth Token from the installed App settings and paste it to the field opened after clicking the connect button on the Valven Atlas Connected Applications page.

Finalize the Connection in Valven Atlas

After giving authorization for Valven Atlas Cloud or pasting the OAuth Token for Valven Atlas Onprem, you will be redirected to the Valven Atlas Connect Application page, in case you wish to add another integration.

Final Configurations to Define a Slack Flow

Step 1: On Slack, mention Valven Atlas in the channel that you want to receive notifications.

Step 2: Click the Invite Them button

Step 3: Now you can receive notifications on your Slack channels from the Automations you define on Valven Atlas.