From 37056891d444f558225b59f0d26b4b05c5e9828b Mon Sep 17 00:00:00 2001
From: Abdullajonov Bobur <86303222+foxdevuz@users.noreply.github.com>
Date: Wed, 8 Apr 2026 18:22:05 +0500
Subject: [PATCH] feat: Added support to sending message to group topic (#70)

---
 README.md  | 13 +++++++++++++
 action.yml |  2 ++
 2 files changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 8b9b45f..91cc8ac 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,7 @@ Remove `args` to send the default message.
 | format                   | optional. `markdown` or `html`. See [MarkdownV2 style](https://core.telegram.org/bots/api#markdownv2-style)             |
 | message                  | optional. Custom message                                                                                                |
 | message_file             | optional. Overwrite the default message template with the contents of the specified file.                               |
+| message_thread_id        | optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only.             |
 | disable_web_page_preview | optional. Disables link previews for links in this message. Default is `false`.                                         |
 | disable_notification     | optional. Disables notifications for this message, supports sending a message without notification. Default is `false`. |
 
@@ -97,6 +98,18 @@ Send location message:
     venue: '35.661777 139.704051 竹北體育館 新竹縣竹北市'
 ```
 
+Send a message to a specific forum topic (thread):
+
+```yml
+- name: send message to forum topic
+  uses: appleboy/telegram-action@master
+  with:
+    to: ${{ secrets.TELEGRAM_TO }}
+    token: ${{ secrets.TELEGRAM_TOKEN }}
+    message_thread_id: 42
+    message: Hello from GitHub Actions!
+```
+
 Send message using custom proxy (support `http`, `https`, and `socks5`) like `socks5://127.0.0.1:1080` or `http://222.124.154.19:23500`
 
 ```yml
diff --git a/action.yml b/action.yml
index 1f4afe3..30b6397 100644
--- a/action.yml
+++ b/action.yml
@@ -36,6 +36,8 @@ inputs:
     description: 'disables link previews for links in this message'
   disable_notification:
     description: 'disables notifications for this message, supports sending a message without notification,'
+  message_thread_id:
+    description: 'unique identifier for the target message thread (topic) of the forum; for forum supergroups only'
 runs:
   using: 'docker'
   image: 'Dockerfile'