hubot-slack

This is a Hubot adapter to use with Slack.

Getting Started

Creating a new bot

npm install -g hubot coffee-script yo generator-hubot
mkdir -p /path/to/hubot
cd /path/to/hubot
yo hubot
npm install hubot-slack --save
Initialize git and make your initial commit
Check out the hubot docs for further guidance on how to build your bot

Testing your bot locally

HUBOT_SLACK_TOKEN=xoxb-1234-5678-91011-00e4dd ./bin/hubot --adapter slack

Deploying to Heroku

This is a modified set of instructions based on the instructions on the Hubot wiki.

Follow the instructions above to create a hubot locally
Edit your Procfile and change it to use the slack adapter:
```
  web: bin/hubot --adapter slack
```
Install heroku toolbelt if you haven't already.
heroku create my-company-slackbot
heroku addons:add redistogo:nano
Activate the Hubot service on your "Team Services" page inside Slack.

Add the config variables. For example:

  % heroku config:add HEROKU_URL=http://my-company-slackbot.herokuapp.com
  % heroku config:add HUBOT_SLACK_TOKEN=xoxb-1234-5678-91011-00e4dd

Deploy and start the bot:

  % git push heroku master
  % heroku ps:scale web=1

Profit!

Upgrading from earlier versions of Hubot

Version 3 of the hubot-slack adapter requires different server support to previous versions. If you have an existing "hubot" integration set up you'll need to upgrade:

Go to https://my.slack.com/services/new/hubot and create a new hubot integration
Run npm install hubot-slack --save to update your code.
Test your bot locally using: HUBOT_SLACK_TOKEN=xoxb-1234-5678-91011-00e4dd ./bin/hubot --adapter slack
Update your production startup scripts to pass the new HUBOT_SLACK_TOKEN. You can remove the other HUBOT_SLACK_* environment variables if you want.
Deploy your new hubot to production.
Once you're happy it works, remove the old hubot integration from https://my.slack.com/services

Adapter configuration

This adapter uses the following environment variables:

HUBOT_SLACK_TOKEN - this is the API token for the Slack user you would like to run Hubot under.

tshedor/hubot-slack