Slack Integration

The Automind Agentflow platform allows you to create and deploy your automation agent directly in Slack, enabling seamless integration with your team's communication and workflow processes.

Prerequisites

Before integrating your Automind Agentflow with Slack, ensure you have:

• A built and published Automind Agentflow bot
• A Slack account with appropriate permissions
• Access to create Slack applications in your workspace
• Administrative rights to install apps in your Slack workspace

Note: Slack channel integration requires cloud deployment. On-premise installations may have limited functionality for Slack integration.

This section describes how to integrate your Automind Agentflow with Slack using the Slack API and Bot Framework.

Step 1: Create a Slack Application for Your Bot

Access Slack API Portal

1. Sign in to Slack

   • In your browser, navigate to Slack Sign In
   • Sign in with your Slack credentials

2. Navigate to Your Apps Panel

   • Go to Your Apps in the Slack API portal
   • This is where you'll manage all your Slack applications

Create New Slack Application

1. Start App Creation

   • If this is your first Slack app, click Create New App
   • If you have existing apps, click Create an App

2. Choose Configuration Method

   • Select how you want to configure your app's scopes and settings
   • Choose From scratch for manual configuration
   • Alternatively, you can choose From an app manifest if you have a pre-defined configuration

3. Configure Basic App Information

   • In the App Name field, enter a descriptive name for your Automind Agentflow
   • From the Development Slack Team dropdown, select your development workspace
   • If you're not a member of a development team, create or join one

4. Create the Application

   • Click Create App to proceed
   • Your new Slack application will be created and you'll be redirected to the app settings

Retrieve Application Credentials

1. Access App Details

   • Navigate to Your Apps and click on the Slack app you just created
   • Scroll down to the App Credentials section

2. Copy Essential Credentials Save the following values as you'll need them later:

   • Client ID: Unique identifier for your application
   • Client Secret: Secret key for authentication
   • Signing Secret: Used to verify requests from Slack

Important: Keep these credentials secure and never share them publicly. You'll need them in Step 3 when configuring the No-Code Agent channel.

Step 2: (Optional) Add Special Scopes and Generate Bot User OAuth Token

If your No-Code Agent requires special permissions (such as file handling, advanced messaging features, or workspace information access), you'll need to configure OAuth scopes and generate a Bot User OAuth Token.

Understanding Slack Scopes

A Slack app's capabilities and permissions are governed by the scopes it requests. Different features require different scopes:

• File operations: files:read, files:write
• User information: users:read, users:read.email
• Channel management: channels:read, channels:write
• Message handling: chat:write, chat:write.public

Configure OAuth Scopes

1. Access OAuth Settings

   • In your Slack app settings, navigate to Features > OAuth & Permissions
   • Scroll down to the Scopes section

2. Add Bot Token Scopes

   • Under Bot Token Scopes, click Add an OAuth scope
   • Select the required scopes for your agent's functionality
   • Common scopes include:
     • chat:write - Send messages as the bot
     • files:read - Read file content
     • users:read - Access user information

Generate OAuth Token

1. Install App to Workspace

   • Scroll up to OAuth Tokens for Your Workspace
   • Click Install to Workspace

2. Authorize the Application

   • Review the permissions your app is requesting
   • Click Allow to grant access to your workspace

3. Copy Bot User OAuth Token

   • After authorization, the Bot User OAuth Token will be automatically generated
   • Copy this token as you'll need it for advanced Automind Agentflow features

Important: If you add new Bot Token Scopes later, you must click Reinstall to Workspace for the changes to take effect. The Bot User OAuth Token remains unchanged during reinstallation.

Step 3: Create Slack Channel in Automind Agentflow

Configure Slack Channel

1. Access Channel Creation

   • Log into your Automind Agentflow Portal
   • Navigate to Channels from the sidebar menu
   • Click the New button to start creating a new channel

2. Configure Basic Information

   • Enter a descriptive Name for your Slack channel
   • Provide a Description explaining the channel's purpose
   • Select your Agent from the dropdown menu
   • Choose Slack from the Platform dropdown
   • Click Next to proceed

3. Configure Slack Specific Settings

   • Enter the OAuth Access Token (Bot User OAuth Token from Step 2 if configured, or leave empty for basic setup)
   • Click Next to continue

4. Complete Channel Setup

   • Copy the Callback URL displayed on the final page for webhook configuration
   • Click Create Channel to finalize the setup
   • The channel will be created and activated

Available Context Parameters

After successful channel activation, Automind Agentflow provides the following user context parameters:

• [[ChatUser]].ChannelId = "slack"
• [[ChatUser]].UserId - Unique identifier for the Slack user account
• Additional parameters may be available based on your Slack app's permissions

Step 4: Configure Your Slack Application

Add Redirect URL

1. Access OAuth Settings

   • In Slack, navigate to Your Apps
   • Click on your application

2. Configure Redirect URLs

   • On the left menu, click OAuth & Permissions
   • Scroll down to the Redirect URLs section
   • Click Add a new Redirect URL

3. Enter Automind Agentflow URL

   • Paste the OAuth & Permissions Redirect URL copied from Step 3
   • Click Add to save the URL
   • Click Save URLs to confirm the changes

Set Up App Interactivity

1. Configure Interactive Features

   • On the left menu, click Interactivity & Shortcuts
   • Toggle Interactivity to On

2. Set Request URL

   • In the Request URL field, enter: https://slack.botframework.com/api/Actions
   • This is the standard endpoint for Slack Bot Framework integration
   • Click Save Changes

Subscribe to Bot Events

Event subscriptions allow your Automind Agentflow to receive notifications about user activities in Slack.

1. Enable Event Subscriptions

   • On the left menu, click Event Subscriptions
   • Toggle Enable Events to On

2. Configure Request URL

   • In the Request URL field, enter the Event Subscription Request URL from Step 3
   • Slack will verify the URL automatically

3. Add Required Bot Events

   • In Subscribe to Bot Events, click Add Bot User Event
   • Add the following essential event types:
     • member_joined_channel - User joins a channel
     • member_left_channel - User leaves a channel
     • message.channels - Messages in public channels
     • message.groups - Messages in private channels
     • message.im - Direct messages
     • message.mpim - Multi-party direct messages

4. Save Event Configuration

   • Click Save Changes at the bottom of the page
   • Slack will display any additional scopes required for these events

Configure App Home

1. Enable Messages Tab

   • From the Features menu, click App Home
   • Scroll down to the Show Tabs section

2. Allow Direct Messaging

   • Toggle Messages Tab to On
   • Check Allow users to send Slash commands and messages from the messages tab

Step 5: Install Application to Slack Workspace

Final Installation

1. Reinstall Application

   • From the left menu, click Basic Information
   • In the Install your app section, click Reinstall to Workspace

2. Grant Permissions

   • Review the permissions your Automind Agentflow is requesting
   • Click Allow to grant access to your Slack workspace

Verify Installation

1. Confirm App Presence

   • The app will appear in Slack under the Apps section in the left sidebar
   • You can now use your Automind Agentflow in Slack

2. Additional Confirmation (if required)

   • Based on your workspace configuration, additional confirmation may be needed:
     • In Automind Agentflow Portal, go to Channels tab
     • Click the Slack channel icon
     • Sign in to your Slack workspace if prompted
     • Review permissions and click Allow

Note: Starting with recent versions, when a user initiates a conversation with the bot, the Welcome flow is automatically triggered, ensuring a seamless interaction experience.

Using Your No-Code Agent in Slack

Direct Messaging

• Click on your Automind Agentflow app in the Slack sidebar
• Start typing to begin a conversation
• The agent will respond based on your configured automation workflows

Channel Integration

To use your Automind Agentflow in Slack channels:

1. Add Bot to Channel

   • Select the Slack channel where you want to use the agent
   • Click the dropdown arrow next to the channel name
   • Click the Integrations tab
   • Click Add an app
   • Select your Automind Agentflow from the list

2. Interact with Bot in Channels

   • Start your message with @<bot name> to ask the bot something
   • This creates a dedicated thread for the conversation
   • Continue the conversation within the thread

Note: Each thread has a unique conversation ID in Automind Agentflow that stores the conversation in the Conversation History.

Features and Capabilities

Your Automind Agentflow in Slack supports:

• Interactive Conversations: Natural language processing for user queries
• File Handling: Upload and download capabilities (with appropriate scopes)
• Automation Workflows: Execute configured automation processes
• Context Awareness: Access to user and channel information
• Rich Responses: Support for buttons, cards, and multimedia content
• Thread Management: Organized conversations in channel threads

Troubleshooting

Common Issues

1. App Installation Fails

   • Verify all required fields are completed in Slack app settings
   • Check that URLs from No-Code Agent are correctly entered
   • Ensure you have appropriate workspace permissions

2. Bot Not Responding

   • Confirm the Slack channel is active and published in Automind Agentflow
   • Verify Event Subscription URL is correctly configured
   • Check that required bot events are subscribed

3. Permission Errors

   • Review OAuth scopes match your agent's requirements
   • Reinstall the app after adding new scopes
   • Verify Bot User OAuth Token is correctly configured

4. Channel Integration Issues

   • Ensure the bot is added to the specific channel
   • Verify channel permissions allow bot interactions
   • Check that required events (member_joined_channel, message.channels) are subscribed

Best Practices

• Scope Management: Only request the OAuth scopes your agent actually needs
• Testing: Thoroughly test in a development workspace before production deployment
• User Guidance: Provide clear instructions on how team members can interact with the agent
• Monitoring: Regularly check the Automind Agentflow logs for any integration issues