Relax-js

Relax-js is a Node.js client for interacting with Relax – a multitenant message broker for Slack.

There are two primary functions that this client library lets you perform:

1. Spin up new Slack bots on Relax
2. Listen for events generated by Relax

Getting Started

If you're just getting started with Relax and don't already have a Relax Go instance up and running, go ahead and get that set up first by following the instructions here (Don't worry you don't need any prior knowledge of Go). If you use Heroku, there's a "Deploy to Heroku" button to help you get up and running super quickly.

Once you've done that, take note of the following environment variables configured on your Relax Go instance (you'll need to use the exact same ones for your Node.js app):

• REDIS_URL
• RELAX_BOTS_KEY
• RELAX_BOTS_PUBSUB
• RELAX_EVENTS_QUEUE
• RELAX_MUTEX_KEY

If you haven't already, go ahead and create a new Node.js app. Next, install the relax-js node module in either of the following ways:

Install directly with npm:

$ npm install relax-js

or add to your package.json file and then npm install:

"relax-js": "0.0.1"

$ npm install

Usage

Before using this module, make sure your environment variables (the 5 listed above) are set and match the ones used on your Relax Go instance. If they aren't set, Relax-js will throw errors.

Initialize a new Relax-js instance

var Relax = require('relax-js');
// create new relax instance
var relax = new Relax();

Spin up a new bot running on Relax

You can create a new bot for your Slack team here if you haven't already. The Slack API should also be able to provide you with your team's uid, which you will need along with your bot's token in order to spin up a bot on Relax.

relax.createBot(teamUid, botToken);

Listen for bot events from Relax

Here is an example of setting up an event handler for new messages. For information about all events generated by Relax, go here.

// Set up your event listeners
relax.on('message_new', function (data) {
  console.log('Heard new message!', data);

  // data object should look something like this:
  // {
  //   type: 'message_new',
  //   user_uid: 'UXXXXXXXX',
  //   channel_uid: 'DXXXXXXXX',
  //   team_uid: 'TXXXXXXXX',
  //   im: true, // or false
  //   text: 'This is a message',
  //   relax_bot_uid: 'UXXXXXXXX',
  //   timestamp: '1462579994.000021',
  //   provider: 'slack',
  //   event_timestamp: '1462579994.000021',
  //   namespace: '' 
  // }
});

// Start listening for messages
relax.start();

License

MIT