prosody-modules
tip
mod_muc_bot/README.md

Find changesets by keywords by author, files, the commit message, revision number or hash, or revset expression.

Software / code / prosody-modules

Comparison

mod_muc_bot/README.md @ 6211:750d64c47ec6 draft default tip

Merge
author Trần H. Trung <xmpp:trần.h.trung@trung.fun>
date Tue, 18 Mar 2025 00:31:36 +0700
parent 6003:fe081789f7b5
comparison
equal deleted inserted replaced
6210:24316a399978 6211:750d64c47ec6
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
48 # Compatibility
49
50 Works with Prosody 0.12 or later.