Skip to main content

FAQs

danger

The slackclient PyPI project is in maintenance mode and the slack-sdk project is its successor. The v3 SDK provides additional features such as Socket Mode, OAuth flow, SCIM API, Audit Logs API, better async support, retry handlers, and more.

Why can't I install slackclient?​

We recommend using virtualenv (venv) to set up your Python runtime as follows:

# Create a dedicated virtual env for running your Python scripts
python -m venv env

# Run env\Scripts\activate on Windows OS
source env/bin/activate

# Install slackclient PyPI package
pip install "slackclient>=2.0"

# Set your token as an env variable (`set` command for Windows OS)
export SLACK_API_TOKEN=xoxb-***

Then, verify the following code works on the Python REPL (you can start it using just python):

import os
import logging
from slack import WebClient
logging.basicConfig(level=logging.DEBUG)
client = WebClient(token=os.environ["SLACK_API_TOKEN"])
res = client.api_test()

If you encounter an error saying AttributeError: module 'slack' has no attribute 'WebClient', run pip list. If you find both slackclient and slack in the output, try removing slack by pip uninstall slack and reinstalling slackclient.

Should I go with run_async?​

For most cases, we recommend going with run_async=False mode. So, the default is False.

If your application turns run_async on, the app should follow efficient ways to use asyncio's non-blocking event loops and aiohttp. Also, consider using async frameworks and their appropriate runtime. Running event loops along with Flask or similar may not be a good fit.

If you have to simultaneously run WebClient with run_async=True outside an event loop for some reason, sharing a single WebClient instance doesn't work for you. Create an instance every time you run the code. The run_async=False mode doesn't have such issues.

What if I found a bug?​

That's great! Thank you. Let us know by creating an issue, or if you're feeling particularly ambitious, why not submit a pull request with a bug fix? Check out our contributor's guide here.

What if I have a feature suggestion?​

There's always something more that could be added! Let us know by creating an issue to start a discussion around the proposed feature. If you're feeling particularly ambitious, why not write the feature yourself, and submit a pull request? We love feedback and we also love help from our amazing community of developers!

How do I contribute?​

What an excellent question. First of all, please have a look at our contributor's guide here.

All done? Great! While we're super excited to incorporate your new feature, there are a couple of things we want to make sure you've given thought to:

  • Please include unit tests for your new code. But don't just aim to increase the test coverage, rather, we expect you to have written thoughtful tests that ensure your new feature will continue to work as expected, and to help future contributors to ensure they don't break it!
  • Please document your new feature. Think about concrete use cases for your feature, and add a section to the appropriate document, including a complete sample program that demonstrates your feature.

Including these two items with your pull request will totally make our day - and, more importantly, your future users' days!