dn0912 / python-slack-events-api

Slack Events API adapter for Python

Slack Events API adapter for Python

The Slack Events Adapter is a Python-based solution to receive and parse events from Slack’s Events API. This library uses an event emitter framework to allow you to easily process Slack events by simply attaching functions to event listeners.

This adapter enhances and simplifies Slack's Events API by incorporating useful best practices, patterns, and opportunities to abstract out common tasks.

💡 We wrote a blog post which explains how the Events API can help you, why we built these tools, and how you can use them to build production-ready Slack apps.

🤖 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 form Slack's Events API as soon as a user has authorized your app.

🤖 Development workflow:

1. Create a Slack app on https://api.slack.com/apps/
2. Add a bot user for your app
3. Start the example app on your Request URL endpoint
4. Start ngrok and copy the HTTPS URL
5. Add your Request URL and subscribe your app to events
6. Go to your ngrok URL (e.g. https://myapp12.ngrok.com/) and auth your app

🎉 Once your app has been authorized, you will begin receiving Slack Events

⚠️ We strongly discourage using ngrok for anything but development. It’s not well-suited for production use.

🤖 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_VERIFICATION_TOKEN = os.environ["SLACK_VERIFICATION_TOKEN"]

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

from slackeventsapi import SlackEventAdapter

slack_events_adapter = SlackEventAdapter(SLACK_VERIFICATION_TOKEN, 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):
  emoji = event.get("reaction")
  print(emoji)

Start the server on port 3000

slack_events_adapter.start(port=3000)

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

🤖 Examples

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

🤔 Support

Need help? Join Bot Developer Hangout and talk to us in #slack-api.

You can also create an Issue right here on GitHub.