Skip to main content

Automated Telegram UserBot session monitoring & recovery with TelePilot

Workflow preview

Workflow preview
100%
Automated Telegram UserBot session monitoring & recovery with TelePilot preview
Open on n8n.io

Important notice

This workflow is provided as-is. Please review and test before using in production.

1. Workflow Overview

Disclaimer: This workflow contains community nodes that are only compatible with the self hosted version of n8n. Important distinction: This template manages Telegram Copi...

Best for

  • DevOps automation workflows
  • advanced n8n builders looking for reusable templates

Tools used

@n8n/n8n-nodes-langchain.chattrigger, n8n-nodes-base.stickynote, n8n-nodes-base.scheduletrigger, @telepilotco/n8n-nodes-telepilot.telepilot, n8n-nodes-base.set, n8n-nodes-base.filter, n8n-nodes-base.telegram

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by IvanCore.

Original n8n.io source

1.1 Workflow description

Title
Automated Telegram UserBot session monitoring & recovery with TelePilot
Workflow name
Automated Telegram UserBot session monitoring & recovery with TelePilot

Disclaimer: This workflow contains community nodes that are only compatible with the self-hosted version of n8n.

Important distinction: This template manages Telegram Copilot's UserBots (client accounts), not Telegram Bots.

UserBot vs. Bot: Key Differences

🔹 Telegram Copilot's UserBots

  • Authenticate as real user accounts (phone number required)
  • Can join groups/channels without "Bot" label
  • Subject to Telegram's client API limits
  • Require manual login (MFA supported)

🔹 Telegram Bots

  • Use @BotFather-created tokens
  • Limited to bot API functionality
  • Can't initiate chats with unbidden users
  • No phone number required This template solves the unique challenges of UserBot management through:

Core Functionality

🛡️ Session Reliability

  • Automatic crash recovery (5-step restart sequence)
  • Persistent session monitoring (checks every 6h)
  • Database cleanup via /clear command

📱 Multi-Device Support

  • Manages sessions independently from mobile clients
  • Tracks active devices via /stat command
  • Isolates session data per credential

đź”” Smart Notifications

  • Real-time alerts to admin chat
  • Detailed error context with authState snapshots
  • Success confirmations with session metadata

Setup Guide

Prerequisites

  • Self-hosted n8n instance (community node required)
  • Valid Telegram account for UserBot
  • Telegram bot token for notifications
  • TelePilot credentials with api_id/api_hash

Configuration Steps

Credential Setup

  • Add TelePilot credentials in n8n
  • Configure Telegram bot token in notification nodes
  • Set admin chat ID for alerts

Monitoring Customization

  • Adjust check frequency in Schedule Trigger
  • Modify alert thresholds in Filter nodes
  • Configure retry logic in recovery sequence

Session Management

  • Test /start command flow
  • Verify /stat output format
  • Confirm notification delivery

Workflow Customization

Advanced Options

  • Add secondary notification channels (Email, Slack)
  • Implement escalating alert system
  • Integrate with monitoring dashboards
  • Customize recovery attempt limits

Compliance Notes

  • UserBots must comply with Telegram's Terms of Service
  • Not intended for bulk messaging or spam
  • Recommended for legitimate automation use cases

Note: UserBots must comply with Telegram ToS. Not for spam/mass messaging.

Why This Matters: UserBots enable automation scenarios impossible with regular bots (e.g., group management as normal user, reacting as human account). This workflow keeps them reliably online 24/7.

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - When chat message received

Type / Role
@n8n/n8n-nodes-langchain.chatTrigger - chatTrigger
Config choices
Version 1.1

Block 2 - Sticky Note

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 3 - Schedule Trigger

Type / Role
n8n-nodes-base.scheduleTrigger - scheduleTrigger
Config choices
Version 1.2

Block 4 - Stop auth

Type / Role
@telepilotco/n8n-nodes-telepilot.telePilot - telePilot
Config choices
Version 1

Block 5 - Start auth

Type / Role
@telepilotco/n8n-nodes-telepilot.telePilot - telePilot
Config choices
Version 1

Block 6 - Sticky Note1

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

Block 7 - Manual control

Type / Role
@telepilotco/n8n-nodes-telepilot.telePilot - telePilot
Config choices
Version 1

Block 8 - Automatic control

Type / Role
@telepilotco/n8n-nodes-telepilot.telePilot - telePilot
Config choices
Version 1

Block 9 - Get Session Status

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 10 - Stop Session

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 11 - Start Session

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 12 - Pass on Closed Status

Type / Role
n8n-nodes-base.filter - filter
Config choices
Version 2.2

Block 13 - Send Closed Status message

Type / Role
n8n-nodes-base.telegram - telegram
Config choices
Version 1.2

Block 14 - Check Session Connection

Type / Role
n8n-nodes-base.filter - filter
Config choices
Version 2.2

Block 15 - Send Session Connection message

Type / Role
n8n-nodes-base.telegram - telegram
Config choices
Version 1.2

Block 16 - Sticky Note2

Type / Role
n8n-nodes-base.stickyNote - stickyNote
Config choices
Version 1

3. Summary Table

Workflow Automated Telegram UserBot session monitoring & recovery with TelePilot
Complexity advanced
Nodes 16
Categories DevOps
Author IvanCore
Published 11 Jul 2025

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/5872/5872.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Automated Telegram UserBot session monitoring & recovery with TelePilot do?

Disclaimer: This workflow contains community nodes that are only compatible with the self hosted version of n8n. Important distinction: This template manages Telegram Copi...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your DevOps use case.