Skip to main content

Python Slack Events API adapter

Project description

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.

🤖 Installation

.. code::

pip install slackeventsapi

🤖 App Setup

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

.. _Events API:
.. _create a Slack App:
.. _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 `<>`_
(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. 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.

💡 See the example app included in this repository for more information
on implementing OAuth.

🤖 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.

.. code:: python


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

.. code:: python

slack_events_adapter = SlackEventAdapter(SLACK_VERIFICATION_TOKEN, endpoint="/slack_events")

Create an event listener for "reaction_added" events and print the emoji name

.. code:: python

def reaction_added(event):
emoji = event.get("reaction")

Start the server on port 3000

.. code-block:: python


For a comprehensive list of available Slack `Events` and more information on
`Scopes`, see

🤖 Examples

See ``_ for usage examples. This example also utilizes OAuth and the
SlackClient Web API client.

.. /example/

🤔 Support

Need help? Join `dev4slack`_ and talk to us in `#slack-api`_.

You can also `create an Issue`_ right here on GitHub.

.. _Events API:
.. _create a Slack App:
.. _Event Subscriptions:
.. _dev4slack:
.. _#slack-api:
.. _create an Issue:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

slackeventsapi-1.0.0rc1.tar.gz (3.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page