slack-quick-bots

KO | EN

gitlite — search

#javascript #python #ai #typescript #go #machine-learning #linux #docker #macos #java #awesome #vue #pytorch #openai

slack-quick-bots

(★ 14)

A slack bot solution for enterprise

slack-quick-bots Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# slack-quick-bots

[![npm version][npm-badge]][npm-url]
[![Build Status][travis-badge]][travis-url]
[![Dependency Status][daviddm-image]][daviddm-url]

Command driven slack bot library focused to quickly rolled out api/data driven bots abstracting most common bot needs.

```javascript
const SlackBot = require('slack-quick-bots');
const coolBot = new SlackBot({
  // all bot schema
});
coolBot.start();
```

## Simple bot

### Step 1

```
git clone https://github.com/usubram/slack-quick-bots-reference.git
npm install && node index.js <botToken> // pass your bot token.
```

### Step 2

```
No more steps. You have successfully started your bot.
```

### Sample reference app

[Sample app](https://github.com/usubram/slack-quick-bots-reference)

### Pagerduty bot

[Pagerduty bot](https://github.com/usubram/pagerdutybot)

## Schema

slack-quick-bots uses handlebars template as view layer for all bot output messages. When `callback` with called with `data` it is rendered against the template. [Templates](https://github.com/usubram/slack-quick-bots/blob/master/sample.hbs) are like html. Data is injected into the template before sent to slack.

```javascript
{
  bot: [{
    botCommand: {
      firstCommand: {
        commandType: 'DATA',
        template: sampleTmpl,
        data: function(input, options, callback) {
          // input.command - for command name.
          // input.params - for params in array.
          // options.user.profile.email - email in slack.
          // options.channel - channel from which the command was fired.
          callback({
            data: 'message to respond for command goes here'
          });
        }
      }
    }
    schedule: true,   // Generic schedule command for all bot command. Example command (schedule firstCommand (* * * * *)) executes firstCommand for every minute.
    botToken: args[0]
  }]
}
```

### Schedule command

`schedule commandName [params] (* * * * *)`

```
schedule firstCommand params1 params2 (* * * * *)
```

## Command type

- [DATA](https://github.com/usubram/slack-quick-bots-reference/blob/master/lib/commands/api.js#L11) - Simple data query.
- [RECURSIVE](https://github.com/usubram/slack-quick-bots-reference/blob/master/lib/commands/repeat.js#L10) - Simple data query bound to a timer.
- [Alert](https://github.com/usubram/slack-quick-bots-reference/blob/master/lib/commands/alert.js#L5) - Run a peak/dip algorithm on a dataset and notifies channels/users bases on the threshold set in realtime.

## [Response type](https://github.com/usubram/slack-quick-bots-reference/blob/master/lib/commands/trend.js#L6)

Library support wide range of response type. You can stream file of any type for a DATA command. The below sample is to generate a graph in realtime. Make sure you have [gnuplot](http://www.gnuplot.info/download.html) for graphs for time series data.

```javascript
responseType: {
  type: 'png',
  ylabel: 'errors',
  xlabel: 'title errors',
  timeUnit: 'm',
  title: 'Log data',
  logscale: false,
  style: 'lines',
  exec: { encoding: 'utf16' }
}
```

## Input validation

```javascript
  validation: [{
    schema: [1, 1],
    default: [1, 1],
    help: [{
      sample: '{firstArg}',
      recommend: '1',
      error: '{{arg}} is incorrect',
    }, {
      sample: '{secondArg}',
      recommend: '1',
      error: '{{arg}} is incorrect',
    }],
  }],
```

### Supports regex

```javascript
  validation: [{
    schema: [/^(?:[1-9]\d?|100)$/, 1],
    default: [1, 1],
    help: [{
      sample: '{firstArg}',
      recommend: '1',
      error: '{{arg}} is incorrect',
    }, {
      sample: '{secondArg}',
      recommend: '1',
      error: '{{arg}} is incorrect',
    }],
  }],
```

## [Custom webhooks](https://github.com/usubram/slack-quick-bots-reference/blob/master/lib/commands/api.js#L32)

Supports setting up custom webhooks. Below schema sets up a http server to serve webhook request. You should also add `webHook: true` at bot level schema to make webhook available for bots. Custom webhook can be used to trigger long running operation and at the completion of the operation the hookUrl can be used to notify the user who triggered the operation.

```javascript
server: {
  host: 'http://custombothostname',
  port: 9090,
  webHook: true
}
```

```javascript
data: function(input, options, callback) {
  // options.hookUrl - http://custombothostname:9090//hook/U2U9RBV8R/69b773b0-a110-47cc-987d-48756d86a5ab.
  callback({
    data: 'message to respond for command goes here'
  });
}
```

## Access control

```javascript
  {
     bot: [{
       botCommand: {
         firstCommand: {
           allowedUsers: ['slackUserId'] // firstCommand work only for slack user with id 'slackUserId'.
         }
       }
     }],
     blockDirectMessage: false, // block direct message to the bot.
  }
```

## Threaded Replies

```javascript
  {
     bot: [{
       botCommand: {
         firstCommand: {
           allowedUsers: ['slackUserId'] // firstCommand work only for slack user with id 'slackUserId'.
         }
       }
     }],
     repliesInThread: true, // All Replies will be in threads instead of channel directly.
  }
```

## Testing bots

```javascript
const onMessageSpy = sinon.spy((response) => {
  setTimeout(() => {
    expect(response.message).to.equal('Hello 1');
    done();
  }, 1);
});

testBots.start().then((botEvt) => {
  botEvt[0].on('connect', () => {
    botEvt[0].injectMessage({
      text: 'ping 1',
      channel: 'D1234567',
    });
  });

botEvt[0].on('message', onMessageSpy);
});
```

## License

[npm-badge]: https://badge.fury.io/js/slack-quick-bots.svg
[npm-url]: https://badge.fury.io/js/slack-quick-bots
[travis-badge]: https://api.travis-ci.org/usubram/slack-quick-bots.svg
[travis-url]: https://travis-ci.org/usubram/slack-quick-bots
[daviddm-image]: https://david-dm.org/usubram/slack-quick-bots.svg
[daviddm-url]: https://david-dm.org/usubram/slack-quick-bots

slack-quick-bots

slack-quick-bots Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

slack-quick-bots

slack-quick-bots Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README