A Telegram bot without context is useless. LLMs don't remember the dialog; each request is isolated. We solve this with FSM on Redis and automatic history compression. The result is a Telegram AI bot that remembers you, processes voice and images, and you control the budget. Backed by 5+ years of AI/ML expertise and over 30 delivered projects, our team ensures production-grade reliability.
Core Problems Addressed by a Telegram AI Bot
Dialog Context. LLMs don't remember history — each message is processed in isolation. We store the dialog in Redis via aiogram FSM. We limit history to the last 20 messages (configurable). For long sessions, we automatically compress context using summarization — compressing old messages into one summary.
Multimodal Input. Telegram supports text, voice, and photos. Voice is transcribed via Whisper (through Groq — latency <1 sec). Images are processed via vision API of Claude or GPT-4o. The user doesn't need to switch between tools — everything in one chat.
Rate Limiting and Budget. Each LLM request costs money (tokens). An attacker could spam and drain the account. We set a limit: no more than 10 requests per minute per user. When exceeded, the bot replies: "⏳ Too many requests. Please wait a minute." Additionally — a daily cap on tokens with admin notification.
Technical Stack and Implementation
Stack: aiogram 3.x (async framework), Redis (FSM and cache), Anthropic SDK (Claude), Groq SDK (Whisper), Anthropic Vision API. Configuration via environment variables, deployment in Docker.
Basic AI Bot with aiogram 3.x
import asyncio
from aiogram import Bot, Dispatcher, Router, types, F
from aiogram.filters import CommandStart, Command
from aiogram.fsm.context import FSMContext
from aiogram.fsm.storage.redis import RedisStorage
from anthropic import AsyncAnthropic
BOT_TOKEN = "BOT_TOKEN"
ANTHROPIC_API_KEY = "ANTHROPIC_API_KEY"
bot = Bot(token=BOT_TOKEN)
storage = RedisStorage.from_url("redis://localhost:6379")
dp = Dispatcher(storage=storage)
router = Router()
dp.include_router(router)
thropic_client = AsyncAnthropic(api_key=ANTHROPIC_API_KEY)
# Dialog history stored in FSM context
@router.message(CommandStart())
async def start(message: types.Message, state: FSMContext):
await state.update_data(history=[])
await message.answer(
"Hi! I'm an AI assistant based on Claude. Ask me anything.",
reply_markup=get_main_keyboard()
)
def get_main_keyboard():
from aiogram.utils.keyboard import ReplyKeyboardBuilder
builder = ReplyKeyboardBuilder()
builder.button(text="🗑 Clear history")
builder.button(text="ℹ️ About bot")
builder.adjust(2)
return builder.as_markup(resize_keyboard=True)
@router.message(F.text == "🗑 Clear history")
async def clear_history(message: types.Message, state: FSMContext):
await state.update_data(history=[])
await message.answer("Dialog history cleared.")
@router.message(F.text & ~F.text.startswith("/"))
async def handle_text(message: types.Message, state: FSMContext):
data = await state.get_data()
history = data.get("history", [])
# Add user message to history
history.append({"role": "user", "content": message.text})
# Show typing
await bot.send_chat_action(message.chat.id, "typing")
# Streaming response
full_response = ""
sent_message = await message.answer("...")
async with anthropic_client.messages.stream(
model="claude-haiku-4-5",
max_tokens=2048,
system="You are a helpful assistant. Answer concisely and to the point.",
messages=history,
) as stream:
async for text in stream.text_stream:
full_response += text
# Update message every 50 characters
if len(full_response) % 50 == 0:
await sent_message.edit_text(full_response)
await sent_message.edit_text(full_response)
# Save response to history
history.append({"role": "assistant", "content": full_response})
# Keep last 20 messages
await state.update_data(history=history[-20:])
Voice Message Handling
import io
from groq import AsyncGroq
groq_client = AsyncGroq(api_key="GROQ_API_KEY")
@router.message(F.voice)
async def handle_voice(message: types.Message, state: FSMContext):
await bot.send_chat_action(message.chat.id, "typing")
# Download voice message
voice = message.voice
file = await bot.get_file(voice.file_id)
file_bytes = await bot.download_file(file.file_path)
# Transcribe with Whisper on Groq (fast)
transcription = await groq_client.audio.transcriptions.create(
file=("voice.ogg", file_bytes.read()),
model="whisper-large-v3",
language="en",
)
text = transcription.text
await message.answer(f"📝 Recognized: {text}")
# Process as text message
await handle_text_with_content(message, state, text)
Image Handling
import base64
@router.message(F.photo)
async def handle_photo(message: types.Message, state: FSMContext):
await bot.send_chat_action(message.chat.id, "typing")
# Get the best quality photo
photo = message.photo[-1]
file = await bot.get_file(photo.file_id)
file_bytes = await bot.download_file(file.file_path)
image_data = base64.standard_b64encode(file_bytes.read()).decode()
caption = message.caption or "What is in this image?"
response = await anthropic_client.messages.create(
model="claude-haiku-4-5",
max_tokens=1024,
messages=[{
"role": "user",
"content": [
{"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": image_data}},
{"type": "text", "text": caption},
]
}]
)
await message.answer(response.content[0].text)
Rate Limiting and Billing Protection
from aiogram.filters import BaseFilter
from collections import defaultdict
import time
class RateLimitFilter(BaseFilter):
def __init__(self, rate_limit: int = 10, period: int = 60):
self.rate_limit = rate_limit
self.period = period
self.user_requests = defaultdict(list)
async def __call__(self, message: types.Message) -> bool:
user_id = message.from_user.id
now = time.time()
# Remove old requests
self.user_requests[user_id] = [
t for t in self.user_requests[user_id]
if now - t < self.period
]
if len(self.user_requests[user_id]) >= self.rate_limit:
await message.answer("⏳ Too many requests. Please wait a minute.")
return False
self.user_requests[user_id].append(now)
return True
# Apply the filter
@router.message(RateLimitFilter(rate_limit=10), F.text)
async def handle_with_limit(message: types.Message, state: FSMContext):
await handle_text(message, state)
Ensuring Dialog Context in a Telegram Bot
For persistent context, we use Redis Storage. FSM state is saved between requests. The dialog history is an array of messages with user and assistant roles. We limit it to the last 20 messages to avoid exceeding the model's context window (Claude Haiku has 200k tokens). If the dialog is longer, we automatically compress old messages into one summary via LLM.
Why Redis Instead of PostgreSQL?
Redis gives latency p99 < 10 ms, PostgreSQL — ~50 ms. For FSM, where each request rewrites state, speed is critical. Also, Redis automatically removes outdated data (TTL), simplifying maintenance.
Development Process
- Requirements analysis (1 day): Technical specification, LLM selection, architecture design.
- Bot prototype (2–3 days): MVP with text-based dialog using FSM and Redis.
- Voice/image integration (2–3 days): Add multimodal input via Whisper and vision API.
- Rate limiting and admin panel (3–5 days): Implement abuse protection, budget caps, Prometheus monitoring.
- Deployment and testing (2–3 days): Release on VPS with Docker, load testing.
LLM Model Comparison for Telegram Bot
| Model | Speed (latency p50) | Answer quality | Cost per 1M tokens |
|---|---|---|---|
| Claude Haiku | 300 ms | Good | $0.25 |
| GPT-4o | 800 ms | Excellent | $5.00 |
| LLaMA 3 (local) | 150 ms | Average | $0.02 (electricity) |
Claude Haiku is 2.5x faster than GPT-4o with comparable quality for typical tasks, making it optimal for chatbots.
Practical Case: Customer Support
From our practice: we developed a Telegram bot on Claude Haiku for a SaaS product. Result: 73% of inquiries handled without human support. Response time: from 24 hours to instant. The client saved approximately $800 per month on support costs. We configured rate limiting and a daily token cap — daily spend did not exceed $1.5, confirming the approach's effectiveness.
Common Mistakes in AI Bot Development
- Storing history in process memory. Context is lost on bot restart. Use Redis.
- Ignoring rate limiting. A single user can spam and drain the budget. Always set limits.
- No error handling for LLM calls. The model may crash or return an invalid response. Wrap calls in try-except.
- Hard binding to one model. If the model becomes unavailable, the bot stops working. Plan a fallback to another LLM.
What's Included
- Technical specification and stack selection.
- Bot development (dialog, voice, images).
- Rate limiting and admin configuration.
- Redis integration and Docker deployment.
- Documentation, access, and team training.
- One month of support after launch.
Estimated Timeline
- Basic bot with dialog: 2–3 days
- Voice + images: 2–3 days
- Rate limiting + admin panel: 1 week
- Release + monitoring: +2–3 days
Contact us for a free consultation and accurate cost estimate. Order turnkey development with quality guarantee.







