TeleMate

TeleMate — Your Slack-native proxy that automates Telegram's engagement tax: downloads, cleans channels, and blocks scams in one message.

Comment

💡 Inspiration

If you use Telegram, you know the struggle. The platform is incredibly powerful, but it has become a chaotic labyrinth of promotional channels, spam bots, and overwhelming notifications. Finding a simple file or catching up on important messages often requires navigating through a minefield of "force-subscribe" requirements, where bots force you to join 5 random spam channels just to download a single file.

I wanted to take back control of my digital communication. I was inspired to build TeleMate to act as a hyper-intelligent, automated shield between the user and Telegram. By bridging Telegram to Slack, I could consume the content I wanted on my own terms, automate away the spammy "force-sub" requirements, and use AI to instantly summarize the noise.

⚙️ What it does

TeleMate is a fully autonomous Telegram-to-Slack integration that lets you orchestrate your entire Telegram account from the comfort of a Slack workspace.

Key features include:

  • The Smart Downloader: Say goodbye to force-sub traps. When you ask TeleMate to download a file from a promotional bot or channel link, it automatically clicks the links, temporarily joins the required spam channels, extracts your file, forwards it to your Saved Messages, and immediately leaves the spam channels behind.
  • Universal Broadcaster: Send messages to multiple users, channels, or groups simultaneously with a single slash command in Slack.
  • AI Summarization: Powered by Groq's ultra-fast llama-3.3-70b-versatile model, TeleMate can instantly read the last 50 messages of any channel and provide a concise, English-translated summary, completely eliminating the need to scroll through endless chatter.
  • Channel Janitor: A built-in cleanup tool to help you mass-leave inactive or promotional channels that are cluttering your account.
  • Message Link Parsing: Just paste a Telegram message link into Slack, and TeleMate will intelligently extract the exact post, find the hidden download links or media, and process it automatically.

🛠️ How we built it

TeleMate was engineered as a high-performance Python application using a Hybrid Architecture:

  • Telegram Interface: Built on the Telethon MTProto library to programmatically interact with the Telegram API as a user account, allowing for raw access to messages, entities, and channel management.
  • Slack Integration: Utilized the Slack Bolt framework running in Socket Mode to receive real-time commands and events from the Slack UI without needing a public endpoint.
  • AI Orchestration: Integrated with the Groq API to leverage LLMs for intelligent routing and lightning-fast message summarization.
  • Database: Implemented an SQLite caching layer to store downloaded file metadata and provide lightning-fast local search for your archives.

⚠️ Challenges we ran into

Building a bridge between two massive platforms presented some immense technical hurdles:

  1. The "Force-Sub" Labyrinth: Telegram bots use highly complex inline-button structures to force users to join private channels. We had to write complex regex and link-extraction algorithms to find hidden t.me/+ invite links, automatically navigate Telegram's ImportChatInviteRequest API, and handle strict FloodWaitError rate limits imposed by Telegram's anti-spam systems.
  2. Invisible Slack Formatting: Slack automatically wraps URLs and mentions in hidden <URL|TEXT> tags. This caused catastrophic crashes when passing IDs to Telegram until we built an aggressive sanitization pipeline to strip zero-width spaces, HTML tags, and backticks.
  3. AI Context Limits: Initially, we allowed the AI to autonomously decide which commands to run, but giving it access to the entire Telegram history caused massive context-window bloat and rate-limit crashes. We solved this by strictly isolating the AI to summarization tasks and using deterministic parsing for standard automation.

🎓 Accomplishments that we're proud of

I am incredibly proud of cracking the "Smart Download" protocol. Successfully automating the process of navigating a bot, joining 4 separate private channels, extracting a specific .mp4 file, and leaving those channels in less than 5 seconds feels like pure magic. It completely neutralizes one of the most frustrating user experiences on the modern internet.

📚 What we learned

This project was a masterclass in API rate limiting, asynchronous Python (asyncio), and the intricacies of the MTProto protocol. I learned that visual UI actions (like clicking "Join Channel") often translate to very different programmatic requirements under the hood, and that sanitizing user input across platform boundaries (Slack to Telegram) requires extreme diligence.

🚀 What's next for TeleMate

In the future, I plan to:

  • Add a Persistent Web Dashboard: Migrate the "Channel Janitor" and file-search features from Slack commands into a sleek Next.js web application.
  • Scheduled Summaries: Implement cron jobs to automatically drop daily summaries of important channels into Slack every morning.
  • Vector Search: Add an embedding layer (like Pinecone or local ChromaDB) so users can semantically search through years of their Telegram history.
Share this project:

Updates