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.

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

1. If you haven't already, navigate to the Langburp Console
2. Create a new Langburp project or select an existing project

Step 2: Open your Project's Slack Integration Page

1. In your project sidebar, find the "Integrations" section
2. Click on "Setup Slack"
3. Click the "Setup your Slack integration" button

Step 3: Create a New Slack App

1. On the Slack integration page, you'll see a "Create Slack App from Template" button
2. Click this button to open Slack's app creation page in a new tab
3. Select the Slack workspace where you want to create the app
4. 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:

1. In the Slack app settings page, "Basic Information," find the "App Credentials" section
2. 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)
3. Return to the Langburp Slack integration page
4. Paste each credential into the corresponding field in the form

Step 5: Save the Slack Credentials

1. Review that all four credential fields are filled in correctly
2. 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:

1. Ensure your app has the required OAuth scopes and bot token scopes (you can find the list in our template manifest)
2. Copy your existing app's credentials (App ID, Client ID, Client Secret, and Signing Secret) into the Langburp credentials form
3. Update your app's Event Subscriptions URL to point to the Langburp endpoint (this will be provided after saving your credentials)
4. Update your app's OAuth Redirect URLs to include the Langburp callback URL (also provided after saving credentials)