Skylar Sadlier b33595d5eb - matrix-receive node updated so that msg.sender is msg.userId instead (for better node chaining).
- change all references from msg.roomId to msg.topic to conform to Node-RED standards.
- Added node for listing Synapse users server-wide (as long as the caller is an admin)
- Events for Room.timeline are now handled by the server-config node and node's that listen for it bind a listener to that instead of the matrix client.
- Added kick and ban nodes for kicking/banning from a room
- Added node for fetching synapse user list using synapse admin API
- Added node for fetching whois data from a user using Matrix admin API
- Added node for deactivating users using the Synapse admin API
- Can register users using the Synapse admin endpoint v1 (yay legacy)
- Can add users using the Synapse admin endpoint v2
- Add more info to the readme.
2021-08-18 11:18:29 -06:00

1.8 KiB

node-red-contrib-matrix-chat

Matrix chat server client for Node-RED

Currently we are in beta. We ask that you open any issues you have on our repository to help us reach a stable well tested version. Things may change & break before our first release so check changelog before updating.

Features

The following is supported from this package:

  • Receive events from a room (messages, reactions, images, and files)
  • Send Images/Files
  • Send HTML/Plain Text Message/Notice
  • React to messages
  • Register user's on closed registration Synapse servers using registration_shared_secret (Admin Only)
  • List out users on a Synapse server (Admin Only)
  • Get WhoIs info for a Synapse user (Admin Only)
  • Add/Edit Synapse users using the v2 API (requires a pre-existing admin account)
  • Get a user list from a room
  • Kick user from room
  • Ban user from room

Therefore, you can easily build a bot, chat relay, or administrate your Matrix server from within Node-RED.

Installing

You can either install from within Node-RED by searching for node-red-contrib-matrix-chat or run this from within your Node-RED directory:

npm install node-red-contrib-matrix-chat

Examples

We don't have examples just yet but here is a picture of my flow I use for testing this module while creating it (gives you an idea of what is possible and how easy it is to chain things): img.png

Usage

Using this package is very straightforward. Examples coming soon!

Other Packages

Contributing

All contributions are welcome! If you do add a feature please do a pull request so that everyone benefits :) Sharing is caring.