node package manager
Stop writing boring code. Discover, share, and reuse within your team. Create a free org »



A bot framework for Rocket.Chat, built on bot-commander.


Load the bot like so:

const Bot = require("rocketchat-bot").Bot;
const bot = new Bot({
  server: "",
  username: "botuser",
  password: "botpass"
bot.on("ready", () => {
  bot.loadPlugins(__dirname + "/plugins");

Create a plugins directory, containing your named plugins (e.g. test, droll). Then create a plugin.js file in the directory:

module.exports = bot => {
    .action(meta => {
      bot.send(meta, "Hello, world!");

For more information on the bot object, see the bot-commander documentation.

The WebSocket and REST APIs are exposed via bot.wsAPI and bot.webAPI respectively.