Package Information
Available Nodes
Documentation generating…
Documentation
n8n-nodes-luch-telegram-topics
An independent community node for creating Telegram forum topics. It reuses n8n's built-in Telegram API credential. It is not affiliated with Telegram or n8n.
Install
In self-hosted n8n, open Settings → Community nodes → Install and enter:
n8n-nodes-luch-telegram-topics@0.1.0
Search for ЛУЧ · Telegram Topics in the node picker. Select an existing Telegram API credential or create one in n8n's credential editor. Never put a bot token into input items.
Operation
Create Forum Topic creates one topic per input item. Supply:
- Chat ID: a Telegram forum supergroup ID in
-100…form. - Topic Name: 1–128 characters after trimming whitespace.
- Icon Color: one of Telegram's six supported colors.
The bot must be an administrator with permission to manage topics. The node always calls the official https://api.telegram.org endpoint; a custom Base URL in the credential is intentionally not used.
Successful output:
{"ok":true,"result":{"message_thread_id":123}}
Failure output:
{"ok":false,"error":{"code":"TG_CREATE_OUTCOME_UNKNOWN","message":"TG_CREATE_OUTCOME_UNKNOWN","outcome":"unknown"}}
Results preserve input item pairing. Failures are output as data: branch on ok and inspect error.outcome before continuing.
Outcomes and retries
| Outcome | Meaning |
|---|---|
not_sent |
Invalid input or unavailable credential; no API request was sent. |
not_created |
Telegram explicitly rejected the request, including access denial or rate limiting. |
unknown |
A timeout, server error or malformed response means the topic may have been created. Reconcile before retrying. |
There are no automatic retries inside the node. Do not enable workflow or node retries blindly. The node does not deduplicate requests or provide exactly-once creation. Durable tracking of created topics and recovery after partial failures belong in the surrounding workflow.
Credential handling
The credential is read only during execution and is not copied into output items. The node returns fixed error codes instead of raw API descriptions, exceptions, stacks or request URLs. Redirects are disabled, TLS validation remains enabled, and the request timeout is 15 seconds. Hosting, proxy and transport logging are outside this node's control and must be configured appropriately.
Compatibility and status
Node.js 20 or later. No third-party runtime dependencies. The node is prepared for n8n 2.48.4 and uses the built-in telegramApi credential and httpRequest helper. Automated tests use mocked HTTP and synthetic credentials. Live installation and Telegram execution have not yet been verified for this first release. This package is an unverified community node.
Development
npm test
npm pack --dry-run
References
License
MIT. See LICENSE.