Archived

This repository has been archived on 2026-07-19. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

T

PointStar 5aa98d2d3a docs: Task #9 — finalize ONBOARDING.md + add IT-SETUP.md

- ONBOARDING.md (Hebrew, lawyer-facing): corrected install URL (.vsto),
  ribbon group name (Marcus-Law), first-run flow (open from ribbon),
  added the four feature sections, troubleshooting table, file
  locations, support channels
- IT-SETUP.md (English, admin-facing): runner provisioning, codesign
  cert generation + Infisical storage + Gitea Actions secrets, GPO
  push of the public cert to attorney machines, nginx config for
  ClickOnce serving, per-user API key provisioning, release procedure,
  URL protocol install, monitoring + off-boarding + troubleshooting
  playbook

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-11 15:55:43 +03:00

7.0 KiB

Raw Blame History

התקנת OutlookAddin — מדריך לעו"ד

מה זה התוסף?

תוסף ל-Outlook שמאפשר לתייק מיילים ל-EspoCRM ישירות מתוך Outlook, בלי להעתיק/להדביק או להגדיר BCC. ארבע יכולות עיקריות:

תיוק מייל קיים — סמן מייל, לחץ "תייק ל-EspoCRM", בחר תיק/לקוח.
סרגל צד — כשפותחים מייל, צד ימין מציג איזה לקוח/תיק קשור לשולח.
כתיבת מייל מתיק — חלון מייל חדש מקבל כתובת+נושא לפי תיק נבחר, ומתויק אוטומטית כששולחים.
סנכרון תיקיות — Outlook יסמן או יתייק לבד מיילים שנכנסים לתיקיות שבחרת לנטר.

דרישות

Windows 10 / Windows 11
Outlook desktop (Microsoft 365 / Office 2021 / Office 2019)
.NET Framework 4.8 (כבר מותקן בכל הגרסאות הנתמכות)
חיבור אינטרנט ל-crm.prod.marcus-law.co.il
שם משתמש + API key אישי ב-EspoCRM (תקבל מהאדמין בנפרד)

התקנה (5 דקות)

סגור את Outlook לגמרי (File → Exit).
פתח את הלינק במייל שהאדמין שלח: https://platform.dev.marcus-law.co.il/outlook-addin/OutlookAddin.vsto
ייפתח דיאלוג ClickOnce. לחץ Install.
ההתקנה תיגמר תוך 30 שניות. אם רואים אזהרת "Unknown Publisher" — אל תאשר, פנה לאדמין; חסר אישור הצוות במחשב.
פתח את Outlook. בלשונית Home של תיבת הדואר תופיע קבוצה חדשה בשם Marcus-Law עם שני כפתורים.

הגדרה ראשונית

בפעם הראשונה שתלחץ על "תייק ל-EspoCRM" יישאל אותך התוסף אם לפתוח הגדרות. ענה כן.
בחלון ההגדרות, טאב כללי:
- כתובת שרת EspoCRM — מולא מראש: https://crm.prod.marcus-law.co.il
- שם משתמש — כתובת המייל שלך (לדוגמה chaim@marcus-law.co.il).
- מפתח API — הדבק את ה-key שקיבלת מהאדמין (נראה כמו a1b2c3d4e5f6…).
- שפת ממשק — עברית (ברירת מחדל) או English.
לחץ בדוק חיבור. אם רואים "התחברות תקינה — משתמש: …" בירוק, הכל עובד.
לחץ שמור. החלון ייסגר והתוסף יתחבר.

שימוש יומיומי

תיוק מייל קיים

סמן מייל אחד או יותר ב-Inbox (אפשר Ctrl-click או Shift-click).
בלשונית Home, לחץ "תייק ל-EspoCRM".
ייפתח חלון חיפוש — הקלד 2+ אותיות של שם תיק / לקוח / איש קשר.
סמן את התיק הנכון ולחץ תייק. המייל יקבל קטגוריה "Filed: <שם>" בעמודת הצבע.
אם השולח לא קיים ב-CRM, לחץ "צור איש קשר חדש מהשולח" כדי להוסיף אותו ולתייק אליו באותה פעולה.

סרגל "פרטי תיק" (צד ימין)

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

כתיבת מייל מתיק

פתח חלון מייל חדש (New Email).
בלשונית Message, לחץ "כתוב מתיק".
חפש ובחר תיק. התוסף ימלא אוטומטית את כתובת הנמען (איש קשר ראשי בתיק) ויוסיף בכותרת מספר תיק בסוגריים מרובעים, וקישור לתיק בסוף הגוף.
כתוב ושלח. כשתשלח, המייל יתויק אוטומטית לאותו תיק ב-EspoCRM, בלי שתצטרך לעשות שום דבר נוסף.

סנכרון אוטומטי של תיקיות

בלשונית Home לחץ "הגדרות" → טאב תיקיות.
סמן את התיקיות שאתה רוצה לנטר (לדוגמה Inbox / לקוחות / כהן).
בחר מצב:
- התרעה בלבד — Outlook יסמן את המייל ב-Categories עם "Needs filing" כדי שתראה ידנית.
- תיוק אוטומטי — התוסף יתייק לבד, רק אם הוא בטוח שהשולח הוא אותו לקוח (התאמה יחידה, חד-משמעית).
שמור. מהרגע הזה, כל מייל שמגיע לתיקיות האלה יעבור עיבוד מיידי.

עדכון התוסף

אין צורך להתקין מחדש. ClickOnce בודק עדכונים אוטומטית פעם בשבוע.
אם רוצים לכפות עדכון: File → Options → Add-ins → Click-Once Add-ins או פשוט סגור ופתח את Outlook כעבור 7 ימים.

בעיות נפוצות

בעיה	פתרון
קבוצת "Marcus-Law" לא מופיעה ב-Ribbon	File → Options → Add-ins → לוודא ש-`MarcusLaw.OutlookAddin` פעיל; אם לא — Add → Browse → בחר ב-`MarcusLaw.OutlookAddin.vsto`
"התוסף עדיין לא מוגדר"	פתח את ההגדרות והזן URL/שם משתמש/API key
"מפתח ה-API נדחה"	API key לא נכון או הוחלף — פנה לאדמין לקבל key חדש
"שגיאת חיבור לשרת"	אין אינטרנט או ה-CRM לא זמין — המיילים יישמרו בתור ויתויקו אוטומטית כשהחיבור יחזור
תיוק לקח הרבה זמן	בדוק את כרטיסיית Diagnostics בהגדרות; ייתכן שהשרת איטי או שיש תור גדול ב-`%LOCALAPPDATA%\MarcusLaw\OutlookAddin\retry-queue\`
Outlook איטי אחרי התקנה	סגור וטען מחדש את Outlook; אם נמשך, פנה לאדמין

איפה נשמרים הקבצים?

לוגים — %LOCALAPPDATA%\MarcusLaw\OutlookAddin\logs\addin-YYYYMMDD.log
הגדרות — %APPDATA%\MarcusLaw\OutlookAddin\settings.json
תור ניסיונות חוזרים — %LOCALAPPDATA%\MarcusLaw\OutlookAddin\retry-queue\*.json
API key — %APPDATA%\MarcusLaw\OutlookAddin\creds.dat (מוצפן DPAPI; לא ניתן לקרוא בלי המשתמש שלך)

דיווח על בעיה

שלח מייל ל-it@marcus-law.co.il.
צרף את התיקייה %LOCALAPPDATA%\MarcusLaw\OutlookAddin\logs\ בלחיצה ימנית → Send to → Compressed (zipped) folder.
תאר במשפט אחד מה ניסית לעשות ומה ראית במקום.

תמיכה

Mattermost — ערוץ #תמיכה-טכנית (לשאלות מהירות)
מייל — it@marcus-law.co.il
שעות פתוחות — יום שני 9:00–17:00, יום שלישי 9:00–13:00 בשבועיים הראשונים אחרי השקה

7.0 KiB Raw Blame History