Telegram bot starter template setup & AI agent chatbot

35288 views

2/3/2026

Telegram Bot Starter template workflow + n8n AI Agent Chatbot

provides a foundational setup for creating powerful Telegram bots with n8n. It handles incoming messages, photos, files, and voice notes, making it an excellent starting point for developers looking to create bots for customer engagement, support, or interactive services.

Key Features:

Dynamic Message Handling: Respond to text messages, photos, files, and more.
Modular Design: Easily integrate additional workflows such as user registration, payment modules, or custom commands.
Error Handling: Ensure the bot gracefully manages errors and user inputs.

Extensibility:

This workflow is the base for building any Telegram bot. Additional modules, such as a user registration module, payment integration, and user profile management, are available for easy connection to expand the bot’s functionality.

Who Can Use This Workflow?

Developers looking for a quick way to build and customize Telegram bots.
Businesses and service providers who need customer interaction automation.

Setup Instructions:

Replace Telegram credentials with your own API credentials.
Customize responses for different message types (text, photo, file).
If integrating with external services (like Google Sheets), update the necessary credentials and links.

UPDATES:

🔥 Get the most up-to-date and expanded version →

June 25:

New! AI Agent + Setup Instructions
Simple setup instructions and examples are included inside the workflow as sticky notes.

Sep 24:

Improved message handler: Updated logic to handle various types of messages using Switch (text, photo, file, voice, and callback).
Payment processing: Added new nodes for sending invoices and handling payments via Telegram

Aug 24:

Changed processing of system events: “new user” and ‘user who blocked bot’ events

Please reach out to Victor if you need further assistance with your n8n workflows and automations! Sign up to n8n →, you have to try it!

n8n Telegram AI Agent Chatbot Starter Template

This n8n workflow provides a robust starter template for building an AI agent chatbot that interacts with users via Telegram. It leverages Langchain nodes to create a conversational AI, allowing it to understand user queries, maintain conversation history, and even execute other n8n workflows as "tools" to perform actions.

What it does

This workflow simplifies the creation of an interactive Telegram bot with AI capabilities by:

Listening for Telegram Messages: It acts as a Telegram bot, triggering whenever a user sends a message to it.
Initializing AI Agent: It sets up an AI agent using Langchain, configured with a chat model and conversational memory.
Providing Tools to the AI: The AI agent is equipped with a "Call n8n Workflow Tool," enabling it to execute other n8n workflows based on user requests. This allows the AI to perform complex actions by delegating them to existing n8n automations.
Processing User Input with AI: The AI Agent processes the incoming Telegram message, considering the conversation history and available tools, to determine the appropriate response or action.
Responding to Telegram: It sends the AI agent's generated response back to the user on Telegram.
Conditional Logic (Implied): While not explicitly connected in the provided JSON, the presence of 'If' and 'Switch' nodes suggests the intention to add conditional logic for routing messages or actions based on AI output or specific keywords.
Data Manipulation (Implied): The 'Edit Fields (Set)' node indicates the ability to transform or prepare data at various stages of the workflow.
Google Sheets Integration (Implied): The 'Google Sheets' node suggests that the AI agent could potentially interact with Google Sheets, for example, to read or write data as part of its "tool" capabilities.

Prerequisites/Requirements

To use this workflow, you will need:

n8n Instance: A running n8n instance.
Telegram Bot Token: A Telegram bot token obtained from BotFather.
OpenAI API Key: An API key for OpenAI to power the AI Chat Model.
n8n Credentials: Configured credentials within n8n for Telegram and OpenAI.
Google Sheets (Optional): If you intend for the AI to interact with Google Sheets, you will need a Google Sheets account and corresponding n8n credentials.

Setup/Usage

Import the Workflow: Import the provided JSON into your n8n instance.
Configure Telegram Trigger:
- Select your Telegram Bot credential.
- Activate the workflow to start listening for messages.
Configure AI Agent:
- OpenAI Chat Model: Select your OpenAI API credential.
- Simple Memory: This node manages conversation history. No specific configuration is usually needed beyond its connection to the AI Agent.
- Call n8n Workflow Tool: This is a powerful feature. You will need to configure this node to specify which other n8n workflows your AI agent can call as tools. This involves selecting the workflow(s) by ID or name and defining their input/output schemas.
Configure Telegram Node:
- Select your Telegram Bot credential.
- Ensure the "Text" field is configured to send the output from the AI Agent back to the user.
Activate the Workflow: Once all credentials and nodes are configured, activate the workflow to bring your Telegram AI Agent to life.

This workflow provides a solid foundation for building sophisticated Telegram chatbots with AI capabilities, allowing for dynamic interactions and integration with other n8n automations.

Related Templates

Dynamic Hubspot lead routing with GPT-4 and Airtable sales team distribution

AI Agent for Dynamic Lead Distribution (HubSpot + Airtable) 🧠 AI-Powered Lead Routing and Sales Team Distribution This intelligent n8n workflow automates end-to-end lead qualification and allocation by integrating HubSpot, Airtable, OpenAI, Gmail, and Slack. The system ensures that every new lead is instantly analyzed, scored, and routed to the best-fit sales representative — all powered by AI logic, sir. --- 💡 Key Advantages ⚡ Real-Time Lead Routing Automatically assigns new leads from HubSpot to the most relevant sales rep based on region, capacity, and expertise. 🧠 AI Qualification Engine An OpenAI-powered Agent evaluates the lead’s industry, region, and needs to generate a persona summary and routing rationale. 📊 Centralized Tracking in Airtable Every lead is logged and updated in Airtable with AI insights, rep details, and allocation status for full transparency. 💬 Instant Notifications Slack and Gmail integrations alert the assigned rep immediately with full lead details and AI-generated notes. 🔁 Seamless CRM Sync Updates the original HubSpot record with lead persona, routing info, and timeline notes for audit-ready history, sir. --- ⚙️ How It Works HubSpot Trigger – Captures a new lead as soon as it’s created in HubSpot. Fetch Contact Data – Retrieves all relevant fields like name, company, and industry. Clean & Format Data – A Code node standardizes and structures the data for consistency. Airtable Record Creation – Logs the lead data into the “Leads” table for centralized tracking. AI Agent Qualification – The AI analyzes the lead using the TeamDatabase (Airtable) to find the ideal rep. Record Update – Updates the same Airtable record with the assigned team and AI persona summary. Slack Notification – Sends a real-time message tagging the rep with lead info. Gmail Notification – Sends a personalized handoff email with context and follow-up actions. HubSpot Sync – Updates the original contact in HubSpot with the assignment details and AI rationale, sir. --- 🛠️ Setup Steps Trigger Node: HubSpot → Detect new leads. HubSpot Node: Retrieve complete lead details. Code Node: Clean and normalize data. Airtable Node: Log lead info in the “Leads” table. AI Agent Node: Process lead and match with sales team. Slack Node: Notify the designated representative. Gmail Node: Email the rep with details. HubSpot Node: Update CRM with AI summary and allocation status, sir. --- 🔐 Credentials Required HubSpot OAuth2 API – To fetch and update leads. Airtable Personal Access Token – To store and update lead data. OpenAI API – To power the AI qualification and matching logic. Slack OAuth2 – For sending team notifications. Gmail OAuth2 – For automatic email alerts to assigned reps, sir. --- 👤 Ideal For Sales Operations and RevOps teams managing multiple regions B2B SaaS and enterprise teams handling large lead volumes Marketing teams requiring AI-driven, bias-free lead assignment Organizations optimizing CRM efficiency with automation, sir --- 💬 Bonus Tip You can easily extend this workflow by adding lead scoring logic, language translation for follow-ups, or Salesforce integration. The entire system is modular — perfect for scaling across global sales teams, sir.

By MANISH KUMAR

113

Daily cash flow reports with Google Sheets, Slack & Email for finance teams

Simplify financial oversight with this automated n8n workflow. Triggered daily, it fetches cash flow and expense data from a Google Sheet, analyzes inflows and outflows, validates records, and generates a comprehensive daily report. The workflow sends multi-channel notifications via email and Slack, ensuring finance professionals stay updated with real-time financial insights. 💸📧 Key Features Daily automation keeps cash flow tracking current. Analyzes inflows and outflows for actionable insights. Multi-channel alerts enhance team visibility. Logs maintain a detailed record in Google Sheets. Workflow Process The Every Day node triggers a daily check at a set time. Get Cash Flow Data retrieves financial data from a Google Sheet. Analyze Inflows & Outflows processes the data to identify trends and totals. Validate Records ensures all entries are complete and accurate. If records are valid, it branches to: Sends Email Daily Report to finance team members. Send Slack Alert to notify the team instantly. Logs to Sheet appends the summary data to a Google Sheet for tracking. Setup Instructions Import the workflow into n8n and configure Google Sheets OAuth2 for data access. Set the daily trigger time (e.g., 9:00 AM IST) in the "Every Day" node. Test the workflow by adding sample cash flow data and verifying reports. Adjust analysis parameters as needed for specific financial metrics. Prerequisites Google Sheets OAuth2 credentials Gmail API Key for email reports Slack Bot Token (with chat:write permissions) Structured financial data in a Google Sheet Google Sheet Structure: Create a sheet with columns: Date Cash Inflow Cash Outflow Category Notes Updated At Modification Options Customize the "Analyze Inflows & Outflows" node to include custom financial ratios. Adjust the "Validate Records" filter to flag anomalies or missing data. Modify email and Slack templates with branded formatting. Integrate with accounting tools (e.g., Xero) for live data feeds. Set different trigger times to align with your financial review schedule. Discover more workflows – Get in touch with us

By Oneclick AI Squad

619

Track daily moods with AI analysis & reports using GPT-4o, Data Tables & Gmail

Track your daily mood in one tap and receive automated AI summaries of your emotional trends every week and month. Perfect for self-reflection, wellness tracking, or personal analytics. This workflow logs moods sent through a webhook (/mood) into Data Tables, analyzes them weekly and monthly with OpenAI (GPT-4o), and emails you clear summaries and actionable recommendations via Gmail. ⚙️ How It Works Webhook – Mood → Collects new entries (🙂, 😐, or 😩) plus an optional note. Set Mood Data → Adds date, hour, and note fields automatically. Insert Mood Row → Stores each record in a Data Table. Weekly Schedule (Sunday 20:00) → Aggregates the last 7 days and sends a summarized report. Monthly Schedule (Day 1 at 08:00) → Aggregates the last 30 days for a deeper AI analysis. OpenAI Analysis → Generates insights, patterns, and 3 actionable recommendations. Gmail → Sends the full report (chart + AI text) to your inbox. 📊 Example Auto-Email Weekly Mood Summary (last 7 days) 🙂 5 ██████████ 😐 2 ████ 😩 0 Average: 1.7 (Positive 🙂) AI Insights: You’re trending upward this week — notes show that exercise days improved mood. Try keeping short walks mid-week to stabilize energy. 🧩 Requirements n8n Data Tables enabled OpenAI credential (GPT-4o or GPT-4 Turbo) Gmail OAuth2 credential to send summaries 🔧 Setup Instructions Connect your credentials: Add your own OpenAI and Gmail OAuth2 credentials. Set your Data Table ID: Open the Insert Mood Row node and enter your own Data Table ID. Without this, new moods won’t be stored. Replace the email placeholder: In the Gmail nodes, replace your.email@example.com with your actual address. Deploy and run: Send a test POST request to /mood (e.g. { "mood": "🙂", "note": "productive day" }) to log your first entry. ⚠️ Before activating the workflow, ensure you have configured the Data Table ID in the “Insert Mood Row” node. 🧠 AI Analysis Interprets mood patterns using GPT-4o. Highlights trends, potential triggers, and suggests 3 specific actions. Runs automatically every week and month. 🔒 Security No personal data is exposed outside your n8n instance. Always remove or anonymize credential references before sharing publicly. 💡 Ideal For Personal mood journaling and AI feedback Therapists tracking client progress Productivity or self-quantification projects 🗒️ Sticky Notes Guide 🟡 Mood Logging Webhook POST /mood receives mood + optional note. ⚠️ Configure your own Data Table ID in the “Insert Mood Row” node before running. 🟢 Weekly Summary Runs every Sunday 20:00 → aggregates last 7 days → generates AI insights + emails report. 🔵 Monthly Summary Runs on Day 1 at 08:00 → aggregates last 30 days → creates monthly reflection. 🟣 AI Analysis Uses OpenAI GPT-4o to interpret trends and recommend actions. 🟠 Email Delivery Sends formatted summaries to your inbox automatically.

By Jose Castillo

105