openclaw/src/imessage
juanpablodlc 4a99b9b651
feat(whatsapp): add debounceMs for batching rapid messages (#971)
* feat(whatsapp): add debounceMs for batching rapid messages

Add a `debounceMs` configuration option to WhatsApp channel settings
that batches rapid consecutive messages from the same sender into a
single response. This prevents triggering separate agent runs for
each message when a user sends multiple short messages in quick
succession (e.g., "Hey!", "how are you?", "I was wondering...").

Changes:
- Add `debounceMs` config to WhatsAppConfig and WhatsAppAccountConfig
- Implement message buffering in `monitorWebInbox` with:
  - Map-based buffer keyed by sender (DM) or chat ID (groups)
  - Debounce timer that resets on each new message
  - Message combination with newline separator
  - Single message optimization (no modification if only one message)
- Wire `debounceMs` through account resolution and monitor tuning
- Add UI hints and schema documentation

Usage example:
{
  "channels": {
    "whatsapp": {
      "debounceMs": 5000  // 5 second window
    }
  }
}

Default behavior: `debounceMs: 0` (disabled by default)

Verified: All existing tests pass (3204 tests), TypeScript compilation
succeeds with no errors.

Implemented with assistance from AI coding tools.

Closes #967

* chore: wip inbound debounce

* fix: debounce inbound messages across channels (#971) (thanks @juanpablodlc)

---------

Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-01-15 23:07:19 +00:00
..
monitor feat(whatsapp): add debounceMs for batching rapid messages (#971) 2026-01-15 23:07:19 +00:00
accounts.ts chore: migrate to oxlint and oxfmt 2026-01-14 15:02:19 +00:00
client.ts fix: imessage dm replies and error details (#935) 2026-01-15 08:05:10 +00:00
index.ts feat: add imessage rpc adapter 2026-01-02 01:19:40 +01:00
monitor.skips-group-messages-without-mention-by-default.test.ts chore: migrate to oxlint and oxfmt 2026-01-14 15:02:19 +00:00
monitor.ts refactor(src): split oversized modules 2026-01-14 01:17:56 +00:00
monitor.updates-last-route-chat-id-direct-messages.test.ts fix: imessage dm replies and error details (#935) 2026-01-15 08:05:10 +00:00
probe.ts refactor!: rename chat providers to channels 2026-01-13 08:40:39 +00:00
send.test.ts chore: migrate to oxlint and oxfmt 2026-01-14 15:02:19 +00:00
send.ts chore: migrate to oxlint and oxfmt 2026-01-14 15:02:19 +00:00
targets.test.ts chore: migrate to oxlint and oxfmt 2026-01-14 15:02:19 +00:00
targets.ts chore: migrate to oxlint and oxfmt 2026-01-14 15:02:19 +00:00