slackbotify

Simple slackbot framework

Usage no npm install needed!

<script type="module">
  import slackbotify from 'https://cdn.skypack.dev/slackbotify';
</script>

README

slackbotify

XO code style npm

Simple slackbot framework

Installation

npm install slackbotify

Usage

Creating a slackbot is as easy require the dependency, load the config and register a handler. Run it. Done. Slackbot is ready!

const Bot = require('slackbotify');

let bot = new Bot({
    "bot": {
        "token": "xoxb-XXXXX-XXXXX",
        "name": "butler"
    }
});

bot.registerHandler({
    groups: ['direct'],
    match: /hi/ig,
    handler: function (message, callback) {
        callback('Hi there! :smiley:');
    }
});

bot.registerHandler({
    groups: ['channel', 'direct'],
    match: /:smile:/ig,
    handler: function (message, callback) {
        callback(':slightly_smiling_face:');
    }
});

bot.run();

Configuration

The only thing you have to pass to the constructor is a config object, and this config object should have at least a bot object with 2 properties: token & name. (example above)

Handlers

To register a handler to the bot simple pass an object to the registerHandler function. This object needs to contain the following properties: group, match, handler.

Group

The group defines where the command is available. There are 3 groups. channel, direct, admin. Handlers which are registered to the 'channel' group will fire when a message is send in a channel where the bot is invited to. 'Direct' handlers are private messages to the bot, and the 'admin' group handlers can only be called by an admin user in a private message.

A handler can be registered to multiple groups. In the example above the first handler is listening to direct messages only. The second handler will be called when a :smile: is send in a private message or in a channel where the bot is in.

Match

The 'match' property is what the message should match in order to get called. This can be a regex or a string.

Handler

The handler is a function which receives as the first argument the slack message object. The result of the matched message is located at message.matchResult this is the parsed result by the .match() function. The second argument is the callback. The response you give to that callback is send to the user, so basically what the bot will answer.

Bots

The current bots are using slackbotify

License

MIT