דילוג לתוכן
כל מדריכי AI בתכל׳ס

סיכום לידים יומי עם מספרים שאפשר לבדוק

הקוד סופר את הפניות, ה-AI מציע במה להתחיל, והבדיקה עוצרת מספרים מומצאים.

בונים אוטומציותn8n · Google Sheets · Gemini API
המדריך נבדק בפועל. פרטי ההרצה ותאריך הבדיקה מופיעים בסוף המדריך.
מתחילים את התרגיל

מה יהיה לכם בסיום?

שורת סיכום ב-Summaries עם נתונים מחושבים והמלצת סדר טיפול שנבדקה.

מה להכין לפני שמתחילים

  • סביבת n8n וגיליון Leads תקין
  • מפתח Gemini API בפרויקט Google AI Studio עם מכסה זמינה, הנשמר במנהל Credentials
  • הרשאה להשתמש במודל gemini-2.5-flash או מודל תואם פלט JSON מובנה

כלים ועלויות

צריך סביבת n8n וחשבון Google בעל הרשאת עריכה. n8n Cloud עשוי לדרוש תשלום לאחר תקופת הניסיון; באירוח עצמי יש עלות ותפעול שרת. Gemini API מציע מכסות ותמחור לפי המודל והחשבון, ושימוש במסלול בתשלום מחויב בנפרד. בדקו את המכסה והתמחור בפרויקט לפני הרצה חוזרת; מנוי לאפליקציית Gemini אינו מבטיח מכסת API.

מתחילים מדוגמה ברורה

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

הקלט

ארבע הפניות שב-Leads.csv. בחישוב לזמן 2026-09-28T10:00:00Z יש 2 פניות בסטטוס new, 2 פניות באיחור ו-1 פנייה פתוחה ללא אחראי. רק שלוש הספירות נשלחות למודל, ללא שמות או אימיילים.

התוצאה הצפויה

שורה אחת לתאריך 2026-09-28 עם new_leads=2, overdue=2, unassigned=1 והמלצה להתחיל בפניות באיחור. הטקסט נבנה אחרי אימות המספרים והשדות. מספר שהומצא, שדה נוסף או המלצה ללא בסיס עוצרים את הכתיבה.

שלב אחר שלב

  1. מכינים נתונים ותהליך לבדיקה

    הורידו workflow.json ואת קובצי ה-CSV. ב-Google Sheets צרו מסמך בדיקה חדש. ייבאו כל CSV ללשונית חדשה ששמה זהה לשם הקובץ ללא הסיומת, ושמרו את שורת הכותרות באנגלית. ב-n8n פתחו תהליך חדש, בתפריט שלוש הנקודות בחרו Import from File ובחרו workflow.json. השאירו את התהליך לא פעיל. בתרגיל זה מייבאים Leads.csv ו-Summaries.csv. הסיכום הוא תמונת מצב נוכחית, לא מספר הפניות שנוצרו היום.

  2. מחברים את Google Sheets

    בכל צומת Google Sheets בחרו Credential to connect with והוסיפו Google Sheets OAuth2. ב-n8n Cloud התחברו לחשבון Google ואשרו גישה. באירוח עצמי הגדירו פרויקט Google Cloud, הפעילו Google Sheets API ו-Google Drive API, צרו OAuth client מסוג Web application והעתיקו אליו בדיוק את OAuth Redirect URL שמציג n8n. הזינו Client ID ו-Client Secret רק במסך Credentials. אם מסך ההסכמה במצב בדיקה, הוסיפו את חשבון הבדיקה כ-Test user. בחרו By ID בשדה Document והחליפו REPLACE_WITH_SPREADSHEET_ID במזהה שבכתובת המסמך בין /d/ ל-/edit. בחרו את אותו חשבון ומסמך גם בצומת הקריאה וגם בצומת השמירה. בצומת Save result בחרו Summaries והתאמה לפי summary_id. שמרו גם את priority ואת summary כעמודות.

  3. מגדירים גישת API בלי לחשוף מפתח

    בצומת AI summary בחרו Generic Credential Type ואז Header Auth. צרו credential חדש עם Name: x-goog-api-key ו-Value שהוא מפתח Gemini API שלכם מ-Google AI Studio. המפתח נשמר רק ב-Credentials, לא בכתובת הבקשה או בקובץ. ודאו שיש מכסה בפרויקט. כתובת ה-HTTP משתמשת ב-gemini-2.5-flash; אם מחליפים מודל, בחרו מודל שתומך ב-responseSchema ובדקו מחדש את הפלט.

  4. בודקים את הספירות לפני שפונים למודל

    ב-Calculate metrics של עותק בדיקה החליפו new Date().toISOString() בזמן now מתוך fixture.json. הריצו עד הצומת ובדקו 2, 2, 1. חדשים הם כל מי שבסטטוס new; איחור הוא new ללא קשר במשך 24 שעות או quote_sent שמועד מעקבו עבר; ללא אחראי כולל רק פניות שאינן סגורות.

  5. מריצים את המודל וקוראים את התוצאה

    הריצו את התהליך המלא. Prepare AI request מעביר ספירות בלבד. AI summary מחזיר claims ו-priority. Validate AI claims דורש כל מפתח פעם אחת, ערכים שלמים ושווים לספירות, והמלצה שיש לה נתון תומך. רק אז הוא מרכיב משפט מהתבנית ושומר אותו ב-Summaries.

  6. מוכיחים שמספר מומצא נעצר

    בעותק בדיקה נתקו את AI summary והוסיפו לפני Validate AI claims צומת Code שמחזיר תשובה מדומה עם new_leads=99. ודאו שהבדיקה נכשלת ושלא נכתבת שורה. החזירו את החיבור למודל ובדקו התאוששות. זו בדיקת כשל מכוונת; אין להציג את הפלט המדומה כתוצאת AI.

    return [{json:{candidates:[{finishReason:"STOP",content:{parts:[{text:JSON.stringify({claims:[{key:"new_leads",value:99},{key:"overdue",value:2},{key:"unassigned",value:1}],priority:"overdue"})}]}}]}}];

  7. מתזמנים ושומרים משמעות ברורה

    אחרי הבדיקות החזירו את Calculate metrics לזמן הנוכחי. הוסיפו Schedule Trigger יומי לשעה 09:00 וחברו ל-Read leads, עם Asia/Jerusalem ב-Workflow Settings. הפעלה באותו יום מעדכנת את אותה summary_id. בודקים את הסיכום בגיליון; התהליך אינו שולח אותו לאנשים.

כך זה נראה בהרצה

הרצה אמיתית ב-n8n עם Gemini על ארבע פניות לדוגמה. הספירות 2, 2 ו-1 אומתו מול החישוב ונשמרה שורת סיכום אחת בגיליון Summaries.
הרצה אמיתית ב-n8n עם Gemini על ארבע פניות לדוגמה. הספירות 2, 2 ו-1 אומתו מול החישוב ונשמרה שורת סיכום אחת בגיליון Summaries.

איך יודעים שזה עבד?

  • הספירות הן 2, 2, 1 בזמן הקבלה הקבוע.
  • ה-API מקבל שלוש ספירות בלבד ולא שמות, כתובות אימייל או תוכן פנייה.
  • שינוי מספר ל-99 נכשל לפני כתיבה; גם החלפת ערך בין שני שדות נבדקת לפי המפתח.
  • הרצה חוזרת באותו תאריך מעדכנת שורה אחת.
  • הסיכום מתאר מצב נוכחי והמלצה פנימית, ללא טענות על הכנסות או ביצועי מכירות.

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

בדקתם את התוצאה בעצמכם?

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

כשמשהו לא עובד

הגיליון לא מופיע או מתקבלת שגיאת הרשאה

בדקו שהחשבון שחובר ל-n8n יכול לערוך את מסמך הבדיקה. ודאו שמזהה המסמך הוחלף בשני הצמתים. חיבור OAuth שפג תוקפו דורש התחברות מחדש במסך Credentials.

מופיעות עמודות חדשות או שגיאת שדה לא מוכר

השוו את הכותרות ל-CSV, כולל אותיות קטנות וקו תחתון. בחרו Map Automatically וב-Handling extra fields בחרו Error. אין לשנות כותרת כדי להעלים שגיאה בלי לבדוק את הנתון.

ההרצה ירוקה אבל אין שורה חדשה

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

מתקבלת שגיאת אימות, מכסה או חיוב מהמודל

בדקו את Header Auth, את שם הכותרת x-goog-api-key ואת מצב המכסה בפרויקט Google AI Studio. גישה לאפליקציית Gemini אינה מחליפה מפתח API. אל תעקפו את השגיאה בכתיבת סיכום ריק.

הבדיקה עוצרת את תשובת המודל

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

הנתונים לא נראים כמו הפעילות של היום

new_leads כאן הוא מספר הפניות שעדיין בסטטוס new, גם אם נוצרו אתמול. לצורך מדידת פניות שנוצרו היום צריך מדד אחר עם סינון created_at.

Calculate metrics נכשל לפני קריאת המודל

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

קחו את זה לעבודה

הערכה כוללת את הקבצים הבאים:

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

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

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

איך המדריך נבדק

מצב הבדיקה
מאומת
תאריך הרצה
נבדק על ידי
בדיקת יישום Otomatzia
בדיקה חוזרת עד
2026-12-29T05:54:11Z

הכלים והגרסאות שנבדקו: n8n 2.40.7 · Google Sheets API v4 · Gemini API (gemini-2.5-flash)

  • docs/practical/evidence/daily-summary.json
  • צילום הרצה אמיתית 10; נתוני בדיקה סינתטיים בלבד.

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

מקורות להמשך

הצעד הבא שלכם