From aff0ab4b573e78bbb44e5dfc52b66fdd76c64c77 Mon Sep 17 00:00:00 2001
From: Gustavo Madeira Santana <gumadeiras@gmail.com>
Date: Thu, 12 Mar 2026 09:43:16 +0000
Subject: [PATCH] Docs: document hook group ids

---
 docs/automation/hooks.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/automation/hooks.md b/docs/automation/hooks.md
index deda79d3db5..e801635bc89 100644
--- a/docs/automation/hooks.md
+++ b/docs/automation/hooks.md
@@ -232,6 +232,7 @@ Each event includes:
     to?: string,               // message:sent
     content?: string,
     channelId?: string,
+    groupId?: string,          // message:received/message:sent group correlation
     success?: boolean,         // message:sent
   }
 }
@@ -289,6 +290,7 @@ Message events include rich context about the message:
   channelId: string,      // Channel (e.g., "whatsapp", "telegram", "discord")
   accountId?: string,     // Provider account ID for multi-account setups
   conversationId?: string, // Chat/conversation ID
+  groupId?: string,       // Stable group/channel identifier when applicable
   messageId?: string,     // Message ID from the provider
   metadata?: {            // Additional provider-specific data
     to?: string,
@@ -299,6 +301,7 @@ Message events include rich context about the message:
     senderName?: string,
     senderUsername?: string,
     senderE164?: string,
+    groupId?: string,
   }
 }