חיבור סוכן חדש למערכת - מדריך מקוצר

פקודה אחת מריצה את כל התהליך. המערכת שואלת אותך את הפרטים תוך כדי (כולל בחירת רשת מתוך רשימה), בודקת את עצמה בכל שלב, ובסוף מקבלים תשובה ברורה: הצליח / הצליח עם הערות / נכשל. עדכון אחרון: 24/07/2026.

לפני שמתחילים

תיאום: התחברות מרחוק לשרת מנתקת את מי שכבר מחובר אליו. תתאם רגע לפני שאתה נכנס. (אם החיבור נופל באמצע - פשוט מתחברים שוב, שום דבר לא נהרס.)
שעות: לא להריץ סביב 04:30, 07:00 או 14:00 - בשעות האלה רצות משימות אוטומטיות על אותם חשבונות טלגרם.
הטלפון של הסוכן: הסוכן חייב להיות זמין עם הטלפון של החשבון - יגיע אליו קוד התחברות בטלגרם.
רשת חדשה? אם הסוכן שייך לרשת שעוד לא קיימת במערכת - קודם יוצרים אותה במסך Directory (כפתור + New network בתוך "Add staff member"), ורק אחר כך מריצים את הפקודה. הפקודה עצמה אף פעם לא יוצרת רשתות.

התהליך

מתחברים לשרת מרחוק (עם הפרטים שכבר יש לך).

פותחים PowerShell כמנהל (קליק ימני על PowerShell ואז "Run as Administrator"), ועוברים לתיקייה: cd C:\JangoEye-repo

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

powershell -ExecutionPolicy Bypass -File deploy\onboard_agent.ps1 -AsSystem

המערכת תשאל אותך שלוש שאלות, אחת-אחת - פשוט עונים:

שם הסוכן (Agent name) - שם התצוגה באנגלית, זה מה שיופיע במערכת (למשל Ana).
שם המשתמש בטלגרם (Telegram username) - בלי ה-@ (למשל Ana_Wardogs).
רשת - המערכת תציג רשימה ממוספרת של כל הרשתות. מקלידים את המספר שליד הרשת הנכונה ו-Enter. אין צורך לזכור מספרי רשתות.

בחירה מהרשימה לא מבקשת אישור נוסף - בחרת שם, אין אפשרות לטעות. (ליודעי דבר: אפשר גם להריץ ישר עם כל הפרטים בשורה אחת - -AgentName "Ana" -TelegramUsername "ana_wardogs" -NetworkId 3 - ואז מבקשים אישור y על הרשת.)

התחברות טלגרם: כשהמסך מבקש, מקלידים את מספר הטלפון של חשבון הסוכן בפורמט בינלאומי (למשל +9725XXXXXXXX או +357XXXXXXXX), ואז את הקוד שהגיע לסוכן בטלגרם, ואם יש סיסמת אימות דו-שלבי - גם אותה.

קישור לבוט: כשהמסך מבקש, הסוכן פותח בטלפון שלו את @JangoEyeBot ולוחץ /start. הקישור נעשה אוטומטית. אם הסוכן עדיין לא לחץ, המסך יציע: [R] לבדוק שוב, [D] לסיים בינתיים בלי הפעלת הקצאות (מריצים שוב את אותה פקודה אחרי שהוא ילחץ), [A] לבטל.

איך יודעים שהצליח

ONBOARDING COMPLETE (ירוק)

הכל עבד. הסוכן מחובר, נמדד, ומקבל הקצאות. אין מה לעשות יותר.

אם כתוב "green with notes" עם שורות צהובות - הסוכן תקין ועובד, וההערות (למשל תיקיית טלגרם בשם לא מוכר) הן בשביל מאור. תעביר לו אותן, זה לא מעכב כלום.

ONBOARDING INCOMPLETE (צהוב)

בחרת [D] - הסוכן מאזין אבל עדיין לא מקבל הקצאות. אחרי שהוא ילחץ /start, מריצים שוב את אותה פקודה בדיוק והיא תסיים את מה שנשאר.

ONBOARDING FAILED (אדום)

צלם מסך של כל החלון ושלח למאור. שום דבר לא "נהרס" - המערכת לא מפעילה שליחת הקצאות לפני שהכל אומת, ואפשר תמיד להריץ שוב את אותה פקודה אחרי תיקון.

חשוב לדעת

אם טלגרם חוסם התחברות (FloodWait)

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

לא נוגעים

בקבצים שנגמרים ב-.session - לא למחוק, לא להעביר, לא לפתוח.
ב-Task Scheduler (המשימות המתוזמנות) - הפקודה מנהלת אותן לבד.
בקובץ .env שבתיקיית deploy.
בחלונות אחרים שפתוחים על השרת - הם מריצים את המערכת החיה.