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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. Mini App data exchange - The communication protocol between a Telegram Mini App (WebApp) and the bot uses web_app_data events, not regular messages. Agents frequently implement this incorrectly.

Framework Selection

Choose your framework based on your runtime, deployment target, and Bot API version needs:

Installs
3
GitHub Stars
9
First Seen
May 15, 2026
telegram-bot-builder — skills-il/developer-tools