Documentation

Connect Slack to Vela

Connect Vela to your Slack workspace. Your AI agent can answer questions and resolve customer support tickets directly inside Slack in under 5 minutes.

Your AI agent works inside Slack. Once connected, it monitors messages, responds to mentions, and resolves support tickets without anyone leaving the conversation.

Here is what you need to do on the Slack API side.

Create a Slack App

  1. Go to api.slack.com/apps and click Create New App.

  2. Choose From a manifest. This lets you configure everything with one JSON file instead of clicking through forms.

  3. Paste the JSON manifest below:

    {
      "display_information": {
        "name": "Your App Name (e.g. Acme Support)"
      },
      "features": {
        "app_home": {
          "home_tab_enabled": false,
          "messages_tab_enabled": true,
          "messages_tab_read_only_enabled": false
        },
        "bot_user": {
          "display_name": "support-bot",
          "always_online": true
        }
      },
      "oauth_config": {
        "scopes": {
          "bot": [
            "app_mentions:read",
            "chat:write",
            "im:history",
            "im:read",
            "im:write",
            "channels:history",
            "channels:read",
            "groups:history",
            "mpim:history"
          ]
        }
      },
      "settings": {
        "event_subscriptions": {
          "request_url": "https://yco4b94kgxnz.shares.zrok.io/api/integrations/slack/webhook",
          "bot_events": [
            "app_mention",
            "message.im"
          ]
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
      }
    }
  4. Click Next, then Create.

Install the App to Your Workspace

  1. In your app's dashboard, go to the Install App section on the left sidebar.

  2. Click Install to Workspace and review the permissions. Approve the installation.

Copy Your Credentials

You need two values from the Slack dashboard to connect in Vela.

Bot User OAuth Token Go to the Install App page. Copy the token that starts with xoxb-.

Signing Secret Go to Basic Information. Scroll down to App Credentials and copy the Signing Secret.

Connect in Vela

Open your Vela dashboard, navigate to the Slack integration settings, and paste both credentials. Your AI agent is now live in Slack.