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:

  1. 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.
  2. 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.
  3. Hebrew/RTL corruption - bidirectional text breaks in inline keyboards, callback data and formatted messages when Unicode direction marks are ignored.
  4. Payment gaps - Telegram Stars has invoice rules that differ from fiat providers, and agents generate deprecated payment code.
  5. Mini App data exchange - the WebApp-to-bot channel depends on how the app was launched, and sendData is unavailable from inline-keyboard launches.
  6. 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:

Installs
9
GitHub Stars
12
First Seen
May 15, 2026