Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including hubot-rocketchat-announcement with all npm packages installed. Try it out:

var hubotRocketchatAnnouncement = require("hubot-rocketchat-announcement")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

hubot-rocketchat-announcement v0.1.0

A hubot script to make DM announcements to Rocket.Chat users.

hubot-rocketchat-announcement

NPM version

Hubot script to send direct message announcements to Rocket.Chat users.

See src/rocketchat-announcement.coffee for full documentation.

CAUTION

This is a pre-release alpha version, not suitable for production environments.

This package requires rocketchat-bot-helpers package added to Rocket.Chat. That is an experimental package, not published to Meteor and must be manually installed.

Installation

In hubot project repo, run:

npm install hubot-rocketchat-announcement --save

Then add hubot-rocketchat-announcement to your external-scripts.json:

["hubot-rocketchat-announcement"]

Configuration

None at present.

Feature roadmap will introduce ability to configure announcement levels and authentication. At present levels are ALERT, NOTICE, UPDATE, SOCIAL.

Users will be able to reply to ignore future announcements per level, apart from ALERT. Authentication for senders of announcements will allow permissions based on level.

e.g. Only admins can send ALERT, moderators can send NOTICE/UPDATE, users can send SOCIAL.

Sample Interaction

Immediate send

Use announcement level (e.g. ALERT) to send immediately.

user1>> hubot ALERT Don't eat the blue cupcakes!

Sends to all users (including user1)...

hubot>> Don't eat the blue cupcakes!
        ALERT sent by @user1

Dialog send

Use NEW (optionally with level) to start dialog to produce announcements.

This method intended to handle more complicated announcements in roadmap, e.g. scheduling and user group targets.

user1>> hubot NEW
hubot>> @admin OK, I'll create a NOTICE from your next message.
        Reply with the message you'd like to send (or `cancel` within 30 seconds).
user1>> Don't eat the blue cupcakes!

Sends to all users...

hubot>> Don't eat the blue cupcakes!
        NOTICE sent by @user1

With level:

user1>> hubot NEW UPDATE
hubot>> @admin OK, I'll create a NOTICE from your next message.
        Reply with the message you'd like to send (or `cancel` within 30 seconds).
user1>> You may eat the pink cupcakes.

Sends to all users...

hubot>> You may eat the pink cupcakes.
        UPDATE sent by @user1
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free