Skip to content
API Blog

Telegram

Lobu’s Telegram adapter supports direct chats, group interactions, and interactive workflows. Under the hood, Lobu uses the Telegram Bot API via @chat-adapter/telegram.

C
Coding
online
List open PRs in lobu-ai/lobu12:01
Can't reach github.com — not in the agent's allowed domains. Grant access?12:01
Allow for 1 hour12:01
Added github.com to allowed domains. 3 open PRs in lobu-ai/lobu: • #214 Fix worker memory leak • #219 Telegram adapter retries • #223 Add Bedrock provider12:01
O
Ops Assistant
online
Summarize my active Linear sprint12:01
I need the `linear` skill to query Linear. It bundles the Linear MCP and handles OAuth via Lobu.12:01
Go ahead12:01
Installed and connected. Sprint "Week 15" (68% done): • 11 merged, 3 in review, 2 todo • Blocked: AUTH-234 (design) • At risk: API-89 (due tomorrow)12:01
A
Assistant
online
Switch to Claude Sonnet12:01
You can change the model from your settings — opens a scoped page with your current agent config.12:01
Done — set to claude-sonnet-4-612:01
Now running on claude-sonnet-4-6 via OpenRouter. Next messages will use the new model.12:01
  1. Create a bot with @BotFather on Telegram and copy the bot token.
  2. Run lobu connections add telegram to add the connection (prompts for the bot token), or run lobu init to scaffold a new project and pick Telegram in the wizard.
  3. Start the stack with lobu run -d — the bot starts receiving messages immediately.
FieldRequiredTypeDescription
botTokenNostringTelegram bot token from BotFather. Falls back to TELEGRAM_BOT_TOKEN env var.
modeNoauto | webhook | pollingRuntime mode: auto (default), webhook, or polling.
secretTokenNostringWebhook secret token for x-telegram-bot-api-secret-token verification.
userNameNostringOverride bot username.
apiBaseUrlNostringCustom Telegram API base URL.

Connection Settings

These settings apply to all platform connections and are passed in the settings object.

FieldRequiredTypeDescription
allowFromNostring[]User IDs allowed to interact with this connection. Omit to allow all; empty array blocks all.
allowGroupsNobooleanWhether group messages are allowed (default true).
userConfigScopesNostring[]Scopes that end users are allowed to customize. Empty = no restrictions.
  • Long-polling or webhook handling for receiving messages.
  • Inline keyboard interactions for structured choices and approvals.
  • Platform-scoped settings links for authentication and configuration flows.
  • Thread/context routing across DMs and group chats.
  • File handling for documents and media attached in Telegram messages.
  • Personal AI assistant in Telegram DMs.
  • Group copilots with mention-based interaction patterns.