From 164c4d3310b7a71eb0f840fb5193abfb1ffbe35e Mon Sep 17 00:00:00 2001
From: Muhammed Mukhthar CM <mukhtharcm@gmail.com>
Date: Mon, 26 Jan 2026 12:10:24 +0000
Subject: [PATCH] telegram-user: hint filePath/media for sends

---
 extensions/telegram-user/src/channel.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/extensions/telegram-user/src/channel.ts b/extensions/telegram-user/src/channel.ts
index ab545bf24..59d8519a6 100644
--- a/extensions/telegram-user/src/channel.ts
+++ b/extensions/telegram-user/src/channel.ts
@@ -231,6 +231,7 @@ export const telegramUserPlugin: ChannelPlugin<ResolvedTelegramUserAccount> = {
     messageToolHints: () => [
       "Telegram user polls only work in groups/channels (DM polls return MEDIA_INVALID). Use the group id for polls.",
       "When ChatType is group, use currentChannelId as the target for message/poll actions.",
+      "To send files, use `message` action=send with `filePath` (local path) or `media` (URL); put any caption in `message`.",
     ],
   },
   outbound: {