AndyShaman

Telegram Business Bridge — AI skill for Claude Code

AI community

Connect any AI agent to your personal Telegram via the official Business API — no userbot, no ban risk, no Premium.

How to install Telegram Business Bridge

This entry records only its repository, not the path inside it, so there is no exact command to give. Open AndyShaman/telegram-business-bridge and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Telegram Business Bridge does

Connect any AI agent to your personal Telegram via the official Business API — no userbot, no ban risk, no Premium. Agent reads & searches full history, drafts replies; every reply waits for your ✅. MCP server + 24/7 collector on SQLite/FTS5.

Alternatives in AI

  • CodeIsland — Real-time AI coding agent status panel in your MacBook notch — live status, approvals & replies for 13 AI tool 2.3k ★
  • Dsh Plugin Subscriptions — Use ChatGPT (Codex), Claude, and Grok (X Premium) subscriptions as DeepSeek Harness LLM providers — OAuth logi 283 ★
  • Gh PR Review — GitHub CLI extension that adds full inline PR review comment support — view, navigate, reply to, and resolve r 174 ★

README

telegram-business-bridge

**Connect any AI agent to your personal Telegram messages — through the official Telegram Business API.** No userbot, no MTProto session, no risk of losing your account.

Your agent reads the conversation history, searches it, drafts replies — and by default every reply waits for your ✅ in Telegram before it is sent. Works with Claude Code and any other MCP client. **No Telegram Premium required** — despite the "Business" name, the connection works on a regular free account (verified on a real one).

🇷🇺 [Русская версия](README.ru.md) · 🤖 [Instructions for AI agents](AGENTS.md)

The pains this solves

**"I want an AI assistant in my personal Telegram, but userbots get accounts banned."** The usual way to automate a personal Telegram account is a userbot — Telethon, Pyrogram, a TDLib wrapper — that logs in *as you*, with your session. Telegram actively bans accounts for that. And it is your *personal* account: your channels, your contacts, years of chats. One ban and it is all gone, with no appeal that reliably works. This bridge never touches your session. It is a regular bot connected through the official [Telegram Business API](https://core.telegram.org/bots/api#business-messages): Telegram itself hands your personal chats to the bot, by your explicit permission, switchable off in Settings at any moment. There is simply nothing to ban you for.

**"I'm afraid to let an AI send messages as me."** Reasonable. By default the agent can only *draft* a reply. You get a card in Telegram with the text and two buttons — ✅ Send / ✏️ Edit. Nothing leaves without your tap, and if the wording is almost-but-not-quite right, you fix it in an editor window right inside Telegram instead of retyping the whole reply. Auto-send is strictly opt-in: enable it per chat (`BRIDGE_AUTO_SEND_CHAT_IDS`) for the conversations you genuinely trust the agent with, or globally (`BRIDGE_SEND_POLICY=auto`) once you are sure.

**"My agent forgets who these people are