Telepilot: Telegram Userbot Node (tdlib/td, mtproto-based)

Built with n8n
, , , ,
1

For those of you who are interested in Telegram Userbots:
We have published new 0.3.0 version of Telepilot - n8n node for creating workflows with Telegram in Userbot mode, based on tdlib/td: @telepilotco/n8n-nodes-telepilot - npm
Telepilot node includes precompiled binaries for multiple architectures/libc environments that handle low-level protocol. Source codes of all components and building toolchain is available in our github organization: TelePilot · GitHub

New 0.3.0 package delivers improved Telegram login process, that can be performed using ChatTrigger node, used in AI workflows.
Here is how you can set it up: How to Login using Phone Number and Authentication Code
Previously, only QR-Code login was supported which was often buggy and error-prone.
Looking forward to hear your feedback or answer your questions!

3 Likes
2

telegram-cloud-photo-size-4-5920003554838430472-m

3

Hello @fuzhangjiang8 ,

This could happen if you are running n8n in custom/old/new docker image. tdlib that is used in the node was build for specific glibc.
Could you please share following details to help me understand the issue?

  • Which n8n-nodes-telepilot version is installed?
  • How are you running n8n (docker or npm/npx run in linux)?
  • If docker, which docker image are you using?
  • if you are building docker image by yourself, please share Dockerfile or at least share your base image and packages that you are installing with apt/yum/apk
  • if you are running in linux without docker, please share your distro and version

Looking forward to your reply!

4

Hello.

I want to create some bot for resizing video. Because stantard tg bot has limit for file, I panning use Telepilot Userbot. Now I know how to download large file, execute ffmpeg command to resize file. But how to send back new resized file? I did not find any node for this.

5

Hey @pamir75 , inputMessageVideo is not yet available in latest Telepilot version, we will add it soon!

Thank you!

6

Just posting an update for anyone using Telepilot with n8n. Versions 0.5.0 and 0.5.1 have been released with several improvements and new features based on community input and contributions, incorporated from two forks. Thanks to everyone who submitted issues or pull requests.

In 0.5.0, a new “Custom Request” node was added. This allows users to send raw TDLib JSON directly, which is useful for advanced or less-common Telegram API calls that aren’t covered by predefined nodes. Message-sending capabilities have been expanded to support sendMessageAudio, sendMessageVideo, and sendMessageFile, enabling more complete handling of Telegram media. @pamir75 you should now be able to implement your Video resizing use-case with Telepilot.

The main node now supports a continueOnFail option, which is useful in workflows that involve multiple actions and need to proceed even if one fails. For triggers, there’s now an option to ignore group events, which helps avoid unnecessary executions when working with bots in group chats.

The getChatHistory node has been updated with a limit parameter. Without fromMessageId, this node previously returned only 1-2 messages. With the update, users can retrieve up to 100 messages, offering more control when fetching message history.

Telepilot has also been re-licensed under the MIT license to make it easier for developers to contribute and integrate with other projects.

Version 0.5.1 focuses on message linking and threaded conversations. It introduces two new actions: getMessageLinkInfo, which fetches metadata for a given Telegram message link (public or private), and getMessageLink, which generates a shareable link to a specific message. Additionally, all sendMessage* nodes now support the message_thread_id parameter. This enables Userbots and workflows to post replies directly into specific threads or topics, improving integration with Telegram’s supergroup forum features.

Repository and documentation are available at:
GitHub: GitHub - telepilotco/n8n-nodes-telepilot
Install guide: ⚙️ How to install and configure TelePilot as n8n plugin
Community feedback and support: Telegram: View @telepilotco_group

Let me know if you run into any edge cases or issues—always open to suggestions and contributions.

7

I have wrote in telegram:

When I use Send Message with Video, width, height and duration is not real - 320, 320, 0.

“duration”:
0,
“width”:
320,
“height”:
320,

But really 1280x720 and 220.
Therefore I get strange message in telegram (see screenshot)

I have reinstalled 0.5.1 (uninstall 0.5.0, reboot n8n and install 0.5.1) and I have same sttange size and duration

photo_2025-05-01_23-31-47
photo_2025-05-01_23-31-47956×817 25 KB

8

Hey @pamir75 ,

We have added additional parameters to sendMessageVideo action in recent 0.5.2 release.
You can give it a try! You should be able to set now width, height of the video and thumbnail as well as toggle whether video should be streamable directly in Telegram without being downloaded first.

9

Yes, I have installed 0.5.2. and everything is successful

10

This is so underrated!

It’s only a matter of time before people figure it out…

Thanks so much…

2 Likes
11

I have official docker image hosted via Railway (n8nio/n8n:latest).
Getting this error on login:

image
image505×116 7.38 KB

12

Same error with image: docker.n8n.io/n8nio/n8n. Did you solve this problem?

13

Same error with docker image: n8nio/n8n