<div dir="rtl" align="right">

# מפרט עשרת האוטומציות

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

---

## WF1 — אימות מסמכי מס
**קובץ:** `WF1 - Invoice Validation.json` · **טריגר:** Airtable, כל דקה · **Active**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `חשבונית חדשה` | סורק את `Invoices` כל דקה לפי השדה `Created` |
| 2 | `המתנה לסיום ההקלדה` | ממתין 90 שניות |
| 3 | `קריאת החשבונית מחדש` | קורא את הרשומה מ-Airtable עם הנתונים העדכניים |
| 4 | `בדיקת תקינות` | `Amount > 0` **וגם** `CustomerId` אינו ריק |
| 5 | `קריאת כל החשבוניות` | קורא את כל החשבוניות הקיימות |
| 6 | `ספירת חשבוניות` | Summarize — סופר אותן |
| 7 | `חישוב מעמ ומספר מסמך` | Edit Fields — מע"מ, סכום כולל, מספר מסמך רץ |
| 8 | `עדכון והכנסה לתור` | כותב חזרה ומסמן `Status = Ready` |
| 9א | `סימון כפסולה` | ענף "לא" — `Status = Invalid` |
| 9ב | `פתיחת משימת תיקון` | פותח משימה ב-`Tasks` |

**המסלול:** שלב 4 מתפצל — ענף "כן" ממשיך ל-5→6→7→8, ענף "לא" הולך ל-9א→9ב.

### למה יש המתנה בשלב 2

ב-Airtable הרשומה **נוצרת ברגע הלחיצה על `+`** — לפני שהמשתמש הספיק להקליד סכום
ולקוח. הטריגר מקבל תצלום של הרשומה מרגע היצירה, ולכן בלי ההמתנה כל חשבונית
שמוקלדת ידנית הייתה מסומנת `Invalid` תוך שנייה.

ההמתנה של 90 שניות נותנת זמן להקלדה, ואז `קריאת החשבונית מחדש` שולף את הנתונים
העדכניים מ-Airtable. **הצמתים שאחריו קוראים מהשליפה הטרייה ולא מהטריגר** —
זה מה שהופך את התהליך לאמין.

חשבונית שנוצרת דרך האפליקציה (WF13) מגיעה מלאה מלכתחילה, וההמתנה רק מעכבת
אותה ב-90 שניות.

**חישוב המע"מ** יושב בצומת `חישוב מעמ ומספר מסמך`:
```
שיעור     = Created >= 01/01/2025  ?  0.18  :  0.17
VatAmount = עיגול(Amount × שיעור, 2 ספרות)
Total     = עיגול(Amount + VatAmount, 2 ספרות)
```

**מספור רץ:** `INV-<שנה>-<מונה בן 4 ספרות>`, המונה = מספר החשבוניות + 1.
זו נקודת החולשה הידועה: שתי חשבוניות שנוצרות באותה דקה יקבלו אותו מספר.

---

## WF3 — קליטת לידים וסינון כפילויות
**קובץ:** `WF3 - Leads Intake.json` · **טריגר:** Webhook · **Active**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `קליטת ליד חדש` | Webhook שמקבל POST |
| 2 | `חיפוש ליד קיים` | מחפש ב-`Leads` לפי כתובת המייל |
| 3 | `האם ליד חדש` | החיפוש חזר ריק? |
| 4א | `יצירת ליד` | יוצר רשומה בסטטוס `New` |
| 4ב | `ספירת כפילויות` | Summarize — סופר רשומות קיימות לאותו מייל |
| 5א | `תשובה - נוצר` | מחזיר לאפליקציה `status: created` |
| 5ב | `תשובה - כפילות` | מחזיר לאפליקציה `status: duplicate` |

**בקשה:**
```json
POST /webhook/a35ea6d4-19c5-4c9d-be27-dc92d9a3a566
{ "name": "דנה לוי", "email": "dana@example.co.il", "company": "לוי טכנולוגיות" }
```

**תשובה:**
```json
{ "ok": true, "status": "created", "recordId": "rec...", "message": "הליד נוצר בהצלחה" }
{ "ok": true, "status": "duplicate", "existing": 1, "message": "הליד כבר קיים במערכת" }
```

הזיהוי הוא לפי כתובת מייל, בהתאמה מדויקת.

---

## WF4a — סוכן מכירות: מיילים קרים
**קובץ:** `WF4a - Sales Cold Emails.json` · **טריגר:** כל 3 שעות · **Active**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `כל 3 שעות` | Schedule Trigger |
| 2 | `שליפת ליד חדש` | `AND({Status}='New', {Email}!='')`, **ליד אחד** |
| 3 | `האם נמצא ליד` | אם אין — התהליך מסתיים בשקט |
| 4 | `ניסוח מייל קר` | מודל השפה כותב את גוף המייל בעברית |
| — | `מודל שפה` | תת-צומת: `gpt-4o-mini`, temperature 0.7 |
| 5 | `שליחת מייל` | Gmail, לכתובת שבשדה `Email` |
| 6א | `סימון נשלח מייל` | הצליח → `Status = Contacted` |
| 6ב | `סימון שליחה נכשלה` | נכשל → `Status = Email Failed` |

**כללי הכתיבה שנאכפים בפרומט:** עד 120 מילים · קריאה לפעולה אחת · בלי הבטחות
מחיר · בלי אימוג'ים · חתימה קבועה.

**למה ליד אחד:** מגבלה מכוונת. טעות בהגדרה לא תשלח עשרות מיילים.

---

## WF4b — סוכן מכירות: בדיקת תשובות
**קובץ:** `WF4b - Sales Reply Check.json` · **טריגר:** Gmail, כל 30 דקות · **Active**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `מייל נכנס` | Gmail Trigger, סריקה כל 30 דקות |
| 2 | `חילוץ כתובת השולח` | מחלץ מ-`From` את כתובת המייל הנקייה |
| 3 | `איתור ליד לפי מייל` | מחפש ב-`Leads` |
| 4 | `האם ליד מוכר` | מייל שאינו מליד — לא ממשיך |
| 5 | `סימון השיב` | `Status = Replied` |
| 6 | `התראה למנהל` | הודעת טלגרם לבוט המנהל |

החילוץ בשלב 2 הוא ביטוי רגולרי בתוך צומת `Edit Fields` — בלי צומת קוד.

בצומת `התראה למנהל` מוזן ה-Chat ID של הבעלים.

---

## WF5 — סוכן שירות לקוחות
**קובץ:** `WF5 - Customer Service Agent.json` · **טריגר:** בוט טלגרם #2 · **Active**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `הודעה מלקוח` | Telegram Trigger, בוט הלקוחות |
| 2 | `סוכן שירות לקוחות` | AI Agent — מחליט באילו כלים להשתמש ומנסח תשובה |
| 3 | `שליחת תשובה ללקוח` | Telegram |

**תת-צמתים המחוברים לסוכן:**

| צומת | תפקיד |
|---|---|
| `מודל שפה` | `gpt-4o-mini`, temperature 0.3 — צמוד לעובדות |
| `זיכרון שיחה` | 10 הודעות אחרונות, נפרד לכל לקוח לפי מזהה הצ'אט |
| `policies - מדיניות` | שליפה ממאגר `mypolicies` (נבנה ב-WF6) |
| `products - מוצרים` | שליפה ממאגר `theproducts` (נבנה ב-WF7) |
| `המרה לווקטורים` | ממיר את שאלת הלקוח לווקטור. מחובר לשני הכלים |

**גבולות שהוגדרו בהנחיה:** לא מאשר החזרים או הנחות חריגות · לא מבטיח תאריך
אספקה מדויק · לא מקבל פרטי אשראי או ת"ז · לא נותן ייעוץ משפטי או מיסויי ·
לא מדבר על מתחרים. אם המידע לא נמצא בכלים — אומר זאת מפורשות במקום לנחש.

---

## WF6 — מדיניות ← מאגר וקטורי
**קובץ:** `WF6 - Policies Embedding.json` · **טריגר:** טופס · **ידני לתמיד**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `טופס העלאת מדיניות` | טופס בדפדפן, מקבל כמה קבצים יחד |
| 2 | `מאגר וקטורי - מדיניות` | כותב תחת המפתח `mypolicies`, מנקה קודם |
| — | `המרה לווקטורים` | `text-embedding-3-small` |
| — | `טעינת המסמכים` | טוען את תוכן הקבצים |
| — | `חיתוך לקטעים` | 900 תווים, חפיפה 120 |

הטופס מקבל את כל 12 הקבצים מ-`data/policies/` בהגשה אחת.
`clearStore` מנקה את המאגר לפני כל טעינה, כדי שהרצה חוזרת לא תיצור כפילויות.

---

## WF7 — מוצרים ← מאגר וקטורי
**קובץ:** `WF7 - Products Embedding.json` · **טריגר:** טופס · **ידני לתמיד**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `טופס העלאת מוצרים` | טופס בדפדפן, קובץ CSV אחד |
| 2 | `מאגר וקטורי - מוצרים` | כותב תחת המפתח `theproducts`, מנקה קודם |
| — | `המרה לווקטורים` | `text-embedding-3-small` |
| — | `טעינת קובץ CSV` | CSV Loader — כל שורה היא מוצר |
| — | `חיתוך לקטעים` | 1,200 תווים (שורות המוצר ארוכות) |

**מודל ה-embeddings זהה בכל ארבעת המקומות** — WF6, WF7, WF5, WF13.
אם מודל אחד שונה, השליפה תחזיר תוצאות אקראיות.

**סדר ההרצה:** קודם WF6, אחר כך WF7.

---

## WF8 — הפקת מסמך חשבונית
**קובץ:** `WF8 - Invoice Document Builder.json` · **טריגר:** כל דקה · **Active**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `כל דקה` | Schedule Trigger |
| 2 | `איתור חשבונית בתור` | `AND({Status}='Ready', {PdfUrl}='')`, אחת |
| 3 | `האם יש חשבונית` | אין — מסתיים בשקט עד הסריקה הבאה |
| 4 | `הכנת נתוני המסמך` | תאריך `dd/mm/yyyy`, אחוז מע"מ, סכומים עם הפרדת אלפים |
| 5 | `בניית HTML` | **כאן יושבת תבנית החשבונית** — שדה `html` |
| 6 | `המרה ל-PDF` | PDFShift — מרנדר את ה-HTML בדפדפן ומחזיר PDF |
| 7 | `העלאה לגוגל דרייב` | אפשר לבחור תיקייה ייעודית במקום השורש |
| 8 | `שמירת קישור המסמך` | `PdfUrl` = הקישור ל-PDF, `Status = Issued` |

תבנית המסמך יושבת בצומת `בניית HTML`, בשדה `html`.

---

## WF9 — סוכן המנהל
**קובץ:** `WF9 - Manager Agent.json` · **טריגר:** בוט טלגרם #1 · **Active**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `הודעה מהמנהל` | Telegram Trigger, בוט המנהל |
| 2 | `האם זה הבעלים` | השוואה ל-Chat ID של הבעלים |
| 2ב | `סירוב גישה` | כל מי שאינו הבעלים — סירוב מנומס, בלי נתונים |
| 3 | `קריאת חשבוניות` | עד 100 חשבוניות |
| 4 | `סיכום כללי` | Summarize — סך Total, סך Amount, סך VatAmount, ספירה |
| 5 | `קריאת מה שלא שולם` | `NOT({Status}='Paid')` |
| 6 | `סיכום שלא שולם` | Summarize — סכום ומספר |
| 7 | `סוכן המנהל` | AI Agent — מקבל את המספרים מוכנים ומנסח תשובה |
| 8 | `שליחת תשובה למנהל` | Telegram |

**תת-צמתים:** `מודל שפה` (temperature 0.2) · `זיכרון שיחה` (6 הודעות).

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

בצומת `האם זה הבעלים` מוזן ה-Chat ID של הבעלים.

**מגבלות שהגדרתי בכוונה:** לסוכן אין כלים, הוא אינו יוצר משימות בעצמו, והוא רואה
עד 100 חשבוניות.

---

## WF13 — Webhook לאפליקציה
**קובץ:** `WF13 - App Webhook.json` · **טריגר:** POST מ-Base44 · **Active**

| שלב | צומת | מה קורה |
|---|---|---|
| 1 | `בקשה מהאפליקציה` | Webhook — מקבל `{ action, table, payload }` |
| 2 | `ניתוב לפי פעולה` | Switch על `action` |
| 3א | `סוכן האפליקציה` | ענף `chat` — AI Agent עם שני כלי RAG |
| 4א | `תשובה - שיחה` | מחזיר `{ ok, reply }` |
| 3ב | `קריאת רשומות` | ענף `list` |
| 4ב | `תשובה - רשימה` | מחזיר `{ ok, table, records }` |
| 3ג | `הכנת רשומה חדשה` | ענף `create` — פורש את `payload` |
| 3ד | `יצירת רשומה` | Airtable create |
| 4ג | `תשובה - נוצר` | מחזיר את הרשומה |
| 3ה | `הכנת עדכון` | ענף `update` — `payload` חייב לכלול `id` |
| 3ו | `עדכון רשומה` | Airtable update |
| 4ד | `תשובה - עודכן` | מחזיר את הרשומה |
| 4ה | `תשובה - פעולה לא מוכרת` | כל `action` אחר — HTTP 400 |

**תת-צמתים של הסוכן:** `מודל שפה` · `זיכרון שיחה` · `policies - מדיניות` ·
`products - מוצרים` · `המרה לווקטורים`.

זו **נקודת הכניסה היחידה** של האפליקציה למערכת. מפתח ה-Airtable יושב רק
כאן, ב-Credential של n8n — האפליקציה לא מכירה אותו בכלל.

| action | גוף הבקשה | תשובה |
|---|---|---|
| `chat` | `{ action, message, sessionId? }` | `{ ok, reply }` |
| `list` | `{ action, table, limit? }` | `{ ok, table, records }` |
| `create` | `{ action, table, payload }` | `{ ok, action, record }` |
| `update` | `{ action, table, payload }` — `payload` חייב לכלול `id` | `{ ok, action, record }` |

שמות טבלה מותרים: `Invoices` · `Leads` · `Products` · `Tasks`.
שם הטבלה מתורגם למזהה בתוך ביטוי בצומת Airtable, כך שהאפליקציה שולחת שם
קריא ולא מזהה פנימי.

**דוגמאות:**
```json
{ "action": "list", "table": "Invoices", "limit": 50 }
{ "action": "create", "table": "Leads",
  "payload": { "Name": "דנה לוי", "Email": "dana@example.co.il",
               "Company": "לוי טכנולוגיות", "Status": "New" } }
{ "action": "update", "table": "Invoices",
  "payload": { "id": "recXXXX", "Status": "Paid" } }
{ "action": "chat", "message": "כמה חשבוניות פתוחות יש לי?" }
```

---

## איפה יושב כל דבר

| מה | איפה בדיוק | איך עורכים |
|---|---|---|
| מסמכי המדיניות | `data/policies/` (12 קבצים) | עורכים את הקובץ ומריצים שוב את WF6 |
| קטלוג המוצרים | `data/products/products.csv` | עורכים ומריצים שוב את WF7 |
| תבנית החשבונית | WF8 ← `בניית HTML` ← שדה `html` | עורכים בתיבת הטקסט |
| הנחיות סוכן שירות | WF5 ← `סוכן שירות לקוחות` ← System Message | שדה טקסט בצומת |
| הנחיות סוכן מנהל | WF9 ← `סוכן המנהל` ← System Message | שדה טקסט בצומת |
| הנחיות סוכן האפליקציה | WF13 ← `סוכן האפליקציה` ← System Message | שדה טקסט בצומת |
| פרומט המייל הקר | WF4a ← `ניסוח מייל קר` ← שדה Text | שדה טקסט בצומת |
| ה-Chat ID של הבעלים | WF9 ← `האם זה הבעלים` · WF4b ← `התראה למנהל` | שני מקומות |
| המאגר הווקטורי | בזיכרון של n8n | נבנה מחדש בהרצת WF6 + WF7 |
| מסמכי החשבוניות | Google Drive | תיקייה רגילה בדרייב |

---

## שמות הצמתים

כל 84 הצמתים נושאים שמות בעברית. תשעה מהם מוזכרים גם בתוך ביטויים — למשל
`{{ $('הודעה מהמנהל').item.json.message.chat.id }}`. n8n אינו מעדכן ביטויים אוטומטית בעקבות שינוי שם, ולכן שינוי שם של אחד
מהתשעה האלה ישבור את התהליך:

| תהליך | צומת שמוזכר בביטויים |
|---|---|
| WF1 | `חשבונית חדשה` |
| WF3 | `קליטת ליד חדש` |
| WF4a | `שליפת ליד חדש` |
| WF4b | `חילוץ כתובת השולח` |
| WF5 | `הודעה מלקוח` |
| WF8 | `בניית HTML` |
| WF9 | `הודעה מהמנהל`, `סיכום כללי` |
| WF13 | `בקשה מהאפליקציה` |

75 הצמתים הנותרים אינם מוזכרים בשום ביטוי.

</div>
