slackeventsapi 3.0.3

⚠️ Important Notice

If you use this library for Events API handling, you may need to use threads for stable event acknowledgement. See https://github.com/slackapi/python-slack-events-api/issues/84 for details.

If you’re looking for the best recommended library at this point, check Bolt for Python: https://github.com/slackapi/bolt-python

The framework covers not only Events API but also all the latest Slack Platform features.

🤖 Installation

pip install slackeventsapi

🤖 App Setup

Before you can use the Events API you must create a Slack App, and turn on Event Subscriptions.

💡 When you add the Request URL to your app’s Event Subscription settings, Slack will send a request containing a challenge code to verify that your server is alive. This package handles that URL Verification event for you, so all you need to do is start the example app, start ngrok and configure your URL accordingly.

✅ Once you have your Request URL verified, your app is ready to start receiving Team Events.

🔑 Your server will begin receiving Events from Slack’s Events API as soon as a user has authorized your app.

🤖 Usage

⚠️ Keep your app’s credentials safe!

• For development, keep them in virtualenv variables.

• For production, use a secure data store.

• Never post your app’s credentials to github.

SLACK_SIGNING_SECRET = os.environ["SLACK_SIGNING_SECRET"]

Create a Slack Event Adapter for receiving actions via the Events API

Using the built-in Flask server:

from slackeventsapi import SlackEventAdapter


slack_events_adapter = SlackEventAdapter(SLACK_SIGNING_SECRET, endpoint="/slack/events")


# Create an event listener for "reaction_added" events and print the emoji name
@slack_events_adapter.on("reaction_added")
def reaction_added(event_data):
  emoji = event_data["event"]["reaction"]
  print(emoji)


# Start the server on port 3000
slack_events_adapter.start(port=3000)

Using your existing Flask instance:

from flask import Flask
from slackeventsapi import SlackEventAdapter


# This `app` represents your existing Flask app
app = Flask(__name__)


# An example of one of your Flask app's routes
@app.route("/")
def hello():
  return "Hello there!"


# Bind the Events API route to your existing Flask app by passing the server
# instance as the last param, or with `server=app`.
slack_events_adapter = SlackEventAdapter(SLACK_SIGNING_SECRET, "/slack/events", app)


# Create an event listener for "reaction_added" events and print the emoji name
@slack_events_adapter.on("reaction_added")
def reaction_added(event_data):
  emoji = event_data["event"]["reaction"]
  print(emoji)


# Start the server on port 3000
if __name__ == "__main__":
  app.run(port=3000)

For a comprehensive list of available Slack Events and more information on Scopes, see https://api.slack.com/events-api

🤖 Example event listeners

See example.py for usage examples. This example also utilizes the SlackClient Web API client.

🤔 Support

Need help? Join Slack Community and talk to us in #slack-api.

You can also create an Issue right here on GitHub.