1.0.7 • Published 3 years ago
rocketchat-node-framework v1.0.7
RocketChat Bot Framework for Node
A Basic NodeJS RocketChat Bot Framework
About
This library is for constructing basic RocketChat bots using NodeJS. Only bare minimum functionality is included.
Features
- Recieve messages and parse message objects
- Send replies to messages
- Send messages to specific rooms
- Send messages to a specific user
Usage
Install and save with npm:
$ npm i rocketchat-node-framework --save
Example usage
const bot = require("rocketchat-node-framework")
bot.runbot({
HOST: 'rocketchat.server', //server url for rocket
USER: 'botUsername', //login username for bot
PASS: 'botPassword', //login password for bot
SSL: 'false', //specify if using SSL, true = SSL false = no SSL
ROOMS: ['testRoom'], //a list of rooms the bot will join on login
MUSTBEMENTIONED: true, //true = bot must be @ to recieve messages
onMessage: processMessage //define function to deal with messages
})
function processMessage(messageObj, replyTo) {
console.log(messageObj) //output message object to console
replyTo(messageObj, "Hi", options) //send a reply
}
Expected values for replyTo:
messageObj: {
message: contents of message
messageId: the id of the message
time: what time the message was sent, in milliseconds
room: where the message came from
roomid: id of where the message came from
author: username of who sent the message
}
message: "Some string here"
options: {
alias: 'username' Who we are sending the message as, good for bridging
room: 'testRoom' Where to send the message to, defaults to where message was recieved from if not set
dm: 'testUser' pass in username, overrides Room and sends a message to user
}