Skip to content

Latest commit

 

History

History
40 lines (25 loc) · 1.56 KB

BeepBoop.md

File metadata and controls

40 lines (25 loc) · 1.56 KB

starter-node-bot

Note: This is the original README.md that came with Beep Boop's starter-node-bot with just the License area adjusted to avoid confusion.

Overview

A simple starting point for creating a Beep Boop hostable, Node.js based Slack bot with botkit

Visit Beep Boop to get the scoop on the the Beep Boop hosting platform. The Slack API documentation can be found here.

Assumptions

  • You have already signed up with Beep Boop and have a local fork of this project.
  • You have sufficient rights in your Slack team to configure a bot and generate/access a Slack API token.

Usage

Run locally

npm install
SLACK_TOKEN=<YOUR_SLACK_TOKEN> npm start

Things are looking good if the console prints something like:

** API CALL: https://slack.com/api/rtm.start
** BOT ID:  witty  ...attempting to connect to RTM!
** API CALL: https://slack.com/api/chat.postMessage

Run locally in Docker

docker build -t starter-node .`
docker run --rm -it -e SLACK_TOKEN=<YOUR SLACK API TOKEN> starter-node

Run in BeepBoop

If you have linked your local repo with the Beep Boop service (check here), changes pushed to the remote master branch will automatically deploy.

Acknowledgements

This code uses the botkit npm module by the fine folks at Howdy.ai.

License

NOTE: Original license for BeepBoopHQ starter bot is MIT however hostbot is AGPLv3 to encourage shared contribution.