# Setting Up Enterprise Workbot With Slack Enterprise Grid
In this guide, we'll walk you through configuring an existing Slack Enterprise Workbot to work with Slack Enterprise Grid.
Note: Workbot is compatible with Slack Connect, and therefore can be used in shared channels.
# Setup Requirements
To configure Enterprise Workbot for Slack Enterprise Grid, you'll need:
- A Slack Enterprise Grid (opens new window) plan
- An Enterprise Workbot in Workato. Check out the Create an Enterprise Workbot guide to create the bot before proceeding.
- Access to Custom OAuth profiles in Workato.
If you don't see the Workbot or Custom OAuth profiles options in the Tools menu, make sure your Workato workspace or has access to this feature.
# Step 1: Obtain Your Slack App's Application Token
To get started, head to your Slack apps page (opens new window).
Click the app associated with the Workbot.
Navigate to Basic Information > App-Level Tokens and click Generate Token and Scopes.
In the Generate an App-level token modal:
Enter a name for token in the Token Name field.
Click Add Scope and select authorizations:read from the dropdown menu.
Click Generate.
Copy the token. Store the token in a secure location.
# Step 2: Update The Workbot's Custom OAuth profile
In this step, you'll update the Workbot's Custom OAuth profile in Workato with the token you generated in Step 1.
In Workato, navigate to Tools > Custom OAuth profiles.
Click the profile associated with the Enterprise Workbot.
On your bot's Custom OAuth profile page:
Expand Step 2.
In the Application Token field, paste the token you generated in Step 1.
Click Save.
Click Done.
# Step 3: Reconnect Your Enterprise Workbot
Next, you'll re-authorize the connection between your Enterprise Workbot and Slack. This is necessary because the Workbot's OAuth profile was updated with a new token.
In Workato, navigate to Platform > Workbot.
Click the Workbot connection.
On the Workbot's overview page, click Edit connection.
Click Disconnect.
Click Reconnect.
In the authorization window, verify that the app is being installed into the organization and not an individual workspace.
To change the installation location:
Click the dropdown menu in the top right corner of the page.
Select the organization:
Click Allow.
# Step 4: Approve The bot Installation In Slack
NOTE
This step requires Org Admin or Org Owner permissions in Slack.
In this step, you'll approve the app installation to your Slack organization from the Enterprise Grid admin dashboard (opens new window) in Slack.
In the Slack desktop app, click your workspace name in the top left corner of the app.
Select Settings & administration > Organization settings. This will open the admin dashboard in a new page in your browser:
Click Organizations > Apps in the left sidebar.
In the Installed Apps tab, locate your Enterprise Workbot app.
Click the three dots menu to the right of the Enterprise Workbot app.
Click Approve this app.
# Step 5: Add Your Enterprise Workbot To Workspaces
You're almost there! In this last step, you'll add your Enterprise Workbot to Slack workspaces.
Navigate to the Apps page in your Enterprise Grid admin dashboard, if you're not still there.
In the Installed Apps tab, locate your Enterprise Workbot app.
Click the three dots menu to the right of the Enterprise Workbot app, then select Add to more workspaces.
In the window that displays, select the workspace(s) you want to add the Enterprise Bot to. When finished, click Next.
Review the requested permissions for the Enterprise Workbot. When finished, click Next.
Check the I'm ready to add this app box.
Click Add App.
# What's next?
With that, your Enterprise bot is now ready to be used within your Slack Enterprise Grid! You can add the bot in recipes and do things such as:
- Create slash commands, allowing users to command the bot from Slack
- Create command replies, defining how the bot responds to user commands
- Perform a variety of actions such as posting notifications, downloading attachments, and more
Last updated: 2/13/2024, 1:10:22 AM