doowb / slack-invite-webtask

Webtask.io service to invite users to a slack team.
MIT License
5 stars 2 forks source link

slack-invite-webtask NPM version NPM downloads Build Status

Webtask.io service to invite users to a slack team.

Install

Install with npm:

$ npm install --save slack-invite-webtask

Usage

var invite = require('slack-invite-webtask');
module.exports = function(ctx, req, res) {
  // do any customization for your implementation here
  invite(ctx, req, res);
};

What is this?

This module is intended to be used in a webtask.io task to provide slack invitation functionality.

There is a distribution file provided in dist/main.js if you want to deploy it to webtask.io directly using the following command:

$ wt create node_modules/slack-invite-webtask/dist/main.js --name my-slack-invite-name --secret SLACK_TEAM='my-slack-team' --secret SLACK_TOKEN='XXXXXXX'

The main requirement is to provide the SLACK_TEAM and SLACK_TOKEN values. The above example shows setting them as secrets so they'll be available on the ctx when the webtask is executed.

The SLACK_TEAM property is the same as the subdomain used when accessing slack... https://{slack-team}.slack.com. The SLACK_TOKEN property is the authentication token of an administrator for the specified slack team that can invite people to slack.

Webtask usage

After the webtask has been created, it can be used by POSTing to the webtask url and providing an email property in the body.

<form method="POST" action="https://webtask.it.auth0.com/api/run/wt-{my-profile}-0/my-slack-invite-name?webtask_no_cache=1">
  <div>Email</div>
  <div><input type="text" name="email"></div>
  <div><input type="submit" value="Send"></div>
</form>

A JSON object will be returned. If an error occurs, the JSON object will contain an error property with the corresponding error message. Otherwise, the success message from slack will be returned.

About

Related projects

gulp-bundle-webtask: Gulp plugin for browserifying and bundling your source code before deploying to webtask.io. | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Please read the contributing guide for avice on opening issues, pull requests, and coding standards.

Building docs

(This document was generated by verb-generate-readme (a verb generator), please don't edit the readme directly. Any changes to the readme must be made in .verb.md.)

To generate the readme and API documentation with verb:

$ npm install -g verb verb-generate-readme && verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Brian Woodward

License

Copyright © 2016, Brian Woodward. Released under the MIT license.


This file was generated by verb-generate-readme, v0.1.30, on August 29, 2016.