Skip to content

A class (Mattermostable) that can send and receive Mattermost messages, that has a clean and simple speak/listen API.

License

Notifications You must be signed in to change notification settings

rapid-sensemaking-framework/rsf-mattermostable

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rsf-mattermostable

A class that can send and receive mattermost messages, that has a clean and simple speak/listen API.

You will need to set up an account on a particular server that will act as the proxy... then just contact the rsf-runner admin and give them the email address and password for that bot user

Installation

npm install --save rsf-mattermostable

Formatting of id

The id property of a person config should be like the following:

username@https://chat.server.url.org

Associated type configuration

In a person config, use type mattermost to specify a Mattermostable

Mattermostable Person Config Example

{
  "type": "mattermost",
  "id": "philip123@https://chat.server.url.org
}

API

init

init(details): a function used to set the bot details for all the different servers it may use

details: should look like https://chat.server.url.org@@[email protected]@@chatbotpassword@@@...

Mattermostable

constructor(id, name): A Mattermostable is a wrapped version of a bidirectional communication channel between the program, and a person, in which messages of text/strings can be sent and received

id: String, the phone number to reach this person at

name: String, optional, a name of the person being contacted

Instance methods


speak(string): Contact the person represented by the Mattermostable, sending them a message

string: String, the string of text to send the person represented


listen(callback): Handle a message from the person represented by the Mattermostable, received as a simple string

callback(string): Function, give a function which will be called whenever a message from the person is received


stopListening(): Remove all event listeners

About

A class (Mattermostable) that can send and receive Mattermost messages, that has a clean and simple speak/listen API.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published