telegram-bot-builder
Installation
SKILL.md
Contains Shell Commands
This skill contains shell command directives (!`command`) that may execute system commands. Review carefully before installing.
Telegram Bot Builder
Build production-ready Telegram bots for the Israeli market using grammY, Telegraf, or python-telegram-bot. Covers Bot API v10.0 (April 2026), webhooks vs polling, inline keyboards, Hebrew/RTL text, Telegram Stars + Gifts payments, Mini Apps 2.0, Bot Business mode, Managed Bots, and serverless deployment.
Problem
Building Telegram bots for Israeli users involves several challenges that agents consistently get wrong:
- Framework choice confusion - grammY, Telegraf, and python-telegram-bot have different Bot API version support, plugin ecosystems, and deployment models. Agents often mix their APIs or suggest deprecated patterns.
- Webhook vs polling misconfiguration - Agents default to polling (good for development) but fail to set up webhooks correctly for production, missing port restrictions (443, 80, 88, 8443 only), SSL requirements, and secret token verification.
- Hebrew/RTL text corruption - Bidirectional text mixing Hebrew and English (common in Israeli bots) breaks in inline keyboards, callback data, and formatted messages. Agents ignore Unicode control characters and text direction markers.
- Payment integration gaps - Telegram Stars (the in-app currency) has specific invoice creation flows that differ from traditional payment providers. Agents often generate code for deprecated payment APIs.
- Mini App data exchange - The communication protocol between a Telegram Mini App (WebApp) and the bot uses
web_app_dataevents, not regular messages. Agents frequently implement this incorrectly.
Framework Selection
Choose your framework based on your runtime, deployment target, and Bot API version needs: