Nine Pedestrians Mesmerized

    botkit
    TypeScript icon, indicating that this package has built-in type declarations

    4.10.0 • Public • Published

    Botkit - Building Blocks for Building Bots

    npm David npm Build Status

    Botkit is an open source developer tool for building chat bots, apps and custom integrations for major messaging platforms.

    The information in this document is for the brand new 4.0 branch of Botkit! If you're looking for documentation for previous versions, look here.

    Install Botkit

    The best way to get started locally with Botkit is by installing our Yeoman template, and using it to create a new Botkit project. This will install and configure a starter kit for you!

    npm install -g yo generator-botkit
    yo botkit

    Remix on Glitch

    Want to dive right in? Remix one of our starter kits on Glitch. You'll start with a fully functioning app that you can edit and run from the browser!

    Remix on Glitch

    Build Your Bot

    The goal of Botkit is to make it easier and more fun to build software that talks and works like a robot! Building a bot should feel cool, and not too technically complicated.

    Botkit handles all the nitty gritty details like API calls, session management and authentication, allowing you to focus on building COOL FEATURES for your bot using middleware and event handlers.

    The toolkit is designed to provide meaningful building blocks for creating conversational user interfaces - with functions like hears(), ask(), and reply() that do what they say they do.

    The full documentation for Botkit's capabilities begins here »

    Platform Support

    Botkit can connect to multiple messaging channels through the Microsoft Bot Framework Service. No plugins are necessary to use the Bot Framework service, and bots can be developed locally using the Bot Framework Emulator.

    The Botkit project includes several official adapters. Using these plugins, your bot can communicate directly with the messaging platforms.

    Additional adapters can be found by searching npm for Bot Framework-compatible adapters. The open source community has created a variety of plugins and extensions to Bot Framework. Check out the Bot Builder Community Repo for additional adapters, storage connectors and middlewares.

    Platform specific documentation can be found on the main docs site »

    Hearing Keywords

    Most bots do their thing by listening for keywords, phrases or patterns in messages from users. Botkit has a special event handler called hears() that makes it easy to configure your bot to listen for this type of trigger.

    controller.hears(['string','pattern .*',new RegExp('.*','i')],'message,other_event', async (bot, message) => {
     
      // do something!
      await bot.reply(message, 'I heard a message.')
     
    });

    Read more about hearing things ›

    Responding to Events

    Bots can respond to non-verbal events as well, like when a new user joins a channel, a file gets uploaded, or a button gets clicked. These events are handled using an event handling pattern that should look familiar. Most events in Botkit can be replied to like normal messages.

    controller.on('channel_join', async (bot, message) => {
     
      await bot.reply(message,'Welcome to the channel!');
     
    });

    See a full list of events and more information about handling them ›

    Middleware

    In addition to taking direct action in response to a certain message or type of event, Botkit can also take passive action on messages as they move through the application using middlewares. Middleware functions work by changing messages, adding new fields, firing alternate events, and modifying or overriding the behavior of Botkit's core features.

    Middleware can be used to adjust how Botkit receives, processes, and sends messages.

    // Log every message received
    controller.middleware.receive.use(function(bot, message, next) {
     
      // log it
      console.log('RECEIVED: ', message);
     
      // modify the message
      message.logged = true;
     
      // continue processing the message
      next();
     
    });
     
    // Log every message sent
    controller.middleware.send.use(function(bot, message, next) {
     
      // log it
      console.log('SENT: ', message);
     
      // modify the message
      message.logged = true;
     
      // continue processing the message
      next();
     
    });

    Documentation

    Full documentation of Botkit, including a class reference, can be found on the docs site, as well as on Github.

    Change Log

    Community & Support

    Join our thriving community of Botkit developers and bot enthusiasts at large. Over 10,000 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!

    You can also find help from members of the Botkit team in our dedicated Cisco Spark room!

    About Botkit

    Botkit is a part of the Microsoft Bot Framework.

    Want to contribute? Read the contributor guide

    Botkit is released under the MIT Open Source license

    Install

    npm i botkit

    DownloadsWeekly Downloads

    6,358

    Version

    4.10.0

    License

    MIT

    Unpacked Size

    369 kB

    Total Files

    42

    Last publish

    Collaborators

    • xoxco