Creating a Slack Bot with Python and Events API

steps

1. Create a Slack App

   • Visit the Slack API portal and create a new app.
   • Provide a unique app name and select your Slack workspace.

2. Enable Event Subscriptions

   • Go to the "Event Subscriptions" tab in your app settings.
   • Enable events and specify a Request URL. This URL will handle POST requests sent by the Events API.

3. Expose a Local Flask Server with Ngrok

   • Run Ngrok on the same port as the Flask app (e.g., 5000):
   bashCopy

   ngrok http 5000

   • Use the forwarded Ngrok URL as the Request URL in the Slack app settings.

4. Install Required Python Packages
   Install necessary dependencies:

   pip install flask slackeventsapi

5. Set Up Environment Variables
   Create a .env file in your project directory to securely store your credentials:

   bashCopy

   SLACK_SIGNING_SECRET=<your-signing-secret>
   SLACK_BOT_TOKEN=<your-bot-token>

6. Write the Flask Server Code
   Develop a simple Flask app to receive and handle Slack events:

   pythonCopy

   from flask import Flask, request, jsonify
   from slackeventsapi import SlackEventAdapter
   import os
   from slack_sdk import WebClient
   
   # Load secrets
   slack_signing_secret = os.getenv("SLACK_SIGNING_SECRET")
   slack_bot_token = os.getenv("SLACK_BOT_TOKEN")
   
   app = Flask(__name__)
   slack_event_adapter = SlackEventAdapter(slack_signing_secret, "/slack/events", app)
   client = WebClient(token=slack_bot_token)
   
   @slack_event_adapter.on("message")
   def handle_message(payload):
       event = payload.get("event", {})
       user = event.get("user")
       text = event.get("text")
       channel = event.get("channel")
       
       # Avoid bot responding to its own messages
       if user != None:
           client.chat_postMessage(channel=channel, text=f"You said: {text}")
   
   if __name__ == "__main__":
       app.run(port=5000)

7. Verify and Test

   • Restart your Flask server and Ngrok.
   • Subscribe to the message.channels event in your Slack app settings.
   • Test the bot by sending messages in your Slack channel and observing its responses.