From 35492f8513fa01d277d6a93f751aa8bdb8ac7720 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 15 Jan 2026 23:20:07 +0000
Subject: [PATCH] docs: add inbound debounce config example

---
 docs/concepts/messages.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/concepts/messages.md b/docs/concepts/messages.md
index 7045c915d..37e487987 100644
--- a/docs/concepts/messages.md
+++ b/docs/concepts/messages.md
@@ -39,6 +39,22 @@ Rapid consecutive messages from the **same sender** can be batched into a single
 agent turn via `messages.inbound`. Debouncing is scoped per channel + conversation
 and uses the most recent message for reply threading/IDs.
 
+Config (global default + per-channel overrides):
+```json5
+{
+  messages: {
+    inbound: {
+      debounceMs: 2000,
+      byChannel: {
+        whatsapp: 5000,
+        slack: 1500,
+        discord: 1500
+      }
+    }
+  }
+}
+```
+
 Notes:
 - Debounce applies to **text-only** messages; media/attachments flush immediately.
 - Control commands bypass debouncing so they remain standalone.