Component Libraries • Project Templates
Docs • Install • Tutorials • Developer Guides • Contribute • Blog • Discord

Xircuits Component Library to interface with Slack! Create Slack Bots in seconds.

Welcome to the xai-slack component library for building Slack bots! This library provides a simple way to create and manage custom Slack components bots in your workspace. In this README, you'll find the steps to set up a Slack application and start using the xai-slack library.

Table of Contents

• Table of Contents
• Prerequisites
• Setting Up a Slack Application
  • Create a Slack App
  • Set up Your App
  • Invite the Bot to a Channel
• Installation
• Getting Started with Xai-Slack
• Try the Examples
  • Message Listener
  • Image Classifier
  • OpenAI Image Generation

Prerequisites

Before you begin, you will need the following:

1. A Slack workspace.
2. Python3.8+.
3. Xircuits.

Setting Up a Slack Application

Create a Slack App

1. Go to the Slack API page and click "Create New App."
2. Choose "From scratch" and provide a name for your app (e.g., "Xai-Slack Bot").
3. Select the workspace where you want the app to be developed.
4. Click "Create App."

Set up Your App

1. Navigate to the OAuth & Permissions on the left sidebar and scroll down to the Bot Token Scopes section. Click Add an OAuth Scope.

2. add the following scopes to your app:

   • app_mentions:read (To read app mentions)
   • channels:history (To read messages in public channels)
   • groups:history (To read messages in private groups)
   • files:read (To read file information)
   • chat:write (To send messages in channels)
   • Note: this scopes are to enable all the components. For selective components usage you can check the required scopes and events subscriptions stated each component documentation.

3. Scroll up to the top of the OAuth & Permissions page and click Install App to Workspace. You’ll be led through Slack’s OAuth UI, where you should allow your app to be installed to your development workspace.

4. Once you authorize the installation, you’ll land on the OAuth & Permissions page and see a Bot User OAuth Access Token save the generated xoxb- token to be used as SLACK_BOT_TOKEN later.

5. Then head over to Basic Information and scroll down under the App Token section and click Generate Token and Scopes to generate an app-level token. Add the connections:write scope to this token and save the generated xapp token to be used as SLACK_APP_TOKEN later.

6. Navigate to Socket Mode on the left side menu and toggle to enable.

7. In your Slack app settings, navigate to "Event Subscriptions" on the left side menu and toggle to enable, scroll down and click Subscribe to bot events.

8. subscribe your app to the following events:

   • app_mention
   • file_shared
   • message.channels
   • message.im
   • Note: this Subscriptions are to enable all the components. For selective components usage you can check the required scopes and events subscriptions stated each component documentation.

9. Create a .env file and add both SLACK_APP_TOKEN and SLACK_BOT_TOKEN, or you can provide these values directly to the components later on.

Invite the Bot to a Channel

1. Log in to your Slack workspace using the web, desktop, or mobile app.
2. Invite the bot to a channel by sending /invite @YourBotName (replace "YourBotName" with the actual name of your bot) as a message in the channel.

Installation

To use this component library, ensure that you have an existing Xircuits setup. You can then install the Slack library using the component library interface, or through the CLI using:

xircuits install slack

You can also do it manually by cloning and installing it.

# base Xircuits directory
git clone https://github.com/XpressAI/xai-slack xai_components/xai_slack
pip install -r xai_components/xai_slack/requirements.txt

Getting Started with Xai-Slack

Now that your Slack app is set up and configured, you can begin using the xai-slack component library to build custom components for your workspace. Please follow the documentation and examples provided in the library to learn how to create, customize, and manage Slack components using xai-slack.

Try the Examples

We have provided several example workflows to help you get started with the xai-slack component library. Give them a try and see how you can create custom Slack components for your workspace.

Message Listener

Check out the msg_trigger.xircuits workflow. This example listens for keywords in conversations and responds when a trigger message is detected.

Image Classifier

Explore the image_prediction.xircuits workflow. In this example, the bot watches for attached images in conversations and responds with the predicted class when a trigger message is detected.

OpenAI Image Generation

Take a look at the slack_openai.xircuits workflow. This example leverages components from the OpenAI Component Library. The bot enables each Slack thread to have unique and contextual image creation and editing using the OpenAI models.

These examples are designed to help you understand how to use the xai-slack component library effectively in your Slack workspace. Enjoy creating and customizing your components!