This page contains the setup guide and reference information for the Slack connector.
Prerequisites
Before connecting your Slack account, ensure that:
-
You have an active Slack workspace.
-
You have permission to authorize apps in your workspace.
-
The Keragon app is installed or will be authorized during connection.
Setup Guide
Follow these steps to connect your Slack account to Keragon:
-
Go to app.keragon.com and navigate to the Slack connector setup.
-
Click Connect Account.
-
You will be redirected to the Slack OAuth screen.
-
Log in to your Slack account (if not already logged in).
-
Choose the workspace and authorize Keragon to access it.
-
Upon successful authorization, you'll be redirected back to Keragon, and the Slack connection will be active.
Note: This integration uses OAuth 2.0, so no manual API key setup is required.
How-Tos
What Should I Do if the Keragon App Is Not Invited to a Channel?
If you receive a "Not Invited" error when trying to interact with a Slack channel via Keragon:
-
Identify the Channel
Determine which Slack channel the Keragon app needs access to. -
Open Slack
Navigate to the corresponding channel in your Slack workspace. -
Invite the Keragon App
In the channel message box, type:Then select and add the Keragon app to the channel.
-
Test the Integration
After inviting the app, trigger a test action or message to ensure the integration is functioning as expected.
Without an invitation, the app cannot send or receive messages in the channel.
Troubleshooting and Common Errors
| Error Message | Cause | Suggested Fix |
|---|---|---|
not_in_channel |
Keragon app is not invited to the target channel | Use /apps in the channel to add the Keragon app. |
invalid_auth |
OAuth token expired or revoked | Reconnect your Slack account in Keragon. |
channel_not_found |
Channel name or ID is incorrect | Verify the channel exists and is accessible by the Keragon app. |
missing_scope |
Required scope not granted during OAuth | Reauthorize the app with the necessary permissions. |
Limitations and Notes
-
Slack authentication uses OAuth 2.0, simplifying setup.
-
The Keragon app must be manually invited to private channels.
-
You can only interact with channels where the app has been explicitly invited.