פיתוח בוטים לטלגרם: פקודות, Mini App, שיחתי

בחירה בארכיטקטורת בוט טלגרם שגויה מובילה פעמים רבות לשבועות של עבודה חוזרת ולאלפי דולרים בעלויות נוספות. ראינו לקוחות שהתחילו עם בוט פקודות פשוט עבור תהליך הזמנה רב-שלבי מורכב, רק כדי להיתקל במגבלת ה-64 בתים של callback_data ולצורך לשכתב הכל כ-Mini App. המהנדסים שלנו בנו למעלה מ-30 עוזרים אוטומטיים בחמש השנים האחרונות — מבוטי שידור פשוטים ועד שווקים מלאים. הניסיון הזה מאפשר לנו לבחור את הארכיטקטורה הנכונה מההתחלה, ולחסוך בתקציב ובזמן שלכם. הגישה שלנו מקצרת את זמן הפיתוח ב-40% בהשוואה להתחלה מאפס.

בחירת סוג הבוט הנכון: פקודות, Mini App או שיחתי

התחילו בתרחיש המשתמש. בוט פקודות פשוט עם תפריטים וכפתורים מתאים לבדיקת סטטוס הזמנה או לשאלות נפוצות. ניתן לממש אותו עם InlineKeyboardMarkup ו-FSM על aiogram או python-telegram-bot. בוט שיחתי עם NLP דורש אינטגרציה עם Dialogflow, Rasa או GPT API ליצירת תגובות. Mini App מלא הוא יישום אינטרנט (React, Vue או HTML/CSS פשוט) בתוך WebView של טלגרם, המספק ממשק מותאם אישית ולוגיקה עסקית מורכבת.

אנו מפתחים את כל שלושת הסוגים. רוב הלקוחות שלנו בוחרים ב-Mini App עם אימות טלגרם — הוא מספק חוויית משתמש חלקה ללא שם משתמש/סיסמה. לפי המדדים שלנו, Mini Apps ממירים פי 5 יותר פעולות יעד בהשוואה לבוטי פקודות עבור תרחישים מורכבים. צרו קשר להערכת הפרויקט שלכם — נציע את הפתרון האופטימלי ללא עלויות מיותרות. בוטי פקודות מתחילים ב-$500, בוטים שיחתיים מ-$2,000, ו-Mini Apps מ-$5,000.

מדוע webhooks עדיפים על polling בסביבת ייצור?

Telegram Bot API מציע שתי שיטות עדכון: getUpdates (long polling) ו-webhooks. Long polling נוח לפיתוח מקומי — פשוט השתמשו ב-ngrok לבדיקה. אבל בסביבת ייצור, הוא ממלא את התור: לאחר אתחול מחדש, הבוט שלכם יעבד אלפי עדכונים ממתינים, ועלול לחסום את השרת. Webhook פועל מונע-אירועים: טלגרם שולחת POST לנקודת הקצה HTTPS שלכם, והבוט מגיב מיד. אתם חוסכים ברוחב פס ובמעבד. המדדים שלנו מראים ש-webhooks בעלי פי 3 פחות השהיה מאשר polling בעומס גבוה ומפחיתים את עומס השרת ב-80%.

דרישות חובה ל-webhook:

• אישור TLS תקף (Let's Encrypt או בתשלום)
• פורט 443, 80, 88, 8443 (פורטים לא סטנדרטיים אינם נתמכים)
• כתובת URL ייחודית (לעיתים קרובות משתמשים ב-/{BOT_TOKEN} לבידוד)

דוגמה לרישום webhook עם aiogram 3.x:

from aiogram import Bot, Dispatcher
from aiogram.webhook.aiohttp_server import SimpleRequestHandler

bot = Bot(token=BOT_TOKEN)
dp = Dispatcher()

async def on_startup():
    await bot.set_webhook(
        url=f"https://yourserver.com/webhook/{BOT_TOKEN}",
        drop_pending_updates=True
    )

הפרמטר from aiogram import Bot, Dispatcher from aiogram.webhook.aiohttp_server import SimpleRequestHandler bot = Bot(token=BOT_TOKEN) dp = Dispatcher() async def on_startup(): await bot.set_webhook( url=f"https://yourserver.com/webhook/{BOT_TOKEN}", drop_pending_updates=True ) קריטי בעת אתחול מחדש: בלעדיו, הבוט יעבד את כל ההודעות בתור, ויגרום להצפה.

איך להתגבר על מגבלת ה-64 בתים של callback_data?

לכל drop_pending_updates=True יש מגבלת InlineKeyboardButton של 64 בתים. לפעולות פשוטות של כן/לא זה מספיק. אבל לדיאלוגים מורכבים (כמו הזמנת טיסה רב-שלבית), ייגמר לכם המקום.

הפתרון הוא אחסון מצב ב-Redis עם מזהה קצר ו-TTL של שעה אחת לניקוי אוטומטי:

import uuid, redis, json
r = redis.Redis()

async def create_callback(data: dict) -> str:
    callback_id = str(uuid.uuid4())[:8]
    r.setex(f"cb:{callback_id}", 3600, json.dumps(data))
    return callback_id

async def resolve_callback(callback_id: str) -> dict | None:
    raw = r.get(f"cb:{callback_id}")
    return json.loads(raw) if raw else None

גישה זו עוקפת את המגבלה ומספקת מצב FSM נוח. Redis מנקה אוטומטית ערכים שפגו באמצעות TTL. טכניקה זו נבדקה בשטח בעשרות פרויקטים — אנו מבטיחים יציבות וביצועים.

אימות initData ב-Telegram Mini Apps

כאשר הבוט שלכם פועל כ-Mini App, callback_data מעביר import uuid, redis, json r = redis.Redis() async def create_callback(data: dict) -> str: callback_id = str(uuid.uuid4())[:8] r.setex(f"cb:{callback_id}", 3600, json.dumps(data)) return callback_id async def resolve_callback(callback_id: str) -> dict | None: raw = r.get(f"cb:{callback_id}") return json.loads(raw) if raw else None — מחרוזת עם חתימת HMAC. השרת חייב לאמת את החתימה לפני שהוא נותן אמון בנתוני המשתמש (telegram_id, username). אחרת, כל אחד יכול לזייף בקשה בשם משתמש אחר.

אלגוריתם האימות:

1. גזירת מפתח סודי: HMAC-SHA256 של window.Telegram.WebApp (כהודעה) ו-bot_token (כמפתח).
2. ניתוח initData לפי WebAppData, מיון הפרמטרים (למעט hash) לפי מפתח.
3. שרשור שלהם ל-initData באמצעות & כ-data_check_string.
4. חישוב HMAC-SHA256 של \n עם המפתח הסודי.
5. השוואת התוצאה עם ה-hash מ-initData.

import hmac, hashlib

def verify_telegram_init_data(init_data: str, bot_token: str) -> bool:
    secret_key = hmac.new(b"WebAppData", bot_token.encode(), hashlib.sha256).digest()
    params = parse_qs(init_data)
    data_check_string = "\n".join(
        f"{k}={v}" for k, v in sorted(params.items()) if k != "hash"
    )
    computed_hash = hmac.new(secret_key, data_check_string.encode(), hashlib.sha256).hexdigest()
    provided_hash = params.get("hash", [""])[0]
    return hmac.compare_digest(computed_hash, provided_hash)

האלגוריתם מבוסס על HMAC. האימות אורך פחות מ-1 אלפית השנייה. לאחר האימות, ניתן להשתמש ב-key=value כדי להתחבר ל-CRM שלכם, למשל, כדי לשייך להזמנה או למנוי. צרו קשר לעיצוב וניפוי שגיאות — אנו מבטיחים יישום נכון.

מה כלול בעבודה: תוצרים

אנו מציעים מחזור מלא מרעיון ועד פריסה. ההיקף כולל:

• ניתוח תרחישים ואב-טיפוס
• בחירת מחסנית טכנולוגית: aiogram, grammy, react-telegram-web-app
• יישום צד שרת: API, Redis, PostgreSQL (או MongoDB)
• עיצוב Mini App המותאם לנושא טלגרם (בהיר/כהה)
• אינטגרציית תשלומים דרך Telegram Stars (או שערי תשלום חיצוניים)
• הגדרת Webhook עם ניטור (זמינות, התראות)
• בדיקות: בדיקות יחידה, בדיקות e2e מול Telegram Bot API
• ניפוי שגיאות ופרסום: הגשה לאימות, עבודה עם הנחיות סקירת App Store

תוצרים לאחר סיום:

• תיעוד API מלא
• אישורי שרת וגישה
• שבוע אחד של תמיכה לאחר השקה
• לוח מחוונים לניטור

אנו בונים בוטים ברמות מורכבות שונות כבר למעלה מ-5 שנים. בתקופה זו השקנו למעלה מ-30 פרויקטים — מניוזלטרים פשוטים ועד שווקים עם מאות מוצרים דרך Telegram Mini App. כל פרויקט מגיע עם אחריות איכות ותמיכה טכנית. החבילות שלנו מתחילות ב-$500 לבוטי פקודות, $2,000 לשיחתיים, ו-$5,000 ל-Mini Apps.

התחילו את פרויקט הבוט שלכם

אם יש לכם רעיון, כתבו לנו. נעריך את הפרויקט, נציע ארכיטקטורה וניתן לוחות זמנים. צפו לטווחים הבאים:

• בוט פקודות: משבוע עד שבועיים
• בוט שיחתי עם NLP: משבועיים עד 4 שבועות
• Mini App: מ-4 עד 8 שבועות

העלות מחושבת באופן אישי, בהתאם למורכבות התרחיש ולאינטגרציות. צרו קשר, ונכין מפרט טכני והערכת עלות מדויקת. קבלו ייעוץ. הלקוחות שלנו חוסכים בממוצע 30% על ידי בחירת הארכיטקטורה הנכונה מראש.