Maubot plugin for generating invite tokens via matrix-registration
Go to file
2020-12-22 15:36:58 -08:00
base-config.yaml initial commit 2020-12-08 11:11:02 -08:00
invite.py use in-built aiohttp client instead of requests 2020-12-22 15:36:58 -08:00
LICENSE add readme and license 2020-12-08 11:28:34 -08:00
maubot.yaml use in-built aiohttp client instead of requests 2020-12-22 15:36:58 -08:00
README.md warning about 1.x versions of matrix-reg 2020-12-14 10:27:35 -08:00

this is a simple maubot plugin which interacts with a matrix-registration deployment and generates invite tokens.

###Warning this bot currently only works with matrix-registration versions 0.7.x. Newer implementations (currently in development as of this comment) use different api endpoints and logic, and I haven't written those changes into this code. PRs are welcomed!

modify the config to point to your matrix-registration url, include your admin secret to authenticate, and ensure that you're in the list of approved users.

once your bot is running, simply use the command

!invite generate

to generate a token with some generic text you can copy-paste when sharing it with your invitee!

to check the status of a specific token, use

!invite status MyTokenName

and similarly to list all tokens in the database, use

!invite list

to revoke a token, use

!invite revoke MyTokenName

please note: i haven't made the json output of those responses pretty. sorry not sorry.