Current build does not have all Telegram actions implemented and does not work on all n8n installations.
Here is environment compatibility overview:
OS | architecture | supported? |
---|---|---|
docker | x64 | YES |
docker | arm64 | YES |
linux | x64 | YES |
linux | arm64 | YES |
macos | x64 | YES |
macos | arm64 | YES |
windows | x64 | NO |
windows | arm64 | NO |
If you are interested in following our updates and news, check out:
- our telegram channel https://t.me/telepilotco OR
- our website https://telepilot.co
@telepilotco/n8n-nodes-telepilot
is a node for the n8n automation engine that provides the ability to configure your personal Telegram assistant.
It works alongside your main client, allowing you to interact with Telegram servers and see all the messages you can see,
while also enabling your assistant to react to those messages.
With @telepilotco/n8n-nodes-telepilot
, you can enhance your Telegram user experience by automating various actions and responses.
Your personal Telegram CoPilot acts as real-time assistant, providing additional functionalities and making your Telegram usage more efficient.
At TelePilot, we prioritize your privacy. We do not have access to your Telegram messages because you have full control over your personal instance of TelePilot, which runs on your self-hosted n8n instance. The choice of hosting environment is entirely up to you.
Whether you prefer the convenience of cloud hosting or the control of running it on your own machine, TelePilot allows you to make that decision.
Probably the fastest way to get everything up and running would be using Railway n8n template:
If you are technically inclined, you can even launch it on your homelab or Raspberry Pi. For a hassle-free experience, take one of these templates for self-hosting:
- Interact with other users
- Respond to private messages: CoPilot can respond to private messages from other users, allowing for automated answers
- Interact with channels and groups:
- Download messages
- Topic Notification: Stay updated on specific topics of interest by receiving notifications when they are being discussed in Telegram. Configure your personal Telegram assistant to monitor and alert you whenever a particular topic is mentioned.
- Keyword Notification: Never miss important messages by setting up keyword notifications. Define specific words or phrases that you are interested in, and your Telegram assistant will notify you whenever those keywords are posted in any message. Stay informed and engaged with the conversations that matter to you.
- Moderating groups
- Schedule message posting: you can schedule messages using your Telegram CoPilot
- Get more API events: Telepilot can receive API events that normal bots don't know about, such as when a message gets deleted through the client.
To use this package in your n8n project, follow these steps:
- Go to Settings -> Community modules of your self-hosted n8n instance
- Select "Install Community node"
- Specify the name
@telepilotco/n8n-nodes-telepilot
, click checkbox that you understand the risks and click "Install"
To get started install the package in your ~/.n8n/nodes
directory:
npm install @telepilotco/n8n-nodes-telepilot
For Docker-based deployments, add the following line before the font installation command in your n8n Dockerfile:
RUN cd ~/.n8n/ && mkdir nodes && cd nodes && npm install @telepilotco/n8n-nodes-telepilot
- Log in to your Telegram core: https://my.telegram.org with your phone number that you wish to use TelePilot with
- Go to API development tools and fill out the form:
- App title:
telepilot
- Short name:
telepilot
- App title:
- Receive basic addresses as well as the
api_id
andapi_hash
parameters required for user authorization.
Access the credentials UI by opening the left menu and selecting Credentials.
Click on "Add Credential" button and browse for "Personal Telegram CoPilot API".
To initiate connection with Telegram servers, you need to provide following:
-
api_id
: copy-paste it from https://my.telegram.org/apps page -
api_hash
: copy-paste it from https://my.telegram.org/apps page
After you have filled out all fields, click on "Save" and make sure that you see "Connection tested successfully" message.
Once the credentials are set up, you need to log in. This is accomplished by authorizing Telepilot using your Telegram account via a QR code scan.
For more detailed information, please refer to our login guide: https://telepilot.co/login-howto
You can import predefined workflows that we have created for you, check out this page
You can enable DEBUG logs by running n8n with env variables, here is how you do it in cli:
DEBUG=tdl,tdl:client,telepilot-cred,telepilot-node,telepilot-trigger,telepilot-cm N8N_LOG_LEVEL=debug npx n8n
For dockerized setup, make sure you add these env variables to your docker container or docker compose
This package provides various nodes and actions that allow you to interact with Telegram servers and enhance the Telegram user experience. Please refer to the n8n Documentation for detailed information on each node and its usage. May you have any questions, reach out to per email (contact@telepilot.co) or in our Telegram Group
This project is licensed under the CC BY-NC-ND license.