סשן טלתון לטלגרם הוא מפתח, לא אפליקציה
סשן (session) טלתון לטלגרם הוא מפתח הרשאה (בדרך כלל קובץ SQLite עם סיומת .session או מחרוזת StringSession), לא חלון של אפליקציית טלגרם. הוא מאפשר לקליינט ה-Python שלכם לדבר MTProto בתור משתמש. אם לחצתם פעמיים על הקובץ וציפיתם לראות רשימת צ'אטים, הזמנתם את הפורמט הלא נכון. אם אתם צריכים ש-get_me() יחזיר אובייקט משתמש, זה המוצר בשבילכם.
מדריך זה מיועד למפתחים ומפעילים שכבר עובדים עם Telethon (או שמתכננים לעבוד), רוצים משלוח סשנים ממלאי קיים, וזקוקים לתהליך בדיקה ברור ואפשרות החלפה. הקטלוג המלא נמצא ב-חשבונות טלגרם. להסבר רחב יותר על ההבדלים בין חשבונות מוכנים, חדשים או ותיקים, קראו את המדריך על חשבונות טלגרם מוכנים.
נקודות מרכזיות
- סשן טלתון הוא קובץ מפתח הרשאה או StringSession, לא חלון של אפליקציית דסקטופ.
- בחרו Session (Telethon) בעמוד חשבונות טלגרם; אותו מלאי, משלוח שונה.
- בדיקה חיה: התחברו עם
api_id/api_hashשלכם, ואז קראו לפונקציהget_me().- שנו את האימות הדו-שלבי (2FA) לאחר קבלת הגישה; התייחסו לכל עותק נוסף של המפתח כאל פרצת אבטחה.
- מפתחות מתים (
AuthKeyUnregistered, מספר טלפון שגוי) הם עילה להחלפה, לא עבודה של עריכת קובץ SQLite.
מה זה בעצם סשן טלתון?
סשן טלתון הוא מפתח ההרשאה שקליינט ה-Python שלכם משתמש בו כדי לתקשר בפרוטוקול MTProto בתור משתמש. Telethon יוצר אותו כאשר אתם בונים אובייקט כמו TelegramClient('anon') ומשלימים את תהליך ההתחברות. לאחר מכן, הקובץ עצמו הוא ההתחברות.
בתוך קובץ .session טיפוסי תמצאו פרטים טכניים אך חיוניים: לאיזה דאטה סנטר להתחבר, מפתח ההרשאה שמצפין את התעבורה כדי שטלגרם תזהה את התהליך כאותו משתמש, ומטמון (cache) של ישויות שהקליינט ראה. המטמון יכול להפוך את הקובץ לגדול יותר מ"מפתח קטן", אך הוא לא הופך אותו לקובץ יצוא של צ'אטים שניתן לקרוא. אל תפתחו את קובץ ה-SQLite בחיפוש אחר הודעות. הבדיקה החיה היא חיבור מוצלח.
StringSession הוא אותו מפתח, אך מקודד כמחרוזת טקסט. זה נוח בסביבות עבודה שמחקות את מערכת הקבצים שלהן. זה גם קל יותר להדלפה. כל מי שמחזיק במחרוזת יכול להתחבר כאותו משתמש. שמרו מחרוזות כאלה במנהל סודות (secret store), לא במאגר הקוד (repository). התחברות חיה אחת יכולה להפוך לשני מפתחות אם אתם מייצאים אותה; ספרו את העותקים.
טוקן של בוט הוא אובייקט שלישי: סוד HTTP עבור ה-Bot API. זה אינו סשן של משתמש. אם הבדיקה שלכם דורשת ממשתמש ללחוץ על כפתור Start, אתם צריכים סשן משתמש. אם הבדיקה דורשת מהבוט לענות, אתם צריכים את הטוקן.
איך קונים משלוח מסוג Session / Telethon ב-TgFather?
ב-TgFather אתם בוחרים במשלוח מסוג Session (Telethon) מאותו קטלוג חשבונות שבו נמצאים חשבונות TData. היכנסו לחשבונות טלגרם, בחרו Session, ואז את המדינה וטווח הגיל. המשלוח הוא מיידי לאחר חיוב הארנק. ההורדות זמינות דרך קישורים חתומים ומוגבלים בזמן.
אתם קונים פורמט משלוח, לא סוג אחר של חשבון. בחרו Session כי הקוד שלכם משתמש ב-Telethon. בחרו TData אם משתמש אנושי עובד עם Telegram Desktop. בחרו קוד התחברות חי אם אתם רוצים להקליד אותו בקליינט שבשליטתכם. בחירת פורמט שגוי, גם אם הוא "נשמע רציני", עדיין לא מתאימה למשימה שלכם.
אם get_me() נכשל על סשן שקיבלתם, זו עילה להחלפה, לא ויכוח על מבנה קובץ ה-SQLite. הריצו בדיקה משלכם לפני שאתם בונים תהליכי פרודקשן על המפתח.
האם לבחור בסוג הסשן לפני שבוחרים מדינה?
כן. הגדירו קודם כל את פורמט המשלוח, ורק אז בחרו את המדינה וטווח הגיל. היכנסו לחשבונות טלגרם, בחרו Session (Telethon), בחרו מדינה וטווח גיל, ושריינו חשבון שתוכלו לבדוק עוד באותו היום.
איזו בדיקה חיה כדאי להריץ?
הריצו חיבור אמיתי ובדיקת get_me() עם api_id ו-api_hash משלכם לפני שאתם סומכים על הקובץ. אל תסמכו על קובץ רק בגלל שהסיומת שלו היא .session. אל תסמכו על מחרוזת רק כי היא ארוכה.
מה שאתם רוצים לראות:
- חיבור מוצלח.
- קבלת אובייקט משתמש בחזרה.
- מזהה משתמש (ID) ומספר טלפון תואמים לחשבון שחשבתם שקניתם.
שם משתמש ייצוגי (vanity username) יכול להשתנות. המזהה (ID) לא. אי-התאמה בשם המשתמש היא שאלה לתמיכה. אי-התאמה במספר הטלפון אומרת שזה אדם אחר.
מצבי כשל:
- לא ניתן להתחבר: זה לא סשן חי.
- מתחבר, ואז דורש סיסמת ענן שלא קיבלתם: נעילה שנייה חסרה.
AuthKeyUnregistered: המפתח בקובץ כבר לא רשום. זהו פריט למזכרת. בקשו החלפה; אל תנסו לערוך ידנית את קובץ ה-SQLite.
הצלחה של get_me() מוכיחה שהמפתח עדיין יכול לתקשר. היא לא מוכיחה "ותק ופעילות". לאחר הצלחה, הגדירו או שנו את האימות הדו-שלבי. סיסמת ענן נועלת התחברויות חדשות; היא לא שואבת קבצי סשן שכבר יצאו. אם קיבלתם סיסמת ענן עם הסשן, שנו אותה. אל תשתמשו באותה סיסמה מהטלגרם האישי שלכם.
טלתון מול StringSession מול TData מול טוקן של בוט
קבצי סשן של Telethon ו-StringSession הם מפתחות משתמש; TData מיועד ל-Desktop; טוקן של בוט מיועד ל-Bot API. התאימו את הפורמט למשימה שלכם לפני שאתם משלמים.
Telethon .session |
StringSession | TData | טוקן של בוט | |
|---|---|---|---|---|
| מה זה | קובץ SQLite עם מפתח הרשאה + מטמון | אותו מפתח בפורמט טקסט | ספריית עבודה של Telegram Desktop | סוד HTTP עבור בוט |
| מה פותח את זה | Telethon | Telethon | Telegram Desktop | Bot API / כל קליינט HTTP |
| נראה כמו אפליקציה? | לא | לא | כן, בדסקטופ | לא |
| בדיקה חיה | חיבור + get_me() |
חיבור + get_me() |
הגדרות מציגות את המספר | getMe ב-Bot API |
| התייחסות | כמו לסיסמה | כמו לסיסמה שקל להדביק | כמו לסיסמה בתוך תיקייה | כמו לסיסמה |
גם Telethon וגם Pyrogram מדברים MTProto ושניהם כותבים "סשנים". אבל הקבצים שלהם אינם ניתנים להחלפה. אל תזינו קובץ .session של Telethon לקליינט Pyrogram. אל תדביקו מחרוזת Pyrogram לתוך StringSession. אם הפרויקט שלכם הוא Pyrogram, קנו או צרו סשן של Pyrogram. רישומים שאומרים רק "סשן" מבלי לציין את הספרייה יבזבזו לכם את אחר הצהריים.
כיצד לאחסן ולהשתמש במפתח בבטחה?
אחסנו את קובץ הסשן או המחרוזת כמו סיסמה: בלי הדבקות, בלי קומיטים (commits) ובלי עותקים מיותרים. כל מי שמחזיק במפתח מחובר כאותו משתמש מכל מקום שבו הוא מריץ את הקליינט.
כללים מעשיים:
- אל תדביקו אותו בקבוצה "רק כדי לבדוק".
- אל תעשו לו קומיט למאגר הקוד.
- שתי מכונות עם שני עותקים זה שני מפתחות.
- אם תבטלו את השורה הלא נכונה ברשימת המכשירים של טלגרם, ה-
get_me()הבא ייכשל עם שגיאתAuthKeyUnregistered. - לאחר ה-
get_me()המוצלח הראשון, הפסיקו להתעסק. שימו את הקובץ במקום שהתהליך יכול לקרוא ממנו. התייחסו לכל עותק נוסף כאל פרצת אבטחה.
שימושים לגיטימיים: מערכת בדיקות שצריכה משתמש אמיתי שידבר עם בוט, סקריפט תמיכה ששולף צ'אט שאדם ביקש, או תיבת דואר נכנס בסביבת בדיקה (staging) עבור Mini App. קבלה על רכישה אינה אישור לשליחת הודעות ספאם.
צריכים חשבון דסקטופ לשימוש אנושי? השוו פורמטים במדריך על חשבונות טלגרם מוכנים. צריכים שם משתמש לבוט במקום מפתח משתמש? עיינו במדריך על בוטים ותיקים לטלגרם.
איפה קונים ומה מכסה ההחלפה?
קנו משלוח סשן בחשבונות TgFather; ההחלפה מכסה מפתחות מתים, לא טעויות באחסון סודות. התחילו בחשבונות טלגרם: בחרו Session (Telethon), מדינה וטווח גיל. שלמו מהארנק. הורידו מהקישור החתום. הריצו get_me(). שנו את סיסמת הענן. בנו את המערכות שלכם רק אחרי שהמפתח הוכח כחי.
מפתח מת (AuthKeyUnregistered, מספר טלפון שגוי, חוסר ב-2FA שהובטח לכם) הוא עילה להחלפה במלאי קיים, לא טיעון ש"ככה זה סשנים". שמרו על api_id / api_hash משלכם ועל אחסון סודות מאובטח. הקטלוג מספק את הפורמט; התהליך שלכם אחראי על ההיגיינה לאחר המסירה.
סשן טלגרם הוא מפתח ההרשאה הזה. Telethon היא ספריית הפייתון ששואלת את השאלה לטלגרם. אם חיפשתם משלוח Telethon, עדיין קניתם קובץ (או מחרוזת), לא חלון של אפליקציה.
כשתהיו מוכנים: קנו חשבונות טלגרם עם משלוח סשן.
שאלות נפוצות
מה זה StringSession בטלתון?
StringSession הוא מפתח ההרשאה שלך המקודד כשורת טקסט אחת, במקום להיות מאוחסן בקובץ .session. הוא מכיל את אותו מידע קריטי, כמו הדאטה סנטר ומפתח האימות. פורמט זה נוח לסביבות שבהן מערכת הקבצים היא זמנית. עם זאת, מכיוון שזהו רק טקסט, קל יותר להדליף אותו בטעות. יש לאחסן StringSession במנהל סודות, לא ישירות במאגר הקוד.
האם אני יכול לקרוא היסטוריית צ'אט מקובץ .session?
לא, אינך יכול לקרוא את היסטוריית הצ'אט ישירות מקובץ ה-.session. הקובץ הוא מסד נתונים של SQLite המכיל את מפתח ההרשאה שלך ומטמון של ישויות שהקליינט שלך ראה, לא ייצוא של הודעות. אם אתה צריך לגשת להודעות, עליך להשתמש בסשן עם קליינט Telethon חי כדי להתחבר לשרתי טלגרם ולאחזר אותן. אל תנסה לפתוח את הקובץ כדי לחפש הודעות.
האם אני צריך API ID משלי עבור סשן שנרכש?
כן, עליך להשתמש ב-api_id וב-api_hash משלך כאשר אתה מתחבר עם סשן טלתון שנרכש. קובץ הסשן עצמו הוא רק מפתח ההרשאה של המשתמש, בעוד שפרטי ה-API מזהים את היישום הספציפי שלך בפני טלגרם. הבדיקה החיה לאימות סשן חדש דורשת ממך להתחבר באמצעות פרטי ה-API שלך. זה מוכיח שהמפתח יכול לדבר בשם המשתמש דרך מופע היישום שלך.
האם עלי לשנות את סיסמת הענן בסשן חדש?
כן, עליך לשנות את סיסמת האימות הדו-שלבי, הידועה גם כסיסמת הענן, מיד לאחר אישור פעולת הסשן. סיסמת ענן נועלת ניסיונות התחברות חדשים ומוסיפה שכבת אבטחה. אם סופקה סיסמה עם הסשן, שנה אותה לסיסמה שרק אתה יודע. זה עוזר לאבטח את החשבון מפני כל אדם אחר שאולי הייתה לו גישה לפרטים המקוריים או לקובץ הסשן.