{
  "name": "telegram-connector",
  "title": "Telegram Bot Connector",
  "description": "Connect Gipity to Telegram: setup instructions, capabilities, and limitations",
  "guid": "sk_plat_tgrm",
  "category": "Platform Setup",
  "requiredTools": [
    "connector_manage"
  ],
  "content": "# Telegram Bot Connector\n\n## What It Does\nYour Gipity agent is available on Telegram via @GipityAI_bot. Users message the bot and get the same AI capabilities as the web interface - chat, images, audio, code execution, web search, and more - directly in Telegram DMs.\n\n## How Users Connect\n\n**New users (no Gipity account):**\n1. Open Telegram and search for **@GipityAI_bot**\n2. Tap **Start** (or send `/start`)\n3. Accept the Terms of Service when prompted\n4. Start chatting - a Gipity account is created automatically\n\n**Existing users (link your account):**\n1. Use `/connect telegram` in the Gipity web interface, OR ask the agent \"connect my Telegram\"\n2. Click the personalized link - it opens the bot in Telegram\n3. Your existing Gipity account is linked automatically (same agent, memory, projects)\n\n**Disconnect:**\n- Use `/disconnect telegram` in the web interface, OR ask the agent \"disconnect Telegram\"\n\nNo signup form, no email, no password. The bot handles everything.\n\n## Auto-Provisioning\nWhen a Telegram user first accepts ToS:\n- A Gipity account is created with a synthetic email (`telegram-{id}@connector.gipity.ai`)\n- A default agent, home project, and initial free credits are granted\n- A \"Telegram\" conversation is created and reused for all future messages\n- The user can later log into the web interface to access advanced features\n\n## What Works in Telegram\n- **Text messages** - full chat with streaming responses (progressive message editing)\n- **Image generation** - images sent as Telegram photos\n- **Audio generation** - clips sent as Telegram audio files (speech, music, sound effects)\n- **Code execution** - sandbox runs, results returned as text\n- **Web search and Twitter search** - results formatted as text\n- **Photo analysis** - send a photo to the bot and it's analyzed by the LLM\n- **App deployment** - deploy URL sent with an \"Open App\" inline button\n- **Tweet cards** - formatted as readable text blocks\n\n## Limitations\n- **DMs only** - group chats are not supported yet\n- **No file uploads** - only photos can be sent to the bot (no documents, audio, etc.)\n- **No destructive confirmations** - operations like DROP TABLE or recursive delete are auto-skipped (users are directed to the web interface)\n- **Message length** - Telegram caps messages at 4096 characters; long responses are automatically split\n- **No interactive flows** - no multi-step confirmations or approval dialogs\n\n## For Users Asking About Telegram\nIf a user asks \"how do I use Gipity on Telegram?\" or \"can I connect to Telegram?\", tell them:\n1. Search for @GipityAI_bot on Telegram\n2. Tap Start and accept the Terms of Service\n3. Start chatting - everything is automatic\n\nIf they already use the web interface and want to link their Telegram account, you can use the `connector_manage` tool with action \"connect\" and provider \"telegram\" to generate a one-time linking URL. Alternatively, they can use `/connect telegram` in the web interface.\n\nIf they want to disconnect Telegram, use the `connector_manage` tool with action \"disconnect\" and provider \"telegram\". They can also use `/disconnect telegram` in the web interface.\n\n## Technical Details (For Reference)\n- Streaming: progressive message editing throttled to ~1 edit/second\n- Rich content: images as photos, audio as audio files, deploy URLs as inline keyboard buttons\n- Database: `connector_users` table maps Telegram user IDs to Gipity accounts"
}