# Telegram

> Telegram integration capabilities for Lobu agents.

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`.

<PlatformChatExamples platform="telegram" client:visible />

## Setup

1. Create a bot with [@BotFather](https://t.me/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.

## Configuration

<PlatformConfigTable platform="telegram" />

## Features

- **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.

## Typical Use Cases

- Personal AI assistant in Telegram DMs.
- Group copilots with mention-based interaction patterns.