---
title: "Telegram Integration"
description: "Welcome to the comprehensive documentation for the @elizaos/plugin-telegram package. This index provides organized access to all documentation resources."
---


The @elizaos/plugin-telegram enables your elizaOS agent to operate as a Telegram bot with support for messages, media, interactive buttons, and group management.

## 📚 Documentation

- **[Complete Documentation](./complete-documentation.mdx)** - Detailed technical reference
- **[Message Flow](./message-flow.mdx)** - Visual guide to Telegram message processing
- **[Examples](./examples.mdx)** - Practical implementation examples
- **[Testing Guide](./testing-guide.mdx)** - Testing strategies and patterns

## 🔧 Configuration

### Required Settings
- `TELEGRAM_BOT_TOKEN` - Your bot token from BotFather

### Optional Settings
- `TELEGRAM_API_ROOT` - Custom API endpoint
- `TELEGRAM_ALLOWED_CHATS` - Restrict to specific chats