 import os
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError

app = FastAPI()

class ChannelData(BaseModel):
    channel_name: str

# Initialize the Slack client with the token from environment variable
client = WebClient(token=os.environ['SLACK_BOT_TOKEN'])

@app.post("/create_channel")
def create_channel(data: ChannelData):
    try:
        # Integrate with Slack API to create the channel
        response = client.conversations_create(
            name=data.channel_name,
            is_private=False  # Only public channels are allowed
        )
        channel_id = response['channel']['id']
        return {"message": f"Channel created successfully with ID: {channel_id}"}

About this template

An app for Slack integration allowing the creation of public channels using the Slack API. This webhook app requires 'SLACK_BOT_TOKEN' to authenticate with slack api. It also requires channels:manage scope enabled to create channels. Further enchancements to prompts may allow the app to add the user to the channel.

Introduction to the Create Slack Channel Template

Welcome to the Create Slack Channel template! This template is designed to help you integrate a Slack channel creation feature into your application using the Slack API. With this template, you can quickly set up a FastAPI server that responds to requests to create public channels in your Slack workspace. This is particularly useful for automating the process of channel creation as part of your team's workflow or app functionalities.

Getting Started

To begin using this template, simply click on "Start with this Template" in the Lazy builder interface. This will pre-populate the code in the Lazy Builder interface, so you won't need to copy, paste, or delete any code manually.

Initial Setup

Before you can test and use the app, you need to set up an environment secret within the Lazy Builder. This secret is the 'SLACK_BOT_TOKEN', which is necessary for authenticating with the Slack API.

To obtain your 'SLACK_BOT_TOKEN', follow these steps:

Go to the Slack API website and create a new app.
From the 'OAuth & Permissions' page, add the 'channels:manage' scope under Bot Token Scopes.
Install the app to your workspace and copy the Bot User OAuth Access Token provided.

Once you have your token, enter it into the Environment Secrets tab within the Lazy Builder as 'SLACK_BOT_TOKEN'.

Test: Pressing the Test Button

With the environment secret set, you're ready to deploy the app. Press the "Test" button to begin the deployment process. The Lazy CLI will handle the deployment, and you won't need to worry about installing libraries or setting up your environment.

Entering Input

After pressing the "Test" button, if the app requires any user input, the Lazy App's CLI interface will prompt you to provide it. For this template, you will be asked to enter the name of the channel you wish to create.

Using the App

Once the app is deployed, you will be provided with a server link through the Lazy builder CLI. You can use this link to interact with the API. Additionally, since this template uses FastAPI, you will also be provided with a link to the API documentation, which will guide you on how to make requests to your new API endpoint.

To create a Slack channel, you would send a POST request to the '/create_channel' endpoint with the channel name as JSON data. Here's a sample request you might make using a tool like curl:


curl -X POST "http://your-server-link/create_channel" -H "accept: application/json" -H "Content-Type: application/json" -d "{\"channel_name\":\"new-channel-name\"}"

And here's a sample response you would receive if the channel is created successfully:


{
  "message": "Channel created successfully with ID: C1234567890"
}

Integrating the App

After successfully creating a channel, you may want to integrate this functionality into your existing services or frontend. If your application has a UI, you can add a feature where users can input the channel name, and upon submission, a request is made to your FastAPI server to create the channel.

If you need to integrate this server into another tool or service, you would use the server link provided by the Lazy builder CLI. For example, you could set up a webhook that triggers the channel creation process, or you could include this API as part of a larger workflow in your application.

Remember to handle the responses appropriately in your frontend or service, including any errors that might be returned by the Slack API.

That's it! You now have a working integration for creating Slack channels through an API, all set up and ready to go with the help of Lazy.

More templates like this

Basic Slack Bot

This is a simple starting point for a Slack bot it just responds hi to a mention.

AI Query Generator Slack Bot for BigQuery

This app allows users to interact with a Slack bot, ask a question about the data in a table or request the table schema, and then uses the latest ChatGPT to generate a query that is executed on BigQuery to return the results. The app includes a retry mechanism for query generation in case of an error (up to two retries) and provides the LLM with the table info to generate more accurate queries. The table schema is only printed if it is successfully retrieved. All errors from retries are now passed to the LLM. The generated query is printed before the results, and the results are displayed in a pretty table format. The bot uses the Slack API to send and receive messages and parses the user's message to determine the action to take. The bot always responds in a thread to the original message.