Skip to main content

Slack Integration

Connect Aisle to your Slack workspace to allow workflow automations to send messages and notificiations and updates directly within Slack. There are two ways to set up the Slack integration:

The easiest way to get started is by adding the official Aisle Slack application to your workspace. This method provides the fastest setup with all necessary permissions preconfigured.

Prerequisites​

  • Admin permissions in your Slack workspace
  • An active Aisle organization

Installation Steps​

  1. Click the Add to Slack button below to begin the installation process:

    Add to Slack

  2. Authorize the application: You'll be redirected to Slack's authorization page. Review the requested permissions and click "Allow" to grant access.

  3. Choose installation scope: Select whether to install the app for your entire workspace or specific channels.

  4. Complete the setup: Once authorized, you'll be redirected back to Aisle where you can configure additional settings for your Slack integration.

You're All Set!​

Congratulations! You've successfully connected Aisle to your Slack workspace. You can now use Slack actions in your workflows to:

  • Send messages to channels and users
  • Notify team members of important events

To start using Slack in your workflows, simply add a Slack action to any workflow and configure the message content and recipients. The integration will handle the rest!

Optional: Configure a Custom Slack Application​

If you need to customize permissions, you can also create your own Slack application. This method requires additional setup but offers greater flexibility.

Prerequisites​

  • Admin permissions in your Slack workspace
  • Access to Slack's App Management dashboard
  • An active Aisle organization

Create a New Slack App​

  1. Go to Slack API: Your Apps
  2. Click "Create New App"
  3. Choose "From scratch"
  4. Enter an app name (e.g., "Aisle Integration")
  5. Select your Slack workspace
  6. Click "Create App"

Configure OAuth & Permissions​

  1. In your app dashboard, navigate to "OAuth & Permissions" in the sidebar
  2. Scroll down to the "Scopes" section
  3. Add the following Bot Token Scopes:
    • chat:write - Send messages as the bot
    • im:history - View messages in direct messages
    • im:read - View basic information about direct messages
    • team:read - View basic information about the workspace
    • users:read - View people in the workspace
    • users:read.email - View email addresses of people in the workspace

Install the App​

  1. Scroll to the top of the "OAuth & Permissions" page
  2. Click "Install to Workspace"
  3. Review the permissions and click "Allow"

Get Your Bot Token​

  1. After installation, you'll see a "Bot User OAuth Token" at the top of the OAuth & Permissions page
  2. Copy this token (it starts with xoxb-)
  3. Keep this token secure - you'll need it to configure the integration in Aisle

Configure in Aisle​

  1. Navigate to your Aisle organization settings
  2. Go to the Integrations section and click Add Credentials
  3. Paste your bot token in the designated field
  4. Complete any additional configuration steps as prompted

Troubleshooting​

Common Issues​

Permission Denied Errors

  • Ensure you have admin permissions in your Slack workspace
  • Verify all required scopes are properly configured

Integration Not Working

  • Check that the bot token is correctly entered in Aisle
  • Ensure the Slack app is installed and active in your workspace

Missing Features

  • Verify that all necessary OAuth scopes are enabled
  • Check that the app has been added to the appropriate channels

Getting Help​

If you encounter issues with either installation method, please contact our support team or check our troubleshooting guides for additional assistance.