Give tacos for all the good things your friends say and do on Slack.
It's as simple as writing in Slack:
@Tim 🌮 for being awesome!
@CoffeeShop-- for forgetting my order ;(
TacoCat will keep track of the score everyone (and everything) is sitting on.
Completely open source, so do with it what you like. Or if you don't want to make your own tweaks, deploy it as-is right now with the instructions below. You need somewhere to host it: Heroku is highly recommended because it's free in most cases, and performs super well.
Create a new app in your Slack team.
You can do this from the Slack API Apps page. You'll need permission to add new apps, which depending on your team settings might require an admin to do it for you.
Add a bot user for your app.
This can be done under Bot Users in the menu on the left. You can name it whatever you like, and for best results, select it to always show as online.
This allows the app to speak back to your team when they ++ and -- things.
Add chat permissions, and install the app.
Under OAuth & Permissions, scroll down to Scopes and add the
chat:write:bot permission. Click Save Changes.
You can now install the app. Scroll back up, click Install App to Workspace, and follow the prompts.
Copy your tokens.
From the same OAuth & Permissions page, copy the Bot User OAuth Access Token (not the non-bot token!) and store it somewhere.
Go back to the Basic Information page, scroll down, and copy the Verification Token too.
Deploy the app somewhere.
Heroku is recommended because it's simple and easy, and on most Slack teams this should not cost you a cent.
If you need to sign up first, do so, then come back here and click the Deploy button again.
To increase the free hours available to your account you may need to add a credit card. The hours used by the app will vary depending on the activity on your Slack account, but it won't cost you anything unless you upgrade your plan to support increased scale (or unless you have other Heroku apps using your hours!). The Postgres addon (for storing the scores) is also free for up to 10,000 rows (that's 10,000 unique users or things that your team can ++ or --).
Hosting somewhere other than Heroku is fine too. See Detailed Instructions below.
Back at Slack apps, switch on Event Subscriptions for your app.
Via Event Subscriptions in the left menu. After switching on, enter your new Heroku app address - eg.
https://my-plusplus.herokuapp.com - as the request URL.
Scroll down and, under Subscribe to Bot Events, select the relevant events for the features you want the app to support:
message.channelsto support all general features in public channels it is invited to
message.groupsto support all general features in private channels it is invited to
app_mentionto support extended features such as leaderboards
Finally, click Save Changes. If you wish, you can come back to this screen later and add or change the events the app handles.
Invite your new bot to any channel in your Slack team.
Think of someone who's been awesome lately and send
Further instructions, such as hosting elsewhere, upgrading, etc. are coming soon.
TacoCat will listen out for messages, in channels it has been invited to, for valid commands. Commands are accepted anywhere in a message - at the beginning, middle, or end - and are currently limited to one command per message (if multiple commands are sent, only the first one found will be handled).
Currently supported general commands are:
@Someone 🌮: Adds points to a user or a thing
@Someone--: Subtracts points from a user or a thing
Currently supported extended commands are:
@TacoCat leaderboard: Displays the leaderboard for your Slack workspace
@TacoCat help: Displays a help message showing these commands
If you set a different name for your bot when adding the app to your Slack workspace, use that name instead.
ℹ️ Extended commands are supported if you've subscribed to the
app_mentions event in your Slack app settings. See Step 6 in the installation instructions above for further details.
For full details on contributing, including getting a local environment set up, see CONTRIBUTING.md.
Although it works, it's very basic. Potential enhancements include:
--'ing them (eg.