Overseer Docs
Interfaces

Telegram

Telegram bot integration guide

Telegram Bot

Connect Overseer to Telegram for a rich chat experience with streaming responses, file uploads, and inline formatting.

Setup

Create Bot

Message @BotFather on Telegram and send /newbot to create a new bot. Save the token.

Get Your User ID

Message @userinfobot to get your Telegram user ID.

Configure

Add this to your .env file:

TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
TELEGRAM_ALLOWED_USERS=your-user-id
Start Bot
pnpm bot:dev

Features

  • Streaming Responses — See responses as they're generated
  • Rich Formatting — Markdown, code blocks, inline code
  • File Uploads — Send and receive files
  • User Whitelisting — Only approved users can interact
  • Conversation History — Full history preserved across sessions

On this page