feat(whatsapp): add reply-based activation modes for groups

This commit adds more granular control over group activation with new modes:

- 'replies': Bot only responds when someone replies to one of its messages
- 'mention+replies': Bot responds to @mentions OR replies (most flexible)
- 'never': Bot never responds except for control commands from owners

The existing 'mention' (default) and 'always' modes remain unchanged.

**Implementation details:**
- Added new GroupActivationMode types: 'replies', 'mention+replies', 'never'
- Enhanced group-gating logic to detect replies to bot messages
- Updated all command help messages and documentation
- Reply detection uses both JID and E.164 matching for reliability

**Use cases:**
- 'replies': Reduces noise in busy groups, bot only joins when explicitly engaged
- 'mention+replies': Allows natural conversation flow after initial @mention
- 'never': Temporarily disable bot in a group without removing it

Closes: N/A (feature request)
This commit is contained in:
Rodrigo Gomes da Silva committed 2026-01-29 15:56:02 -03:00
1 parent 4583f88626
commit a4e45a9e05
7 files changed
+30 -10

No files matched your search

+4 -1
View File
@@ -200,7 +200,10 @@ The wizard uses it to set your **allowlist/owner** so your own DMs are permitted
- Activation modes:
- `mention` (default): requires @mention or regex match.
- `always`: always triggers.
- `/activation mention|always` is owner-only and must be sent as a standalone message.
- `replies`: only triggers when someone replies to a bot message.
- `mention+replies`: triggers on @mention/regex match OR replies to bot messages.
- `never`: never triggers (except for control commands from owners).
- `/activation mention|always|replies|mention+replies|never` is owner-only and must be sent as a standalone message.
- Owner = `channels.whatsapp.allowFrom` (or self E.164 if unset).
- **History injection** (pending-only):
- Recent *unprocessed* messages (default 50) inserted under: