AI-powered Telegram assistant built with n8n using modular AI agents, external tools, search orchestration, observability logging, and safety-controlled actions.
- Telegram AI assistant with conversational interface
- Modular subworkflow architecture
- AI-powered web search orchestration
- Wikipedia integration
- Hacker News integration
- SerpAPI live web search
- Voice transcription pipeline
- Google Sheets observability logging
- Email safety confirmation workflow
- Calendar integration
- Contact retrieval/storage support
- X/Twitter posting workflow support
- Memory-enabled conversations
- Human-readable AI summarization
- Safe tool orchestration design
File:
workflows/Telegram_AI_Assistant_Pro.json
- Telegram message intake
- Voice vs text routing
- Input normalization
- AI orchestration
- Tool routing
- Logging and observability
- Telegram response delivery
File:
workflows/TAAP_Search_Agent.json
- Web search orchestration
- Multi-source retrieval
- News summarization
- Search result formatting
- Human-readable responses
Shows the full orchestration architecture of the Telegram AI assistant.
Example of live AI-powered news retrieval using the Search Agent.
Example of controlled email safety behavior requiring recipient verification and confirmation before sending.
Execution logging architecture used for observability and debugging.
Dedicated modular AI search orchestration workflow.
The assistant includes controlled behaviors for sensitive actions.
The assistant never sends emails immediately.
Before sending emails:
- Verifies recipient information
- Requests missing email addresses
- Drafts the email first
- Shows the draft to the user
- Requires explicit confirmation
- Sends only after approval
The assistant uses specialized tools depending on the task:
| Task | Tool |
|---|---|
| Live news | Search Agent |
| Weather | Search Agent |
| Web search | Search Agent |
| Calendar management | Calendar Tool |
| Contacts | Contact Agent |
| Email drafting | Email Agent |
| Social posting | X Posts Tool |
The workflow includes execution logging using Google Sheets.
Logged data includes:
- Timestamp
- User message
- AI response
- Tool used
- Execution status
This improves:
- debugging
- traceability
- AI monitoring
- workflow validation
Voice pipeline architecture is included but currently disabled.
The architecture supports:
- Telegram voice ingestion
- audio transcription
- AI response generation
- voice response generation
Voice mode was intentionally disabled for stability and cost optimization.
- n8n
- OpenAI
- Telegram Bot API
- SerpAPI
- Wikipedia API
- Hacker News API
- Google Sheets API
Telegram-AI-Assistant-Pro/
│
├── README.md
│
├── workflows/
│ ├── Telegram_AI_Assistant_Pro.json
│ └── TAAP_Search_Agent.json
│
├── screenshots/
│ ├── 1-Main Workflow Architecture.png
│ ├── 2-Telegram Conversation Anthropic news query.png
│ ├── 3-Telegram AI Conversation — Safe Email Handling.png
│ ├── 4-Google Sheets Logging - Observability.png
│ └── 5-Search Subworkflow Architecture.png
- Credentials and internal deployment metadata were removed from exported workflows.
- The workflows are designed for educational and portfolio purposes.
- Some integrations require user-provided credentials before execution.
Boris Villanueva