אוטומציית מייל בעברית עם GWS

שלב 1: בדיקת התקנה ואימות GWS CLI

לפני הרצת פקודות Gmail, יש לוודא שה-GWS CLI מותקן ומאומת.

# בדיקה אם gws מותקן
gws --version

# התקנה אם חסר
npm install -g @google/gws

# אימות עם חשבון Google
gws auth login

# בדיקת סטטוס אימות
gws auth status

אם המשתמש לא ביצע אימות, יש להנחות אותו דרך gws auth login שפותח חלון דפדפן ל-OAuth. ה-CLI שומר טוקנים מקומית ומרענן אותם אוטומטית.

שלב 2: ניסוח ושליחת מיילים דו-לשוניים עברית/אנגלית

כשהמשתמש צריך לשלוח מייל מקצועי ללקוח ישראלי, יש לנסח את המייל בעברית כשפה ראשית עם חלק אנגלי אופציונלי מתחת.

מבנה מייל לתקשורת עסקית ישראלית:

שליחת מייל:

gws gmail send \
  --to "client@example.com" \
  --subject "הצעת מחיר - פרויקט פיתוח אתר" \
  --body "שלום רב,

מצורפת הצעת המחיר עבור פרויקט פיתוח האתר כפי שדובר.

סה\"כ: 15,000 ש\"ח (לא כולל מע\"מ)
תנאי תשלום: שוטף + 30

אשמח לתשובתך.

בברכה,
[שם]" \
  --dry-run

חשוב: תמיד להשתמש ב---dry-run קודם לתצוגה מקדימה. להסיר את הדגל רק לאחר אישור המשתמש.

עיצוב סכומים בשקלים (ILS):

• סימן השקל: ש"ח (שקל חדש)
• פורמט: 15,000 ש"ח (הפרדת אלפים בפסיק, סימן אחרי הסכום)
• עבור מע"מ: ציין לא כולל מע"מ או כולל מע"מ
• שיעור מע"מ: 17% (שיעור המע"מ הנוכחי בישראל)

שלב 3: רצפי תזכורות תשלום

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

דוגמה: תזכורת תשלום ידידותית

gws gmail send \
  --to "client@example.com" \
  --subject "תזכורת - חשבונית מס' 1042 לתשלום" \
  --body "שלום [שם הלקוח],

רציתי להזכיר שחשבונית מס' 1042 על סך 8,500 ש\"ח (כולל מע\"מ) טרם שולמה.

פרטי החשבונית:
- מספר חשבונית: 1042
- תאריך הפקה: 15.01.2026
- סכום: 8,500 ש\"ח
- תנאי תשלום: שוטף + 30
- תאריך פירעון: 15.02.2026

אשמח אם תוכל/י לטפל בכך.

תודה רבה,
[שם]" \
  --dry-run

עיצוב תאריכים לחשבוניות ישראליות:

• פורמט DD.MM.YYYY (תקן ישראלי)
• תנאי תשלום: שוטף + 30 (Net+30), שוטף + 45 (Net+45), שוטף + 60 (Net+60)

שלב 4: מיון תיבת דואר עם מודעות לעברית

שימוש ב-gws gmail triage לתיוג וארגון אוטומטי של מיילים משירותים ישראליים.

מבנה תוויות לפרילנסרים ישראלים:

הרצת מיון:

gws gmail triage \
  --label "בנקאות" \
  --from "leumi.co.il,bankhapoalim.co.il,discountbank.co.il,mizrahi-tefahot.co.il" \
  --dry-run

gws gmail triage \
  --label "חשבוניות" \
  --from "greeninvoice.co.il,morning-invoice.co.il,icount.co.il" \
  --dry-run

gws gmail triage \
  --label "ממשלתי" \
  --from "gov.il,taxes.gov.il,btl.gov.il,nevo.co.il" \
  --dry-run

שלב 5: הגדרת פילטרים לג'ימייל לדפוסים עסקיים ישראליים

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

# פילטר להתראות בנקאיות ישראליות
gws gmail filter \
  --from "leumi.co.il OR bankhapoalim.co.il OR discountbank.co.il" \
  --label "בנקאות" \
  --dry-run

# פילטר לשירותי חשבוניות (חשבשבת / חשבונית ירוקה)
gws gmail filter \
  --from "greeninvoice.co.il OR morning-invoice.co.il" \
  --label "חשבוניות" \
  --dry-run

# פילטר לגורמים ממשלתיים
gws gmail filter \
  --from "gov.il" \
  --label "ממשלתי" \
  --dry-run

שלב 6: שמירה על שעות עבודה ישראליות ושבת

בתזמון מיילים, יש לכבד את המנהגים העסקיים הישראליים:

תזמון שליחה בשעות עבודה:

# בדיקת השעה הנוכחית בישראל
TZ=Asia/Jerusalem date

# תזמון ליום עבודה הבא בבוקר אם מחוץ לשעות
gws gmail send \
  --to "client@example.com" \
  --subject "עדכון פרויקט" \
  --body "..." \
  --schedule "next Sunday 09:00" \
  --dry-run

לפני שליחת כל מייל, יש לבדוק:

1. האם זה יום שישי אחרי 14:00? אם כן, לתזמן ליום ראשון 09:00
2. האם זה יום שבת? אם כן, לתזמן ליום ראשון 09:00
3. האם זה אחרי 18:00 ביום חול? אם כן, לתזמן לבוקר למחרת 09:00
4. האם זה חג יהודי? אם כן, לתזמן ליום העבודה הבא

שלב 7: מעקב אחר מיילים נכנסים

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

# מעקב אחר חשבוניות חדשות משירותים ישראליים
gws gmail watch \
  --from "greeninvoice.co.il,morning-invoice.co.il" \
  --label "חשבוניות"

# מעקב אחר התראות בנקאיות
gws gmail watch \
  --from "leumi.co.il,bankhapoalim.co.il" \
  --label "בנקאות"

דוגמה 1: פרילנסר ישראלי שולח תזכורת תשלום

המשתמש אומר: "שלח תזכורת תשלום ל-david@techstartup.co.il על חשבונית 2045, 12,000 שקל, פג תוקף לפני 10 ימים"

פעולות:

1. חישוב תאריך הפירעון המקורי (לפני 10 ימים מהיום)
2. קביעת שלב ההסלמה: 8-21 ימים = "הודעה שנייה"
3. ניסוח מייל בעברית בטון מקצועי ונחרץ
4. עיצוב סכום כ-12,000 ש"ח
5. הכללת טבלת פרטי חשבונית
6. הרצה עם --dry-run תחילה לאישור המשתמש

gws gmail send \
  --to "david@techstartup.co.il" \
  --subject "תזכורת שנייה - חשבונית 2045 לתשלום" \
  --body "שלום דוד,

זוהי תזכורת שנייה לגבי חשבונית מס' 2045.

פרטי החשבונית:
- סכום: 12,000 ש\"ח
- תנאי תשלום: שוטף + 30
- סטטוס: באיחור של 10 ימים

אודה לטיפולך בהקדם.

בברכה,
[שם]" \
  --dry-run

תוצאה: מייל נוסח בעברית מקצועית עם עיצוב שקלים נכון, תצוגה מקדימה דרך dry-run לאישור המשתמש.

דוגמה 2: מיון אוטומטי של תיבת דואר עם תוויות בעברית

המשתמש אומר: "תארגן לי את תיבת הדואר, תתייג את כל המיילים מהבנקים ושירותי החשבוניות"

פעולות:

1. יצירת תוויות בעברית אם לא קיימות: בנקאות, חשבוניות, ממשלתי
2. הרצת מיון לבנקים ישראליים (לאומי, הפועלים, דיסקונט, מזרחי)
3. הרצת מיון לפלטפורמות חשבוניות (חשבשבת, חשבונית ירוקה, iCount)
4. הרצת מיון לגורמים ממשלתיים
5. דיווח סיכום של מיילים שתויגו

gws gmail triage --label "בנקאות" --from "leumi.co.il,bankhapoalim.co.il,discountbank.co.il,mizrahi-tefahot.co.il" --dry-run
gws gmail triage --label "חשבוניות" --from "greeninvoice.co.il,morning-invoice.co.il,icount.co.il" --dry-run
gws gmail triage --label "ממשלתי" --from "gov.il,taxes.gov.il,btl.gov.il" --dry-run

תוצאה: תיבת הדואר מאורגנת עם תוויות בעברית. מיילים בנקאיים תויגו תחת "בנקאות", חשבוניות תחת "חשבוניות", דואר ממשלתי תחת "ממשלתי".

דוגמה 3: תזמון מייל תוך כיבוד שבת

המשתמש אומר: "שלח עדכון פרויקט ללקוח, אבל עכשיו יום שישי אחר הצהריים"

פעולות:

1. בדיקת שעון ישראל הנוכחי: יום שישי 15:30 IST
2. קביעה שזה אחרי סף 14:00 של יום שישי (ערב שבת)
3. תזמון המייל ליום ראשון 09:00 IST במקום
4. הודעה למשתמש על תזמון מותאם שבת

gws gmail send \
  --to "client@example.com" \
  --subject "עדכון שבועי - פרויקט אתר" \
  --body "שלום,

מצורף עדכון שבועי לגבי התקדמות הפרויקט..." \
  --schedule "next Sunday 09:00" \
  --dry-run

תוצאה: המייל תוזמן לבוקר יום ראשון, תוך כיבוד ערב שבת. המשתמש עודכן ששליחות ביום שישי אחה"צ נדחות אוטומטית.

סקריפטים

• scripts/shekel-formatter.py -- עיצוב סכומי מטבע לתקן השקל הישראלי (ILS) עם סימון נכון. הרצה: python scripts/shekel-formatter.py --help

מסמכי עזר

• references/israeli-business-email-templates.md -- אוסף תבניות מייל בעברית לתרחישים נפוצים של פרילנסרים: הצעות מחיר, חשבוניות, מעקב, עדכוני פרויקט. יש להיוועץ בעת ניסוח מיילים מקצועיים בעברית ללקוחות ישראליים.
• references/gws-gmail-commands.md -- מדריך מהיר לפקודות gmail של Google Workspace CLI, דגלים ופורמטים של פלט. יש להיוועץ בעת בניית פקודות gws או פתרון שגיאות CLI.

שגיאה: "gws: command not found"

סיבה: ה-Google Workspace CLI לא מותקן או לא נמצא ב-PATH. פתרון: התקנה דרך npm install -g @google/gws. אם משתמשים ב-npx, להוסיף קידומת npx @google/gws לפקודות. אימות התקנה עם gws --version.

שגיאה: "Authentication required"

סיבה: המשתמש לא השלים את התחברות ה-OAuth או שהטוקן פג תוקף. פתרון: להריץ gws auth login להתחלת OAuth בדפדפן. אם הטוקנים פגו, להריץ gws auth refresh. בדיקת סטטוס עם gws auth status.

שגיאה: "Label not found" בהרצת מיון

סיבה: התווית בעברית עדיין לא קיימת בחשבון ה-Gmail של המשתמש. פתרון: Gmail יוצר תוויות אוטומטית בהרצת מיון ראשונה. אם השגיאה נמשכת, ליצור את התווית ידנית בהגדרות Gmail או להשתמש ב-gws gmail label create "בנקאות".

שגיאה: "Rate limit exceeded" בשליחת תזכורות מרובות

סיבה: API של Gmail מגביל שליחה ל-100 מיילים ביום לחשבונות צרכניים, 2000 לחשבונות Workspace. פתרון: לפזר שליחות על פני מספר ימים. להשתמש ב---schedule לפיזור מיילים. לצרכים בנפח גבוה, מומלץ לשדרג ל-Google Workspace Business.