!Telegram GramPro Banner

🚀 Telegram GramPro for n8n

The ultimate MTProto automation engine for n8n. Enterprise-grade security, high-performance userbot triggers, and seamless Telegram integration.

GUIDE.md”>📖 Operations Guide | GUIDE.md”>🔧 Troubleshooting | my.telegram.org

2. Create Session String

Use our built-in authentication operations. For detailed step-by-step instructions, see our Authorization Guide.

3. Configure Credentials

In n8n → Settings → Credentials:

🎯 Comprehensive Operations Guide

For detailed documentation of all operations with parameters, examples, and use cases, see our Operations Guide.

🔧 Available Operations

| Resource | Operations |
| ——————— | ———————————————————————————————————– |
| Auth | Request Login Code, Resend Login Code, Sign in, Request QR Login, Complete QR Login |
| Message | Send Message, Get Chat History, Read Messages History, Edit, Delete, Pin, Forward, Copy, Edit Media, Create Poll, Copy Restricted Content, Clear History, Unpin Message |
| Chat | Get Chat Info, Get Chats List, Join Channel/Group, Leave Channel/Group, Create Group/Channel, Send Chat Action |
| User | Get My Profile, Get Profiles Photo, Update My Profile, Update My Username, Update My Status, Get User Profile (Bio & Common Chats) |
| Media | Download Media Files |
| Channel | Add Member, Remove Member, Ban User, Unban User, Promote to Admin, Get Members |

🛡️ Security Features

Session Encryption

All session strings are automatically encrypted using AES-256-GCM with:

Input Validation

Comprehensive validation ensures data integrity and security:

Enhanced Error Handling

The node handles common Telegram errors gracefully:

⚡ Performance Optimizations

Smart Client Management

Intelligent Rate Limiting

Smart Caching

In-memory caching for frequently accessed data:

Memory Efficient Design

Enhanced Request Handling

🚨 Troubleshooting

For comprehensive troubleshooting guidance, common issues, and solutions, see our Troubleshooting Guide.

Project Structure

n8n-nodes-telegram-grampro/
├── 📄 Root Files
│   ├── .gitignore, .prettierrc.js, eslint.config.mjs
│   ├── LICENSE, README.md
│   ├── package.json, package-lock.json
│   └── tsconfig.json
│
├── 🐙 .github/
│   ├── CODEOFCONDUCT.md, CONTRIBUTING.md, SECURITY.md
│   └── workflows/
│       ├── build.yml
│       └── publish.yml
│
├── 🔐 credentials/
│   ├── TelegramGramProApi.credentials.ts
│   └── telegram-grampro-credentials.svg
│
├── 📚 docs/
│   ├── AUTHORIZATION_GUIDE.md
│   ├── CHANGE_LOG.md
│   ├── OPERATIONS_GUIDE.md
│   └── TROUBLESHOOTING_GUIDE.md
│
└── ⚡ nodes/
    ├── 📦 TelegramGramPro/
    │   ├── TelegramGramPro.node.ts
    │   ├── telegram-grampro.svg
    │   ├── core/
    │   │   ├── cache.ts, clientManager.ts, fileSizeUtils.ts, 
    │   │   ├── floodWaitHandler.ts, logger.ts,  
    │   │   ├── messageFormatting.ts, operationHelpers.ts,
    │   │   ├── payloadBuilders.ts, qrPng.ts, 
    │   │   ├── rateLimiter.ts, sessionEncryption.ts,
    │   │   └── telegramErrorMapper.ts, types.ts, validation.ts
    │   │
    │   └── resources/
    │       ├── authentication.operations.ts
    │       ├── channel.operations.ts
    │       ├── chat.operations.ts
    │       ├── media.operations.ts
    │       ├── message.operations.ts
    │       └── user.operations.ts
    │
    └── 🔔 TelegramGramProTrigger/
        ├── TelegramGramProTrigger.node.ts
        ├── trigger.shared.ts
        └── telegram-grampro.svg

Workflow Examples

Ready-to-import workflow examples are available in docs/Workflows-Examples:

How to Import in n8n

1. Open n8n and create a new workflow.
2. Use the workflow menu and select Import from File.
3. Choose one of the JSON files from docs/Workflows-Examples/.
4. Re-map telegramGramProApi credentials to your own Telegram GramPro credential.
5. Replace placeholders such as source/target chats, admin usernames, and sub-workflow IDs.

Advanced Configuration

Environment Variables

Performance Tuning

Security Best Practices

👥 Contributors

⭐ Star History

Publishing Status


NPM Status


GitHub Status


Dependency Status


📄 License

MIT License – see LICENSE file for details.

🔗 Resources

—