Setting up a Slack Surface
Use a Slack Surface to let people interact with a Product from Slack. It works well for direct messages, mentions, channels, and threaded replies.
Before you begin, create a Product and decide which Capability will handle Slack messages. You will also need access to your Slack workspace so you can create and install a Slack app.
Create the Slack Surface
Open the Product you want to connect to Slack.
Go to Surfaces and click Add Surface.
Select Slack.
Enter a name for the Slack app.
Review the manifest preview and create the app in Slack.
The setup wizard guides you through the Slack app fields Runtype needs to connect the Surface.
Connect the Slack app
In Slack, open the app you created and copy the App ID from Basic Information.
Copy the Signing Secret from the same page.
Return to Runtype and paste both values into the Slack setup wizard.
Install the app to your workspace in Slack.
Copy the Bot User OAuth Token and paste it into Runtype.
Runtype validates the connection and shows the connected workspace when setup is complete.
Choose how the Surface responds
A Slack Surface can receive direct messages, channel messages, mentions, and replies in threads. After the Surface is connected, attach the right Capability so incoming Slack messages route to the Flow or Agent you want to run.
If you have not attached a Capability yet, see Adding Capabilities to a product.
Test the connection
Send a direct message to the Slack app or mention it in a channel where it is available.
Confirm the message reaches your Product.
Check that the response appears in Slack.
If verification succeeds, your Slack Surface is ready to use.
Start with direct messages while you test. Once the response looks right, expand to channels or mention-based workflows.
What’s next
To understand how Surfaces work across Products, read What are Surfaces?. If you are still deciding how to expose your Product, compare this setup with Setting up a chat Surface and Setting up an API Surface.