Back to Catalog

Conversational Telegram bot with GPT-5/GPT-4o for text and voice messages

RoninimousRoninimous
87881 views
2/3/2026
Official Page

This n8n workflow leverages a Telegram Message Trigger to activate an intelligent AI Agent capable of processing both text and voice messages. When a user sends a message in text or in voice format, the workflow captures and transcribes it (if necessary), then passes it to the AI Agent for understanding and response generation.

To enhance user experience, the bot also displays a typing indicator while processing requests, simulating a natural, human-like interaction.

Key Features

  • Multi-Modal Input: Supports both text messages and voice notes from users.
  • Real-Time Interaction: Shows a “typing…” action in Telegram while the AI processes the input.
  • AI Agent Integration: Provides intelligent, context-aware, and conversational responses.
  • Seamless Feedback Loop: Replies are sent directly back to the user within Telegram for smooth interaction.

How It Works

  • The workflow triggers whenever a message or voice note is received on Telegram.
  • If the input is a voice note, the workflow transcribes it into text.
  • The text input is sent to the AI Agent for processing.
  • While processing, the bot sends a typing indicator to the user.
  • Once the AI generates a response, the workflow sends it back to the user in Telegram.

Setup Instructions

  1. Create a Telegram Bot:
    • Use @BotFather to create a bot and obtain your bot token.
  2. Configure n8n Credentials:
    • Add Telegram API credentials in n8n with your bot token.
    • Add credentials for any speech-to-text service used for voice transcription (e.g., Open AI Transcribe A Recording).
  3. Import the Workflow:
    • Import this workflow into your n8n instance.
    • Update all credential nodes to use your Telegram and transcription service credentials.
  4. Set Webhook URLs:
    • Ensure Telegram webhook is set properly for your bot to receive messages.
    • Make sure your n8n instance is publicly accessible for Telegram callbacks.
  5. Test the Workflow:
    • Send text messages and voice notes to your Telegram bot and observe the AI responses.

Customization Guidance

  • Add new message handlers: Extend the workflow to handle additional message types (images, documents, etc.).
  • Improve transcription: Swap or add speech-to-text services for better accuracy or language support.
  • Enhance AI Agent: Customize prompts and context management to tailor the AI’s personality and responses.
  • AI Model Flexibility: Swap between different AI models (e.g., GPT-5, GPT-4, Claude, or custom LLMs) based on task type, cost, or performance preferences. By default, I use GPT-4o in this template. However, you can use the latest GPT-5 model by changing them in OpenAI Chat Model Node. It will show you a list of all the available models to choose.
  • Tool-Based Control: Add custom tools to the AI Agent such as calendar access, Notion, Google Sheets, web search, database queries, or custom APIs—allowing for dynamic, multi-functional agents

Security and Implementation

  • Notes The Telegram node manages message reception and sending but does not directly handle AI processing.
  • Voice transcription requires integration with external APIs; secure those credentials in n8n and monitor usage.
  • To simulate typing, the workflow uses Telegram’s “sendChatAction” API method, providing users with feedback that the bot is processing.
  • Ensure your AI API keys and Telegram tokens are securely stored in n8n credentials and not exposed in workflows or logs.

Benefits

  • Handles natural conversational inputs with text or voice.
  • Provides a smooth, engaging user experience via typing indicators.
  • Easy integration of advanced AI conversational agents with Telegram.
  • Flexible for personal assistants, helpdesks, or interactive chatbots.

Conversational Telegram Bot with GPT-4o for Text and Voice Messages

This n8n workflow creates an intelligent Telegram bot that can respond to both text and voice messages using OpenAI's powerful GPT-4o model. It leverages n8n's Langchain integration to manage conversational context and provide dynamic responses.

What it does

This workflow automates the following steps:

  1. Listens for Telegram Messages: It continuously monitors a Telegram bot for incoming messages.
  2. Determines Message Type: It checks if the incoming message is a text message or a voice message.
  3. Transcribes Voice Messages (if applicable): If a voice message is received, it uses OpenAI's Whisper model (via the OpenAI node) to transcribe the audio into text.
  4. Prepares Message for AI: It sets the chatId and the text of the message, standardizing input for the AI agent.
  5. Engages AI Agent: It feeds the processed text message to an OpenAI Chat Model (GPT-4o) via an AI Agent, which maintains conversational memory.
  6. Sends Response to Telegram: The AI Agent's generated response is then sent back to the user in the Telegram chat.

Prerequisites/Requirements

To use this workflow, you will need:

  • n8n Instance: A running instance of n8n.
  • Telegram Bot Token: A Telegram bot created via BotFather. You will need its API token for the Telegram Trigger and Telegram nodes.
  • OpenAI API Key: An API key from OpenAI with access to GPT-4o and Whisper models. This is required for the OpenAI Chat Model and OpenAI (for transcription) nodes.
  • n8n Langchain Nodes: Ensure you have the @n8n/n8n-nodes-langchain package installed in your n8n instance.

Setup/Usage

  1. Import the Workflow:
    • Download the provided JSON file.
    • In your n8n instance, go to "Workflows" and click "New".
    • Click the "Import from JSON" button and paste the workflow JSON, or upload the file.
  2. Configure Credentials:
    • Telegram Trigger & Telegram Node:
      • Click on the "Telegram Trigger" node and then "New Credential".
      • Enter your Telegram Bot Token.
      • Repeat for the "Telegram" node.
    • OpenAI Chat Model & OpenAI Node:
      • Click on the "OpenAI Chat Model" node and then "New Credential".
      • Enter your OpenAI API Key.
      • Repeat for the "OpenAI" node.
  3. Activate the Workflow:
    • Once all credentials are set, click the "Activate" toggle in the top right corner of the workflow editor to start listening for messages.
  4. Interact with your Bot:
    • Send text or voice messages to your Telegram bot. The workflow will process them and respond using GPT-4o.

Related Templates

Track competitor SEO keywords with Decodo + GPT-4.1-mini + Google Sheets

This workflow automates competitor keyword research using OpenAI LLM and Decodo for intelligent web scraping. Who this is for SEO specialists, content strategists, and growth marketers who want to automate keyword research and competitive intelligence. Marketing analysts managing multiple clients or websites who need consistent SEO tracking without manual data pulls. Agencies or automation engineers using Google Sheets as an SEO data dashboard for keyword monitoring and reporting. What problem this workflow solves Tracking competitor keywords manually is slow and inconsistent. Most SEO tools provide limited API access or lack contextual keyword analysis. This workflow solves that by: Automatically scraping any competitor’s webpage with Decodo. Using OpenAI GPT-4.1-mini to interpret keyword intent, density, and semantic focus. Storing structured keyword insights directly in Google Sheets for ongoing tracking and trend analysis. What this workflow does Trigger — Manually start the workflow or schedule it to run periodically. Input Setup — Define the website URL and target country (e.g., https://dev.to, france). Data Scraping (Decodo) — Fetch competitor web content and metadata. Keyword Analysis (OpenAI GPT-4.1-mini) Extract primary and secondary keywords. Identify focus topics and semantic entities. Generate a keyword density summary and SEO strength score. Recommend optimization and internal linking opportunities. Data Structuring — Clean and convert GPT output into JSON format. Data Storage (Google Sheets) — Append structured keyword data to a Google Sheet for long-term tracking. Setup Prerequisites If you are new to Decode, please signup on this link visit.decodo.com n8n account with workflow editor access Decodo API credentials OpenAI API key Google Sheets account connected via OAuth2 Make sure to install the Decodo Community node. Create a Google Sheet Add columns for: primarykeywords, seostrengthscore, keyworddensity_summary, etc. Share with your n8n Google account. Connect Credentials Add credentials for: Decodo API credentials - You need to register, login and obtain the Basic Authentication Token via Decodo Dashboard OpenAI API (for GPT-4o-mini) Google Sheets OAuth2 Configure Input Fields Edit the “Set Input Fields” node to set your target site and region. Run the Workflow Click Execute Workflow in n8n. View structured results in your connected Google Sheet. How to customize this workflow Track Multiple Competitors → Use a Google Sheet or CSV list of URLs; loop through them using the Split In Batches node. Add Language Detection → Add a Gemini or GPT node before keyword analysis to detect content language and adjust prompts. Enhance the SEO Report → Expand the GPT prompt to include backlink insights, metadata optimization, or readability checks. Integrate Visualization → Connect your Google Sheet to Looker Studio for SEO performance dashboards. Schedule Auto-Runs → Use the Cron Node to run weekly or monthly for competitor keyword refreshes. Summary This workflow automates competitor keyword research using: Decodo for intelligent web scraping OpenAI GPT-4.1-mini for keyword and SEO analysis Google Sheets for live tracking and reporting It’s a complete AI-powered SEO intelligence pipeline ideal for teams that want actionable insights on keyword gaps, optimization opportunities, and content focus trends, without relying on expensive SEO SaaS tools.

Ranjan DailataBy Ranjan Dailata
161

Generate song lyrics and music from text prompts using OpenAI and Fal.ai Minimax

Spark your creativity instantly in any chat—turn a simple prompt like "heartbreak ballad" into original, full-length lyrics and a professional AI-generated music track, all without leaving your conversation. 📋 What This Template Does This chat-triggered workflow harnesses AI to generate detailed, genre-matched song lyrics (at least 600 characters) from user messages, then queues them for music synthesis via Fal.ai's minimax-music model. It polls asynchronously until the track is ready, delivering lyrics and audio URL back in chat. Crafts original, structured lyrics with verses, choruses, and bridges using OpenAI Submits to Fal.ai for melody, instrumentation, and vocals aligned to the style Handles long-running generations with smart looping and status checks Returns complete song package (lyrics + audio link) for seamless sharing 🔧 Prerequisites n8n account (self-hosted or cloud with chat integration enabled) OpenAI account with API access for GPT models Fal.ai account for AI music generation 🔑 Required Credentials OpenAI API Setup Go to platform.openai.com → API keys (sidebar) Click "Create new secret key" → Name it (e.g., "n8n Songwriter") Copy the key and add to n8n as "OpenAI API" credential type Test by sending a simple chat completion request Fal.ai HTTP Header Auth Setup Sign up at fal.ai → Dashboard → API Keys Generate a new API key → Copy it In n8n, create "HTTP Header Auth" credential: Name="Fal.ai", Header Name="Authorization", Header Value="Key [Your API Key]" Test with a simple GET to their queue endpoint (e.g., /status) ⚙️ Configuration Steps Import the workflow JSON into your n8n instance Assign OpenAI API credentials to the "OpenAI Chat Model" node Assign Fal.ai HTTP Header Auth to the "Generate Music Track", "Check Generation Status", and "Fetch Final Result" nodes Activate the workflow—chat trigger will appear in your n8n chat interface Test by messaging: "Create an upbeat pop song about road trips" 🎯 Use Cases Content Creators: YouTubers generating custom jingles for videos on the fly, streamlining production from idea to audio export Educators: Music teachers using chat prompts to create era-specific folk tunes for classroom discussions, fostering interactive learning Gift Personalization: Friends crafting anniversary R&B tracks from shared memories via quick chats, delivering emotional audio surprises Artist Brainstorming: Songwriters prototyping hip-hop beats in real-time during sessions, accelerating collaboration and iteration ⚠️ Troubleshooting Invalid JSON from AI Agent: Ensure the system prompt stresses valid JSON; test the agent standalone with a sample query Music Generation Fails (401/403): Verify Fal.ai API key has minimax-music access; check usage quotas in dashboard Status Polling Loops Indefinitely: Bump wait time to 45-60s for complex tracks; inspect fal.ai queue logs for bottlenecks Lyrics Under 600 Characters: Tweak agent prompt to enforce fuller structures like [V1][C][V2][B][C]; verify output length in executions

Daniel NkenchoBy Daniel Nkencho
601

Automate Dutch Public Procurement Data Collection with TenderNed

TenderNed Public Procurement What This Workflow Does This workflow automates the collection of public procurement data from TenderNed (the official Dutch tender platform). It: Fetches the latest tender publications from the TenderNed API Retrieves detailed information in both XML and JSON formats for each tender Parses and extracts key information like organization names, titles, descriptions, and reference numbers Filters results based on your custom criteria Stores the data in a database for easy querying and analysis Setup Instructions This template comes with sticky notes providing step-by-step instructions in Dutch and various query options you can customize. Prerequisites TenderNed API Access - Register at TenderNed for API credentials Configuration Steps Set up TenderNed credentials: Add HTTP Basic Auth credentials with your TenderNed API username and password Apply these credentials to the three HTTP Request nodes: "Tenderned Publicaties" "Haal XML Details" "Haal JSON Details" Customize filters: Modify the "Filter op ..." node to match your specific requirements Examples: specific organizations, contract values, regions, etc. How It Works Step 1: Trigger The workflow can be triggered either manually for testing or automatically on a daily schedule. Step 2: Fetch Publications Makes an API call to TenderNed to retrieve a list of recent publications (up to 100 per request). Step 3: Process & Split Extracts the tender array from the response and splits it into individual items for processing. Step 4: Fetch Details For each tender, the workflow makes two parallel API calls: XML endpoint - Retrieves the complete tender documentation in XML format JSON endpoint - Fetches metadata including reference numbers and keywords Step 5: Parse & Merge Parses the XML data and merges it with the JSON metadata and batch information into a single data structure. Step 6: Extract Fields Maps the raw API data to clean, structured fields including: Publication ID and date Organization name Tender title and description Reference numbers (kenmerk, TED number) Step 7: Filter Applies your custom filter criteria to focus on relevant tenders only. Step 8: Store Inserts the processed data into your database for storage and future analysis. Customization Tips Modify API Parameters In the "Tenderned Publicaties" node, you can adjust: offset: Starting position for pagination size: Number of results per request (max 100) Add query parameters for date ranges, status filters, etc. Add More Fields Extend the "Splits Alle Velden" node to extract additional fields from the XML/JSON data, such as: Contract value estimates Deadline dates CPV codes (procurement classification) Contact information Integrate Notifications Add a Slack, Email, or Discord node after the filter to get notified about new matching tenders. Incremental Updates Modify the workflow to only fetch new tenders by: Storing the last execution timestamp Adding date filters to the API query Only processing publications newer than the last run Troubleshooting No data returned? Verify your TenderNed API credentials are correct Check that you have setup youre filter proper Need help setting this up or interested in a complete tender analysis solution? Get in touch 🔗 LinkedIn – Wessel Bulte

Wessel BulteBy Wessel Bulte
247