ChangeTip is a micropayment infrastructure for the web, enabling tips to be sent over social media. This code allows users to tip eachother with slack, using the slack api
This repo is managed by the ChangeCoin (ChangeTip) team, but is open source for transparency and educational purposes. Pull requests welcomed!
Type changetip:
at the beginning of a message, then mention a @username and an amount.
Examples:
changetip: Give @victoria $5 for paying for my lunch
changetip: Give @jim a high five for the great work he just did
In addition to tips, you can also have some fun. Try asking anything.
changetip: what is the answer to everything?
changetip: are you happy?
Before using ChangeTip, you will need to send a message to it so it knows who you are. It's as simple as saying Hi.
changetip: hi!
ChangeTip will respond with instructions on how to hook up your ChangeTip account to slack.
Note: It only works in channels, not private chats, this is because slack doesn't send data for private chats via the webhook.
To enable tipping in slack for your team, 94 seconds of setup is required. LIke this:
Go to https://yourdomain.slack.com/services/new/outgoing-webhook
(replace yourdomain with your slack domain)
Create a new "Outgoing Webhook".
- Leave the Channel to
Any
- Set the Trigger Word to
changetip,@changetip
- Set the URL to
https://bots.changetip.com/slack/command-webhook
Like this:
The descriptive label, name, and icon are up to you. If you'd like, you can use this icon https://cdn.changetip.com/img/logos/changetip_round_icon.png .
Note: it looks like there is a bug with slack where if you try to upload the icon while creating the webhook, you lose your data. Recommend you add the Icon after you save the webhook.
That's it! Start tipping! The bot will provide instructions with what to do. Don't be scared. :)
If you have any questions, or recommendations for new features, we'd like to hear from you - [email protected]
We love pull requests!
Using a python virtualenv is recommended.
This is a django app. It pulls in the changetip python library. To install the dependencies:
$ pip install -r requirements.txt
CHANGETIP_API_KEY=xxxx uwsgi --init uswgi.ini
To get an API key, contact [email protected]
BSD