karlashi/slack-catbot

Slack bot for the The Cat API

CatBot

Overview

CatBot is a lightweight Sinatra app that provides Slack with a simple bot for fetching individual cat images from The Cat API. Once setup, you can type #cat in your Slack channel and CatBot will post a random gif from The Cat API back to the channel.

CatBot was originally forked from @schuyler's gifbot before I hacked it up and replaced most of the bits with code from Descartes' CAT_MODE handler.

Usage

Preparation

CatBot uses a Slack Outgoing WebHooks integration for catching the #cat request and firing it to your CatBot service. You'll need to add a new Outgoing WebHook first so you'll have the SLACK_TOKEN available for the actual CatBot deployment steps below.

Deployment

Local

$ bundle install
$ export SLACK_TOKEN=...
$ foreman start

Heroku

$ heroku create
$ heroku config:set SLACK_TOKEN=...
$ git push heroku master

WebHook Settings

Once your CatBot application has been deployed you'll need to go back to your Outgoing Webhook page and update the Integration Settings. Generally speaking you'll want to use settings like these (adjust as necessary):

• Channel: Any
• Trigger Word: #cat
• URL: http://slack-catbot-123.herokuapp.com/cat (the /cat endpoint is mandatory)
• Label: catbot

License

CatBot is distributed under the MIT license.