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.3 (24 August 2026), webhooks vs polling, inline keyboards, Hebrew/RTL text, Telegram Stars + Gifts payments, Mini Apps 2.0, Bot Business mode, and serverless deployment.
Problem
Building Telegram bots for Israeli users involves several things agents consistently get wrong:
- Framework confusion - grammY, Telegraf and python-telegram-bot sit on different Bot API versions and mix badly. Agents blend their APIs or emit deprecated patterns.
- Webhook misconfiguration - agents default to polling and then set webhooks up wrong for production, missing the port restriction (443, 80, 88, 8443 only), SSL, and secret-token verification.
- Hebrew/RTL corruption - bidirectional text breaks in inline keyboards, callback data and formatted messages when Unicode direction marks are ignored.
- Payment gaps - Telegram Stars has invoice rules that differ from fiat providers, and agents generate deprecated payment code.
- Mini App data exchange - the WebApp-to-bot channel depends on how the app was launched, and
sendDatais unavailable from inline-keyboard launches. - Version drift - the Bot API ships several times a year and models learn a frozen snapshot. This skill was last verified against Bot API 10.3 on 2026-08-27; check the changelog before trusting any version-specific claim here.
Framework Selection
Choose by runtime, deployment target and Bot API version: