diff --git a/docs/whatsapp.md b/docs/whatsapp.md
index e7a3c7cb8..91296db6e 100644
--- a/docs/whatsapp.md
+++ b/docs/whatsapp.md
@@ -28,6 +28,7 @@ Status: WhatsApp Web via Baileys only. Gateway owns the single session.
 
 ## Inbound flow (DM + group)
 - WhatsApp events come from `messages.upsert` (Baileys).
+- Inbox listeners are detached on shutdown to avoid accumulating event handlers in tests/restarts.
 - Status/broadcast chats are ignored.
 - Direct chats use E.164; groups use group JID.
 - **Allowlist**: `routing.allowFrom` enforced for direct chats only.