Note that unless you’re a Lemmy instance admin, this doesn’t have much use to you.
Until this package came along, if you wanted a bot that responds to events, you had to manually traverse all comments/posts/whatever at a fixed interval. With this package you can actually react to events directly from the database. It’s implemented in a very efficient way by connecting the package directly to the Lemmy database and using native Postgres features to get the events (LISTEN/NOTIFY if you want to get technical).
The webhooks themselves are inserted into a separate SQLite database (API is coming) and allow for both simple and complex filtering of the incoming data. The system is already in use by two of my bots, @[email protected] and @[email protected] who now both receive the information about being tagged in a comment in seconds (the actual reply takes a little longer, but that’s because of the nature of the bot).
Currently you can be notified about a post or a comment, other types are trivial to include as well.
Let me know what you think!
Sorry, bad wording. The README of the package should be clearer.
But in short, this package takes care of the low level interaction with the database and you define the webhooks you’re interested in yourself.
So if you want to create a http request every time someone creates a comment with a specific username in the text, you configure it as a webhook in the SQLite database and next time it happens, the URL will be called.
By the api I meant that in the future you’ll be able to manage the webhooks using an api instead of inserting them directly into the db.
Ooooh! Alright. That didn’t come across that way. Github supports graphs (mermaid?). It might help to have there as I might not be the only one misunderstanding.
Cool project! Should probably be part of lemmy itself!
CC BY-NC-SA 4.0