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

If you are looking to create a bot on other platforms using Glitch, check out the Botkit project page.

There are a myriad of methods you can use to set up an application on Slack, here are some of your options:

• Checkout code Read this step-by-step guide .

• Do npm install.

• Ask for .env file or setup from a example file .env.example.

• Run local server npm .. Type something in group and you should see it updated

• Install ngrok and expose your port 3000.

• Update that URL in Event Subscriptions in Request URL. URL will be verified look for that to pass.

• Type something in group with bot and you should see it updated in console logs. You are good to go.

Remix this project on Glitch

Deploy to Heroku

Clone this repository using Git:

git clone https://github.com/howdyai/botkit-starter-slack.git

Install dependencies, including Botkit:

cd botkit-starter-slack
npm install

Once you have setup your Botkit development enviroment, the next thing you will want to do is set up a new Slack application via the Slack developer portal. This is a multi-step process, but only takes a few minutes.

• Read this step-by-step guide to make sure everything is set up.

• We also have this handy video walkthrough for setting up this project with Glitch.

Next, get a Botkit Studio token from your Botkit developer account if you have decided to use Studio.

Update the .env file with your newly acquired tokens.

Launch your bot application by typing:

node .

Now, visit your new bot's login page: http://localhost:3000/login

Now comes the fun part of making your bot!

This starter kit 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.

}

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

By default, the starter kit uses a simple file-system based storage mechanism to record information about the teams and users that interact with the bot. While this is fine for development, or use by a single team, most developers will want to customize the code to use a real database system.

There are Botkit plugins for all the major database systems which can be enabled with just a few lines of code.

We have enabled our Mongo middleware for starters in this project. To use your own Mongo database, just fill out MONGO_URI in your .env file with the appropriate information. For tips on reading and writing to storage, check out these medium posts

You can find full documentation for Botkit on our GitHub page. Botkit Studio users can access the Botkit Studio Knowledge Base for help in managing their account.

• Glitch allows users to ask the community for help directly from the editor! For more information on raising your hand, read this blog post.

• Join our thriving community of Botkit developers and bot enthusiasts at large. Over 4500 members strong, our open Slack group is the place for people interested in the art and science of making bots.

Come to ask questions, share your progress, and commune with your peers!

• We also host a regular meetup and annual conference called TALKABOT. Come meet and learn from other bot developers!

Full video of our 2016 event is available on Youtube.

Botkit is a product of Howdy and made in Austin, TX with the help of a worldwide community of botheads.