Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build This Bot

I want you to build a bot. This bot. Build this bot.

You want me to what?

Have you ever wanted an automaton to call your own? The intent of this project is to make that dream a reality by guiding you through the ins and outs of bot building on Slack.

But why?

Once upon a time in a galaxy far far away, a team called Tiny Speck built a tool to communicate with each other as they worked. They felt frustrated by the amount of mindless repetitive tasks that slowed down their communication and productivity. As avid consumers of Sci-Fi and generally against things that made them frustrated, the Tiny Speck team built a special user in their messaging app: a digital user or a bot. Instead of forcing the intern to do these mindless tasks, they delegated these responsibilities to their new bot user and integrated the other apps they used into their conversations.

Eventually this communication tool became known as Slack, and their digital user, Slackbot.

Now you too can build a Slack Bot and free up yourself, your fellow coworkers, and even the customers using your products and services, so we can all get back to what we really should be doing; sleep work!

Let's get started πŸŽ‰

First you'll want to clone this project locally. This project is structured with different branches for different stages of the workshop, so you can add your own code and follow along. If you happen to run into a bug or get stuck and we're moving on you can check out the next branch and you won't be left behind. ✊

At each step, feel free to ask questions in the #help channel, or ask your neighbor if they can help! πŸ™Œ

To get started, check out the first branch

git checkout chapter-1

If you'd like to follow along without any of the code, all of the documentation for each chapter is located in the docs folder in the master branch.

Further Reading and Getting Help


Slack Documentation
Documentation for Tools

Where to Find Help

Wondering what to do if you can't get this dang tutorial to work for you? The Slack Developer community is an awesome place to get help when you're confused or stuck. We have an excellent 'search first' culture and Slack is committed to improving our tutorials and documentation based on your feedback. If you've checked the Slack API documentation, reached the end of your google patience and found StackOverflow to be unhelpful, try asking for help in the Bot Developer Hangout Slack team.


I'd love to improve this project, so if you've got some ideas πŸ’‘, feedback πŸ™‹ or praise πŸ’Œ please file an issue, submit a PR or reach out to me through Github or on Twitter!

If you want to keep up with Slack platform updates chat with us on Twitter.


Learn how to build a bot on Slack using Python



Code of conduct





No releases published


No packages published