amirbiron · amirbiron · Jul 27, 2026 · Jul 20, 2026 · Jul 20, 2026 · Jul 20, 2026
diff --git a/GUIDES/BOT_USER_GUIDE.md b/GUIDES/BOT_USER_GUIDE.md
@@ -748,7 +748,7 @@ class DataHandler:
 2. בחר מקור:
    - **✍️ הדבק קוד** - הדבק קוד ישירות
    - **🗂 לפי ריפו** - בחר מקבצים לפי ריפו
-   - **📦 קבצי ZIP** - בחר מקבצי ZIP שמורים
+   - **📦 קבצי גיבוי** - בחר מקבצי ZIP שמורים
    - **📂 קבצים גדולים** - בחר מקבצים גדולים (500+ שורות)
    - **📁 שאר הקבצים** - בחר מכל הקבצים האחרים
 3. בחר קובץ להעלאה
@@ -1071,7 +1071,7 @@ git checkout -b restore-from-checkpoint
 
 **תפריט גיבוי ל-Drive:**
 ```
-📦 קבצי ZIP - גיבוי של כל קבצי ה-ZIP השמורים בבוט
+📦 קבצי גיבוי - גיבוי של כל קבצי ה-ZIP השמורים בבוט
 🧰 הכל - גיבוי של כל הקבצים בבוט
 📂 בחר תיקיית יעד - בחירת תיקייה ב-Drive להעלאה
 ⏰ קבע תזמון - תזמון אוטומטי לגיבויים
@@ -1084,7 +1084,7 @@ git checkout -b restore-from-checkpoint
 ### איך לגבות ל-Drive?
 
 1. **בחר סוג גיבוי:**
-   - **📦 קבצי ZIP** - רק קבצי ZIP שיצרת או הורדת
+   - **📦 קבצי גיבוי** - רק קבצי ZIP שיצרת או הורדת
    - **🧰 הכל** - כל הקבצים השמורים בבוט
 
 2. **בחר תיקיית יעד (אופציונלי):**

diff --git a/backup_menu_handler.py b/backup_menu_handler.py
@@ -10,6 +10,7 @@
 
 from services import backup_service as backup_manager
 from handlers.pagination import build_pagination_row
+from i18n.strings_he import BTN_BACKUP_ZIPS
 
 logger = logging.getLogger(__name__)
 
@@ -627,7 +628,7 @@ def _key(v: Any) -> float:
                     id_to_version[getattr(b, 'backup_id', '')] = idx
         except Exception:
             id_to_version = {}
-        lines = [f"📦 קבצי ZIP שמורים — סה\"כ: {total}\n📄 עמוד {page} מתוך {total_pages}\n"]
+        lines = [f"{BTN_BACKUP_ZIPS} שמורים — סה\"כ: {total}\n📄 עמוד {page} מתוך {total_pages}\n"]
         keyboard = []
         delete_mode = bool(context.user_data.get("backup_delete_mode"))
         selected = set(context.user_data.get("backup_delete_selected", set()))

diff --git a/config.py b/config.py
@@ -333,6 +333,11 @@ class BotConfig(BaseSettings):
         default="https://amirbiron.github.io/CodeBot/", description="Docs URL"
     )
     BOT_LABEL: str = Field(default="CodeBot", description="Bot label for UI")
+    # אימוג'י מותאם (טלגרם פרימיום) לאייקון ZIP בהודעות הבוט; ריק/None => אימוג'י רגיל.
+    # ה-ID הוא משאב חיצוני (חבילת צד ג') ולכן חי רק ב-ENV — לא מוטבע בקוד.
+    CUSTOM_EMOJI_ZIP_ID: Optional[str] = Field(
+        default=None, description="Custom emoji ID for ZIP icon (Telegram premium)"
+    )
     DRIVE_ADD_HASH: bool = Field(
         default=False, description="Append hash to filenames to avoid collisions"
     )

diff --git a/conversation_handlers.py b/conversation_handlers.py
@@ -40,6 +40,7 @@ def set_activity_reporter(new_reporter):
 from utils import TelegramUtils, TextUtils, ValidationUtils
 from services import code_service
 from i18n.strings_he import MAIN_MENU as MAIN_KEYBOARD
+from i18n.strings_he import BTN_BACKUP_ZIPS
 from handlers.pagination import build_pagination_row
 from config import config
 from urllib.parse import quote_plus
@@ -688,7 +689,7 @@ async def submit_flows_cancel(update: Update, context: ContextTypes.DEFAULT_TYPE
         "🗂 <b>לפי ריפו</b> — קבצים מאורגנים לפי פרויקט\n"
         "📂 <b>קבצים גדולים</b> — תצוגה מדורגת לקבצים ארוכים\n"
         "📁 <b>שאר הקבצים</b> — כל השאר\n"
-        "📦 <b>קבצי ZIP</b> — גיבויים/ארכיונים\n\n"
+        "📦 <b>קבצי גיבוי</b> — ארכיוני ZIP (גיבויים וריפואים מגיטהאב)\n\n"
         "<b>לכל קובץ יש תפריט עם:</b>\n"
         "👁️ הצג | ✏️ ערוך | 📝 שנה שם\n"
         "📚 היסטוריה | 📥 הורד | 🗑️ העבר לסל\n\n"
@@ -894,7 +895,7 @@ def _count_and_save_skill(raw: bytes, user_id: int, original_name: str):
 
 
 async def _handle_zip_route(update: Update, context: ContextTypes.DEFAULT_TYPE, data: str) -> None:
-    """מטפל בבחירת יעד ל-ZIP שהועלה: '📝 סקיל' (אחסון קבוע as-is) או '📦 גיבוי' (רשימת הגיבויים).
+    """מטפל בבחירת יעד ל-ZIP שהועלה: '🧩 סקיל' (אחסון קבוע as-is) או '📦 גיבוי' (רשימת הגיבויים).
 
     ה-bytes נטענים מהקובץ הזמני שנשמר ב-_maybe_store_zip_copy; השמירה הכבדה רצה ב-thread נפרד
     כדי לא לחסום את לולאת האירועים.
@@ -932,7 +933,7 @@ async def _handle_zip_route(update: Update, context: ContextTypes.DEFAULT_TYPE,
             await TelegramUtils.safe_edit_message_text(
                 query,
                 f"✅ נשמר כסקיל: <code>{html_escape(original_name)}</code>\n"
-                "🔎 ניתן למצוא אותו תחת: '📚' ← '📝 סקילים'.",
+                "🔎 ניתן למצוא אותו תחת: '📚' ← '🧩 סקילים'.",
                 parse_mode=ParseMode.HTML,
             )
         else:
@@ -959,7 +960,7 @@ async def _handle_zip_route(update: Update, context: ContextTypes.DEFAULT_TYPE,
         await TelegramUtils.safe_edit_message_text(
             query,
             "✅ קובץ ZIP נשמר בהצלחה לרשימת ה‑ZIP השמורים.\n"
-            "📦 ניתן למצוא אותו תחת: '📚' ← '📦 קבצי ZIP' או ב‑Batch/GitHub."
+            f"📦 ניתן למצוא אותו תחת: '📚' ← '{BTN_BACKUP_ZIPS}' או ב‑Batch/GitHub."
         )
     else:
         await TelegramUtils.safe_edit_message_text(
@@ -1076,8 +1077,8 @@ async def show_all_files(update: Update, context: ContextTypes.DEFAULT_TYPE) ->
         keyboard = [
             [InlineKeyboardButton("🔎 חפש קובץ", callback_data="search_files")],
             [InlineKeyboardButton("🗂 לפי ריפו", callback_data="by_repo_menu")],
-            [InlineKeyboardButton("📦 קבצי ZIP", callback_data="backup_list")],
-            [InlineKeyboardButton("📝 סקילים", callback_data="skill_list")],
+            [InlineKeyboardButton(BTN_BACKUP_ZIPS, callback_data="backup_list")],
+            [InlineKeyboardButton("🧩 סקילים", callback_data="skill_list")],
             [InlineKeyboardButton("📂 קבצים גדולים", callback_data="show_large_files")],
             [InlineKeyboardButton("📁 שאר הקבצים", callback_data="show_regular_files")],
             [InlineKeyboardButton("⭐ מועדפים", callback_data="show_favorites")],
@@ -1147,8 +1148,8 @@ async def show_all_files_callback(update: Update, context: ContextTypes.DEFAULT_
             pass
         keyboard = [
             [InlineKeyboardButton("🗂 לפי ריפו", callback_data="by_repo_menu")],
-            [InlineKeyboardButton("📦 קבצי ZIP", callback_data="backup_list")],
-            [InlineKeyboardButton("📝 סקילים", callback_data="skill_list")],
+            [InlineKeyboardButton(BTN_BACKUP_ZIPS, callback_data="backup_list")],
+            [InlineKeyboardButton("🧩 סקילים", callback_data="skill_list")],
             [InlineKeyboardButton("📂 קבצים גדולים", callback_data="show_large_files")],
             [InlineKeyboardButton("📁 שאר הקבצים", callback_data="show_regular_files")],
             [InlineKeyboardButton("⭐ מועדפים", callback_data="show_favorites")],
@@ -4766,7 +4767,7 @@ async def show_batch_menu(update: Update, context: ContextTypes.DEFAULT_TYPE) ->
         send = update.message.reply_text
     keyboard = [
         [InlineKeyboardButton("🗂 לפי ריפו", callback_data="batch_cat:repos")],
-        [InlineKeyboardButton("📦 קבצי ZIP", callback_data="batch_cat:zips")],
+        [InlineKeyboardButton(BTN_BACKUP_ZIPS, callback_data="batch_cat:zips")],
         [InlineKeyboardButton("📂 קבצים גדולים", callback_data="batch_cat:large")],
         [InlineKeyboardButton("📁 שאר הקבצים", callback_data="batch_cat:other")],
         [InlineKeyboardButton("📋 סטטוס עבודות", callback_data="show_jobs")],
@@ -4894,7 +4895,7 @@ async def show_batch_zips_menu(update: Update, context: ContextTypes.DEFAULT_TYP
         if not backups:
             keyboard = [[InlineKeyboardButton("🔙 חזור", callback_data="batch_menu")]]
             await query.edit_message_text(
-                "ℹ️ לא נמצאו קבצי ZIP שמורים.",
+                "ℹ️ לא נמצאו קבצי גיבוי שמורים.",
                 reply_markup=InlineKeyboardMarkup(keyboard)
             )
             return ConversationHandler.END
@@ -4910,7 +4911,7 @@ async def show_batch_zips_menu(update: Update, context: ContextTypes.DEFAULT_TYP
         end = min(start + PAGE_SIZE, total)
         items = backups[start:end]
 
-        lines = [f'📦 קבצי ZIP שמורים — סה"כ: {total}\n📄 עמוד {page} מתוך {total_pages}\n']
+        lines = [f'{BTN_BACKUP_ZIPS} שמורים — סה"כ: {total}\n📄 עמוד {page} מתוך {total_pages}\n']
         keyboard = []
         # חישוב גרסאות vN לפי ריפו
         repo_to_sorted: Dict[str, list] = {}

diff --git a/docs/environment-variables.rst b/docs/environment-variables.rst
@@ -832,6 +832,12 @@
      - ``CodeBot``
      - ``CKB``
      - Bot/WebApp
+   * - ``CUSTOM_EMOJI_ZIP_ID``
+     - Custom emoji ID לאייקון ZIP בהודעות הבוט (טלגרם פרימיום, לבעל בוט עם מנוי); ריק = אימוג'י רגיל 📁.
+     - לא
+     - (ללא)
+     - ``5069094945915142952``
+     - Bot
    * - ``DRIVE_ADD_HASH``
      - הוספת hash לקבצים משותפים
      - לא

diff --git a/docs/handlers/drive_menu.rst b/docs/handlers/drive_menu.rst
@@ -3,15 +3,15 @@ Drive Menu V2
 
 סקירה
 -----
-תפריט הגיבוי ל‑Google Drive (גרסת V2) כולל בחירה מהירה (קבצי ZIP/הכל/מתקדם), בחירת תיקיית יעד (אוטומטי/ברירת מחדל/מותאם), תזמון גיבוי, וטיפול שגיאות ברור.
+תפריט הגיבוי ל‑Google Drive (גרסת V2) כולל בחירה מהירה (קבצי גיבוי/הכל/מתקדם), בחירת תיקיית יעד (אוטומטי/ברירת מחדל/מותאם), תזמון גיבוי, וטיפול שגיאות ברור.
 
 דגל פיצ'ר
 ----------
 - DRIVE_MENU_V2 (ברירת מחדל: true). כיבוי מהיר במשתני סביבה.
 
 זרימות עיקריות
 ---------------
-- קבצי ZIP: העלאת ZIPים שמורים בבוט, כולל הצעה ליצור ZIP אם אין.
+- קבצי גיבוי: העלאת ZIPים שמורים בבוט, כולל הצעה ליצור ZIP אם אין.
 - הכל: יצירת ZIP מלא והעלאה.
 - מתקדם: לפי ריפו / קבצים גדולים / שאר; בחירה מרובה.
 - תיקיית יעד: אוטומטי (סידור לפי קטגוריה/תאריך), ברירת מחדל, או נתיב מותאם.

diff --git a/github_menu_handler.py b/github_menu_handler.py
@@ -20,6 +20,8 @@
 import errno
 from urllib.parse import urlparse
 
+from i18n.strings_he import BTN_BACKUP_ZIPS
+
 # Shim: expose a 'requests' object for tests and route GETs through it.
 # This allows monkeypatching gh.requests.get in tests while still using
 # our pooled http client under the hood.
@@ -1497,7 +1499,7 @@ async def handle_menu_callback(self, update: Update, context: ContextTypes.DEFAU
                 keyboard = [
                     [InlineKeyboardButton("✍️ הדבק קוד", callback_data="upload_paste_code")],
                     [InlineKeyboardButton("🗂 לפי ריפו", callback_data="gh_upload_cat:repos")],
-                    [InlineKeyboardButton("📦 קבצי ZIP", callback_data="gh_upload_cat:zips")],
+                    [InlineKeyboardButton(BTN_BACKUP_ZIPS, callback_data="gh_upload_cat:zips")],
                     [InlineKeyboardButton("📂 קבצים גדולים", callback_data="gh_upload_cat:large")],
                     [InlineKeyboardButton("📁 שאר הקבצים", callback_data="gh_upload_cat:other")],
                     [InlineKeyboardButton("🔙 חזור", callback_data="github_menu")],
@@ -1528,7 +1530,7 @@ async def handle_menu_callback(self, update: Update, context: ContextTypes.DEFAU
                 keyboard = [
                     [InlineKeyboardButton("✍️ הדבק קוד", callback_data="upload_paste_code")],
                     [InlineKeyboardButton("🗂 לפי ריפו", callback_data="gh_upload_cat:repos")],
-                    [InlineKeyboardButton("📦 קבצי ZIP", callback_data="gh_upload_cat:zips")],
+                    [InlineKeyboardButton(BTN_BACKUP_ZIPS, callback_data="gh_upload_cat:zips")],
                     [InlineKeyboardButton("📂 קבצים גדולים", callback_data="gh_upload_cat:large")],
                     [InlineKeyboardButton("📁 שאר הקבצים", callback_data="gh_upload_cat:other")],
                     [InlineKeyboardButton("🔙 חזור", callback_data="github_menu")],
@@ -1579,12 +1581,12 @@ async def handle_menu_callback(self, update: Update, context: ContextTypes.DEFAU
                     backup_handler = BackupMenuHandler()
                     context.bot_data['backup_handler'] = backup_handler
                 except Exception as e:
-                    await query.edit_message_text(f"❌ רכיב גיבוי לא זמין: {e}")
+                    await TelegramUtils.safe_edit_message_text(query, f"❌ רכיב גיבוי לא זמין: {e}")
                     return
             try:
                 await backup_handler._show_backups_list(update, context, page=1)
             except Exception as e:
-                await query.edit_message_text(f"❌ שגיאה בטעינת קבצי ZIP: {e}")
+                await TelegramUtils.safe_edit_message_text(query, f"❌ שגיאה בטעינת קבצי גיבוי: {e}")
         elif query.data.startswith("gh_upload_zip_browse:"):
             # עיון בקובץ ZIP שמור ובחירת קובץ מתוכו להעלאה לריפו
             backup_id = query.data.split(":", 1)[1]

diff --git a/handlers/documents.py b/handlers/documents.py
@@ -17,6 +17,7 @@
 
 from telegram import InlineKeyboardButton, InlineKeyboardMarkup, Update
 from telegram.constants import ParseMode
+from telegram.error import BadRequest
 from telegram.ext import ContextTypes
 
 # שימוש ב-FilesFacade דרך Composition Root כדי להימנע מתלות ישירה ב-DB
@@ -27,6 +28,9 @@
 
 logger = logging.getLogger(__name__)
 
+# לוג חד-פעמי לתהליך כשטלגרם דוחה את האימוג'י המותאם (תנאי פרימיום/ID לא תקף)
+_custom_emoji_warned = False
+
 # מגבלות ייבוא ZIP — הגנה מפני "פצצת ZIP" (דקומפרסיה מתפוצצת) בעת בניית ריפו מקובץ.
 # הבדיקות נעשות מול הגודל הלא-דחוס (ZipInfo.file_size) לפני קריאת התוכן לזיכרון.
 MAX_IMPORT_ZIP_MEMBERS = 2000  # מספר קבצים מקסימלי בארכיון לייבוא
@@ -1003,8 +1007,10 @@ async def _maybe_store_zip_copy(
                 stash_pending_zip_bytes,
                 cleanup_pending_zip,
                 cleanup_stale_pending_zips,
+                tg_emoji,
                 PENDING_ZIP_TTL_SECONDS,
             )
+            from config import config
             import uuid as _uuid
 
             original_name = document.file_name or "upload.zip"
@@ -1049,21 +1055,48 @@ async def _maybe_store_zip_copy(
                 "ts": int(datetime.now(timezone.utc).timestamp()),
             }
 
+            # כפתורים: אימוג'י רגיל בלבד — inline keyboard לא תומך ב-custom emoji entities
             keyboard = InlineKeyboardMarkup([
                 [
-                    InlineKeyboardButton("📝 סקיל", callback_data=f"zip_route_skill:{token}"),
+                    InlineKeyboardButton("🧩 סקיל", callback_data=f"zip_route_skill:{token}"),
                     InlineKeyboardButton("📦 גיבוי", callback_data=f"zip_route_backup:{token}"),
                 ]
             ])
-            try:
-                await update.message.reply_text(
-                    f"📦 קיבלתי קובץ ZIP: <code>{html_escape(original_name)}</code>\n"
-                    "איך לשמור אותו?\n\n"
-                    "📝 <b>סקיל</b> — אחסון קבוע, בדיוק כמו שהוא (byte-for-byte), בלי מחיקה אוטומטית.\n"
-                    "📦 <b>גיבוי</b> — נשמר לרשימת הגיבויים (כפוף למדיניות ניקוי).",
-                    reply_markup=keyboard,
-                    parse_mode=ParseMode.HTML,
+
+            def _zip_prompt_text(icon: str) -> str:
+                return (
+                    f"{icon} קיבלתי קובץ ZIP: <code>{html_escape(original_name)}</code>\n"
+                    "איפה לשמור אותו?\n\n"
+                    "🧩 <b>בקטגוריית סקילים</b> — קטגוריה מיוחדת לשמירת סקילים בפורמט ZIP\n"
+                    "📦 <b>בקטגוריית גיבויים</b> — קטגוריה לשמירת Repo's מגיטהאב בפורמט ZIP "
+                    "(אפשר אחר כך לשחזר מהזיפ את כל הריפו בגיטהאב דרך הבוט - בלחיצה)"
                 )
+
+            try:
+                # אייקון ZIP מותאם (טלגרם פרימיום) — ה-ID מגיע מ-ENV בלבד; בלי ID נופלים ל-📁
+                custom_icon = tg_emoji(getattr(config, "CUSTOM_EMOJI_ZIP_ID", None), "📁")
+                try:
+                    await update.message.reply_text(
+                        _zip_prompt_text(custom_icon),
+                        reply_markup=keyboard,
+                        parse_mode=ParseMode.HTML,
+                    )
+                except BadRequest:
+                    # טלגרם דחתה את ההודעה — אם זה בגלל האימוג'י המותאם (תנאי פרימיום/ID
+                    # שנמחק), שולחים שוב עם האימוג'י הרגיל: המשתמש חייב לקבל את ההודעה.
+                    if custom_icon == "📁":
+                        raise  # אין אימוג'י מותאם בהודעה — הכשל ממקור אחר, אין טעם בניסיון זהה
+                    await update.message.reply_text(
+                        _zip_prompt_text("📁"),
+                        reply_markup=keyboard,
+                        parse_mode=ParseMode.HTML,
+                    )
+                    # מסמנים ומלוגגים רק אחרי שה-fallback עבר — זו ההוכחה שהבעיה הייתה
+                    # האימוג'י (BadRequest ממקור אחר היה מפיל גם את השליחה הזו ומתגלגל הלאה)
+                    global _custom_emoji_warned
+                    if not _custom_emoji_warned:
+                        _custom_emoji_warned = True
+                        logger.warning("האימוג'י המותאם (CUSTOM_EMOJI_ZIP_ID) נדחה ע\"י טלגרם — נופלים לאימוג'י רגיל")
             except Exception:
                 # בלי כפתורים אין דרך לממש את הבחירה — מנקים את הרשומה והקובץ שנוצרו עבור ה-ZIP הזה
                 cleanup_pending_zip(path)