This repo is a fork of the Botkit Starter Kit from Howdy. Some changes have been made to focus on running it on Beep Boop.

This repo contains everything you need to get started building a bot with Botkit and Botkit Studio!

Botkit Studio is a set tools that adds capabilities to the open source Botkit library by offering hosted GUI interfaces for script management and action trigger definition. Botkit Studio is built by the company that created and maintains the open source Botkit library, Howdy.

The easiest way to get started is to create a new project on Beep Boop and select this sample repository as your starting point. There you'll be walked through setting up your Slack App and get your own copy of this repository. Once you've set all of that up, you can clone your new repository and make changes locally, then push them to Beep Boop to trigger new builds of your bot. We recommend adding your bot to a team and setting up that team as your development team using Beep Boop's team override feature.

Get a Botkit Studio token from your Botkit developer account and plug that into the settings page of your Beep Boop Project.

Read about how Beep Boop makes developing Slack Apps locally easier.

Install dependencies:

npm install

You'll need to set the following environment variables when running locally (they get set for you automatically when running on Beep Boop). You can save these in a file called env.sh (which is .gitignore'd) and then source that.

export BOTKIT_STUDIO_TOKEN="API Token from Botkit Studio"
export BEEPBOOP_TOKEN="API Token from your Beep Boop Project Settings"
export SLACK_VERIFY_TOKEN="Verify Token from your Slack App"

To start your bot locally, just run:

npm start

...or to have it in watch mode to restart on changes:

npm run watch

Continue your journey to becoming a champion botmaster by reading the Botkit Studio SDK documentation here.

This repo is designed to provide developers a robust starting point for building a custom bot. Included in the code are a set of sample bot "skills" that illustrate various aspects of the Botkit SDK features. Once you are familiar with how Botkit works, you may safely delete all of the files in the skills/ subfolder.

Developers will build custom features as modules that live in the skills/ folder. The main bot application will automatically include any files placed there.

A skill module should be in the format:

module.exports = function(controller) {

    // add event handlers to controller
    // such as hears handlers that match triggers defined in code
    // or controller.studio.before, validate, and after which tie into triggers
    // defined in the Botkit Studio UI.

}