Quickstart: Slack
Introduction
This guide will walk you through the process of setting up a new Slack app for your Langburp project. We've simplified the setup process by providing a pre-configured app template that includes all the necessary permissions and features.
Setting up a Slack integration is straightforward and typically takes less than 3 minutes. If you run into any issues, please reach out to us at [email protected] or via the chat widget.
Prerequisites
In addition to a Langburp account, all you'll need is a Slack account and access to a Slack workspace where you can install apps.
Step 1: Create a Langburp Project
- If you haven't already, navigate to the Langburp Console
- Create a new Langburp project or select an existing project
Step 2: Open your Project's Slack Integration Page
- In your project sidebar, find the "Integrations" section
- Click on "Setup Slack"
- Click the "Setup your Slack integration" button
Step 3: Create a New Slack App
- On the Slack integration page, you'll see a "Create Slack App from Template" button
- Click this button to open Slack's app creation page in a new tab
- Select the Slack workspace where you want to create the app
- Click "Create" to create your Slack app with our pre-configured settings
Step 4: Copy the App Credentials
After creating the app, you'll need to copy four credentials from Slack to Langburp:
- In the Slack app settings page, "Basic Information," find the "App Credentials" section
- You'll need to copy the following values:
- App ID
- Client ID
- Client Secret (click "Show" to reveal it)
- Signing Secret (click "Show" to reveal it)
- Return to the Langburp Slack integration page
- Paste each credential into the corresponding field in the form
Step 5: Save the Slack Credentials
- Review that all four credential fields are filled in correctly
- Click "Save" to persist the credentials
That's it! Your Slack integration is now configured and ready to use.
Testing your Slack App
You can test your Slack integration in two ways:
From Langburp Console
In the Langburp console, under your new Slack integration tab or on the Connections page, click "Create a test connection" and select Slack.
From Slack
Installing into your own workspace from the Slack app settings will appear to work, but Langburp will not be aware of your installation and will therefore fail to function properly.
If you already installed your app already outside of Langburp, don't worry. All you need to do is follow the instructions above to create a test connection and Langburp will be able to 'adopt' your installation.
Using an Existing Slack App
If you already have a Slack app that you'd like to use with Langburp, you'll need to:
- Ensure your app has the required OAuth scopes and bot token scopes (you can find the list in our template manifest)
- Copy your existing app's credentials (App ID, Client ID, Client Secret, and Signing Secret) into the Langburp credentials form
- Update your app's Event Subscriptions URL to point to the Langburp endpoint (this will be provided after saving your credentials)
- Update your app's OAuth Redirect URLs to include the Langburp callback URL (also provided after saving credentials)
If you're using an existing Slack app, make sure it's not being used by other services before modifying its configuration, as changes could affect existing integrations.