Skip to content
Agile Development tool for Slack. Basically, "Standup Meetings in Slack".
Branch: master
Clone or download
anonrig Merge pull request #21 from anonrig/multiple-question-list
Enable channel specific questions.
Latest commit 27260db Jun 15, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Enable channel specific questions. Jun 14, 2016
src
.editorconfig Initial commit. Dec 19, 2015
.gitignore feat(app): Move config to main directory Dec 19, 2015
.jscsrc Initial commit. Dec 19, 2015
README.md Enable channel specific questions. Jun 14, 2016
package.json Bump version to 0.2.1 Dec 29, 2015

README.md

Agile Development tool for Slack.

Basically, "Standup meetings for Slack"

Slack Manager allows teams to monitor employees on a daily basis. You can start a meeting by inviting your bot to your current channel and just write "start meeting".

Advantages of Slack Manager from other services:

  • Free and easy to use.
  • Configurable mail settings.
  • Configurable questions.
  • Works with multiple channels.

alt text

Create your Slack bot.

  • First make a bot integration inside of your Slack channel. Go here: https://my.slack.com/services/new/bot
  • Enter a name for your bot. Make it something fun and friendly, but avoid a single task specific name. Bots can do lots! Let's not pigeonhole them.
  • When you click "Add Bot Integration", you are taken to a page where you can add additional details about your bot, like an avatar, as well as customize its name & description.

Copy the API token that Slack gives you. You'll need it in the next step.

Installation

Clone the repository by:

git clone https://github.com/anonrig/slack-manager

Install from NPM

npm install slack-manager --save

Create your settings file.

touch config/production.json

Mailer service uses nodemailer's transport methods. Therefore, for better understanding please read nodemailer's available transports .

For example for Gmail settings: change your settings file by:

{
    "token": "YOUR SLACK TOKEN HERE",
    "mailer": {
        "service": "Gmail",
        "email": "email@address.com",
        "pass": "mySuperFancyPassword"
    }
}

Configure your questions

Open default.json and add a questions field shown below.

slack-manager lets users to ask different questions to different channels. If you prefer a single question list then you will only need the default field of the questions object. If you want to ask different questions to different channels then you will need to add additional fields to the questions object. Fields of the questions object must be the names of the corresponding channels.

Note: If no questions that has the same name as the channel found then the default list will be asked.

"questions": {
    "default": [
        "What did you do yesterday?",
        "What are you going to do today?",
        "Did you encounter any problems?"
    ],
    "CHANNEL-NAME": [
        "How do you feel?"
    ],
    "ANOTHER-CHANNEL-NAME": [
        "Another question?",
        "Perhaps more?"
    ]
}

Usage

Install dependencies

npm install

Start your bot.

npm start

Commands

  • start meeting

    Starts meeting. To be able to start meeting with this command your bot should be invited to the channel.

  • skip

    Skips the current user's turn. Asks/Returns to the skipped users again at the end of the meeting. Can be skipped more than once.

  • dismiss

    Dismisses the current user, in other words kicks the current user out of the meeting. Useful in case of an absence.

  • quit

    Ends the meeting. Meeting can be restarted by typing start meeting again.

Tech

Slack-Manager uses a number of open source projects to work properly:

  • Botkit - Botkit - Building Blocks for Building Bots
  • Node-mailer - Send e-mails with Node.JS – easy as cake! E-mail made in Estonia.
  • Lodash - A JavaScript utility library delivering consistency, modularity, performance, & extras.
  • Async - Async utilities for node and the browser.
  • Nconf - Hierarchical node.js configuration with files, environment variables, command-line arguments, and atomic object merging.

Development

Want to contribute? Great! Feel free to submit bugs, and open pull requests.

License

MIT

You can’t perform that action at this time.