author | Matthew Wild <mwild1@gmail.com> |
Sat, 15 Oct 2022 19:42:55 +0100 | |
changeset 5075 | bc983da908e6 |
parent 5015 | 55cf7f063af6 |
permissions | -rw-r--r-- |
4572 | 1 |
--- |
2 |
summary: Module for improving the life of bot authors |
|
3 |
--- |
|
4 |
||
5 |
This module makes it easier to write MUC bots by removing the |
|
6 |
requirement that the bot be online and joined to the room. |
|
7 |
||
8 |
All the bot needs to do is send a message and this module handles the |
|
9 |
rest. |
|
10 |
||
11 |
# Configuration |
|
12 |
||
13 |
Example configuration in Prosody: |
|
14 |
||
15 |
```lua |
|
16 |
Component "muc.example.com" "muc" |
|
17 |
||
18 |
modules_enabled = { |
|
19 |
"muc_bot", |
|
20 |
} |
|
21 |
known_bots = { "bot@example.com" } |
|
22 |
bots_get_messages = false |
|
23 |
ignore_bot_errors = true |
|
24 |
``` |
|
25 |
||
26 |
# Sending messages |
|
27 |
||
28 |
Simply send a stanza like this from your bot: |
|
29 |
||
30 |
```xml |
|
31 |
<message type="groupchat" to="channel@muc.example.com"> |
|
32 |
<body>Beep boop, I'm a bot!</body> |
|
33 |
<nick xmlns="http://jabber.org/protocol/nick">Botty</nick> |
|
34 |
</message> |
|
35 |
``` |
|
36 |
||
37 |
## Use with mod_rest |
|
38 |
||
39 |
Using [mod_rest] to interact with MUC suffers from the same need to join |
|
40 |
with an online resource, so this module helps with that as well! |
|
41 |
||
42 |
```bash |
|
43 |
curl https://xmpp.example.com/rest/message/groupchat/room@muc.example.com \ |
|
44 |
-d body="beep boop" \ |
|
45 |
-d nick="Botty" |
|
46 |
``` |
|
47 |
||
4573
9cbdb60e21f2
mod_muc_bot: Add Compatibility section to README
Kim Alvefur <zash@zash.se>
parents:
4572
diff
changeset
|
48 |
# Compatibility |
9cbdb60e21f2
mod_muc_bot: Add Compatibility section to README
Kim Alvefur <zash@zash.se>
parents:
4572
diff
changeset
|
49 |
|
5015
55cf7f063af6
mod_muc_bot/README: Update to account for 0.12 going stable
Kim Alvefur <zash@zash.se>
parents:
4573
diff
changeset
|
50 |
Works with Prosody 0.12 or later. |