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

chaim cf10db00a3 chore: scaffold Outlook VSTO Add-in for EspoCRM

Initial repo scaffold for a Windows VSTO/COM Outlook Add-in (C#/.NET FW 4.8)
that integrates Outlook desktop with EspoCRM via the existing MailRouter
v1.2.0 endpoint (POST /api/v1/MailRouter/file).

Includes:
- Solution + 4 csproj projects (host, Core, UI, Tests) under src/
- VSTO host project stub (ThisAddIn.cs, requires VS 2022 + Office workload to fully resolve)
- Core/UI/Tests as SDK-style net48 projects (NuGet: Polly, System.Text.Json,
  Serilog, CommunityToolkit.Mvvm, xUnit, Moq, FluentAssertions)
- .gitea/workflows/build.yml for Windows runner CI (publish/sign placeholders)
- docs/ARCHITECTURE.md (component diagram, threading model, per-feature flow)
- docs/ONBOARDING.md (Hebrew lawyer-facing install guide)

Server-side already in place: MailRouter v1.2.0 — see plan
~/.claude/plans/resilient-sauteeing-feather.md for the 6-week implementation
plan.

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

2026-05-11 09:05:07 +00:00

3.1 KiB

Raw Blame History

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

מה זה התוסף?

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

דרישות

Windows 10 או Windows 11
Outlook desktop (Microsoft 365 / Office 2021 / Office 2019)
חיבור אינטרנט
API key אישי ב-EspoCRM (תקבל מהאדמין)

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

סגור את Outlook לגמרי (File → Exit, או יציאה דרך System Tray).
פתח את הלינק: https://platform.dev.marcus-law.co.il/outlook-addin/setup.exe
לחץ "Install" בחלונית שתיפתח.
ההתקנה תיגמר תוך 30 שניות. אם רואים שגיאת "Unknown Publisher" — פנה לאדמין (חסר אישור הצוות).
פתח את Outlook. תראה ב-Ribbon תפריט חדש בשם "EspoCRM".

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

בפעם הראשונה ש-Outlook ייפתח, ייפתח חלון "ברוך הבא ל-EspoCRM Add-in".
כתובת השרת — מולא מראש: https://crm.prod.marcus-law.co.il
שם משתמש — כתובת המייל שלך (לדוגמה chaim@marcus-law.co.il).
API Key — הדבק את ה-key שקיבלת מהאדמין (נראה כמו a1b2c3d4e5f6...).
לחץ "Test Connection". סימן ✓ ירוק = הכל עובד.
לחץ "Save & Continue".

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

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

בחר מייל אחד או יותר ברשימה.
לחץ "File to EspoCRM" ב-Ribbon.
חפש את שם התיק או הלקוח, בחר, לחץ "File".
המייל יקבל קטגוריה צבעונית "Filed: <שם>" בעמודת הצבע ב-Outlook.

מי הלקוח?

כשפותחים מייל, סיידבר ימני יופיע עם פרטי הלקוח/התיק (אם קיים ב-EspoCRM).
לחץ "Open in EspoCRM" כדי לעבור ישירות לתיק.

כתיבת מייל חדש מתוך תיק

ב-EspoCRM, פתח תיק → לחץ "Email this case".
Outlook ייפתח עם כתובת + נושא ממולאים אוטומטית.

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

לחץ "Settings" ב-Ribbon → טאב "Folders".
סמן את התיקיות שאתה רוצה לנטר (לדוגמה Inbox/Smith Family).
בחר "Auto-file when confident" או "Notify only".
מיילים שייכנסו לתיקיות האלו יסומנו/יתויקו אוטומטית.

בעיות נפוצות

בעיה	פתרון
Ribbon "EspoCRM" לא מופיע	File → Options → Add-ins → לוודא ש-MarcusLaw.OutlookAddin פעיל
"401 Unauthorized"	API key לא נכון או הוחלף — פנה לאדמין
"EspoCRM unreachable"	בדוק חיבור לאינטרנט; המיילים יישמרו בתור ויתויקו כשהחיבור יחזור
Outlook איטי אחרי התקנה	סגור וטען מחדש את Outlook

דיווח על בעיה

ב-Settings → טאב "Diagnostics" → לחץ "Send Diagnostic Logs". יווצר קובץ zip ב-%TEMP%. שלח אותו לאדמין.

3.1 KiB Raw Blame History