mod_http_xep227: Add support for import via APIs rather than direct store manipulation
In particular this transitions PEP nodes and data to be imported via mod_pep's
APIs, fixing issues with importing at runtime while PEP data may already be
live in RAM.
Next obvious candidate for this approach is rosters, so clients get immediate
roster pushes and other special handling (such as emitting subscribes to reach
the desired subscription state).
---
summary: Module for improving the life of bot authors
---
This module makes it easier to write MUC bots by removing the
requirement that the bot be online and joined to the room.
All the bot needs to do is send a message and this module handles the
rest.
# Configuration
Example configuration in Prosody:
```lua
Component "muc.example.com" "muc"
modules_enabled = {
"muc_bot",
}
known_bots = { "bot@example.com" }
bots_get_messages = false
ignore_bot_errors = true
```
# Sending messages
Simply send a stanza like this from your bot:
```xml
<message type="groupchat" to="channel@muc.example.com">
<body>Beep boop, I'm a bot!</body>
<nick xmlns="http://jabber.org/protocol/nick">Botty</nick>
</message>
```
## Use with mod_rest
Using [mod_rest] to interact with MUC suffers from the same need to join
with an online resource, so this module helps with that as well!
```bash
curl https://xmpp.example.com/rest/message/groupchat/room@muc.example.com \
-d body="beep boop" \
-d nick="Botty"
```
# Compatibility
Prosody **trunk** required.