סוכני AI
איך ליצור סוכן אישי לוואטסאפ עם AI
11 min de lecturaAmichai Shekel
מדריך לבניית סוכן AI לוואטסאפ עם Claude Code: יצירת בוט לוואטסאפ, חיבור ידע עסקי ויומן, זיכרון ו־5 פרומפטים להעתקה.
לקוחות שואלים שוב על השירותים שלכם. מישהו רוצה לקבוע שיחה. אתם עונים, בודקים ביומן, מעתיקים פרטים ומתחילים מחדש עם הפנייה הבאה. סוכן בוואטסאפ יכול לקחת חלק מהעבודה הזאת, בתנאי שמגדירים לו מידע, כלים וגבולות ברורים.
במדריך הזה בונים בהדרגה: קודם סוכן שמחזיר תשובה בוואטסאפ, אחר כך מוסיפים ידע עסקי, ורק אחרי שהבסיס עובד מחברים יומן וזיכרון. המדריך מבוסס על שיחת הכנה מ־7 בספטמבר 2026, ונערך למדריך עצמאי. הפרומפטים בהמשך הם נוסחים מעובדים לשימוש, ולא ציטוטים מלאים מההקלטה.
1 · סוכן AI לוואטסאפ · בוחרים משימה אחת
התחילו מעוזר שעונה על שאלות לגבי העסק ומציע לתאם שיחת היכרות. זו מטרה שאפשר לבדוק: האם הוא ענה לפי המידע שסיפקתם, והאם קבע פגישה רק במועד פנוי ורק אחרי אישור?
- גרסה ראשונה: הודעת טקסט נכנסת ותשובה חוזרת באותו צ׳אט.
- גרסה שנייה: תשובות על שירותים מתוך מסמך שאישרתם.
- גרסה שלישית: בדיקת זמינות והצעת מועדים ביומן ייעודי.
- גרסה רביעית: יצירת פגישה מאושרת ושמירת ההקשר הנחוץ להמשך השיחה.
2 · מבינים מה כל כלי עושה
- Claude Code הוא כלי הבנייה. עובדים איתו בתוך תיקיית הפרויקט, והוא כותב ומתקן את הקוד.
- Kapso מחבר את מספר הוואטסאפ ומעביר הודעות אל השירות שלכם וממנו.
- OpenAI API מספק את המודל שמפרש את ההודעה ומנסח תשובה.
- Vercel מארח את הקוד שמקבל בקשות ומחזיר תשובות. לא צריך להשאיר את המחשב האישי דלוק לשם כך.
- Maton מאפשר לחבר אפליקציות כמו Google Calendar דרך API עם הרשאות שאישרתם.
- Supabase הוא אפשרות לשמירת נתונים מתמשכת. מוסיפים אותו כשנדרשים היסטוריית שיחה, פרטי פנייה או מניעת פעולות כפולות.
המסלול הוא: לקוח כותב בוואטסאפ ← Kapso שולח אירוע לכתובת השרת שלכם ← הקוד מפעיל מודל וכלים מורשים ← התשובה נשלחת דרך Kapso ללקוח. חיבור כלי ל־Claude Code עוזר לבנות; הוא לא מחבר אוטומטית את אותו כלי לסוכן שירוץ בענן.
3 · מכינים תיקיית פרויקט וחשבונות
פתחו תיקייה חדשה, למשל whatsapp-agent, ובחרו אותה ב־Claude Code. ודאו שהוא מציג את הנתיב הנכון ויכול ליצור בה קובץ. הכינו חשבונות Kapso, OpenAI Platform ו־Vercel. את Maton ו־Supabase אפשר להוסיף בשלבים הבאים.
מפתח API הוא אמצעי גישה לחשבון. הזינו את הערכים דרך משתני סביבה מקומיים או מנהל הסודות, ולא בתוך הפרומפט המשותף. בקשו קובץ .env.example עם שמות משתנים בלבד, וודאו שקובצי הסודות מוחרגים מ־Git. אל תצרפו מפתחות לצילומי מסך, למצגות או לקבצים להורדה.
4 · מחברים מספר ל־Kapso
היכנסו ללוח הבקרה של Kapso וחפשו את אזור מספרי הטלפון. להדגמה בחרו מסלול בדיקה או מספר שמסופק על ידי השירות, בהתאם לאפשרויות שמופיעות אצלכם. קראו את התנאים והחיוב המוצגים לפני שממשיכים. אין במדריך הבטחה למספר חינמי או למחיר קבוע.
אם נפתח תהליך ההרשמה של Meta, בחרו את התיק העסקי הנכון ומלאו פרטי עסק אמיתיים. אם אין תיק עסקי, השלימו את ההקמה שהתהליך מבקש. בחרו את המספר המתאים ואשרו את החיבור. אל תחליפו מספר עסקי קיים כחלק מניסוי לפני שהבנתם את מסלול החיבור ואת השפעתו.
בסיום ודאו שהמספר מופיע כמחובר ושמרו את מזהה המספר שהאינטגרציה דורשת. צרו מפתח API בפרויקט Kapso המתאים. מספר ומפתח מחשבונות שונים הם מקור נפוץ לתקלות. חיבור רשמי אינו הבטחה שלא יהיו מגבלות שימוש.
5 · נותנים לסוכן גישה לתיעוד מעודכן
¿Van en serio con Claude Code?
¿Quieren dominar Claude Code desde cero?
Construyan paso a paso con cuatro sesiones grabadas, Skills y prompts listos, y acceso de por vida.
בתמלול כלי התיעוד נקרא בכמה שמות. במקום לנחש כתובת שרת, השתמשו בקישור הרשמי לתיעוד Kapso שמופיע בסוף המדריך. יש הבדל בין Docs MCP, שמשמש לקריאת תיעוד, לבין Project MCP, שיכול לבצע פעולות בחשבון.
אפשר לתת ל־Claude Code קישורי תיעוד בלי להתקין תוסף נוסף. אם מוסיפים MCP, השתמשו בהוראות הרשמיות לכלי שבו אתם עובדים ובדקו שהחיבור זמין לפני שממשיכים. אל תניחו שחיבור ב־Claude Chat זמין גם בפרויקט Claude Code.
6 · מגדירים את OpenAI API
היכנסו ל־OpenAI Platform, בחרו את הפרויקט הנכון והגדירו חיוב ב־Billing. החיוב של ה־API נפרד ממנוי ChatGPT. בדקו את הסכום והאפשרויות שמוצגים בחשבון; טעינה אוטומטית היא בחירה שלכם ולא תנאי במדריך.
צרו מפתח לפרויקט ושמרו אותו כמשתנה סביבה בצד השרת. בקשו מ־Claude Code לבדוק בתיעוד איזה מזהה מודל זמין ומתאים לתשובות טקסט, ולהריץ בקשת בדיקה קטנה. שמות מודלים שנאמרו בעל פה בתמלול אינם תחליף למזהה API מאומת.
7 · בניית בוט לוואטסאפ · הגרסה הראשונה
העתיקו את הפרומפט הבא ל־Claude Code בתוך תיקיית הפרויקט. מלאו את הסוגריים, אבל אל תדביקו לתוכו מפתחות. המטרה בשלב הזה היא שיחת טקסט עובדת, בלי יומן ובלי גישה למסמכים פרטיים.
בנה בפרויקט הנוכחי סוכן וואטסאפ לעסק [שם העסק]. מטרתו הראשונית: לענות בעברית להודעות טקסט נכנסות.
השתמש ב־Kapso לחיבור WhatsApp וב־OpenAI API למודל השפה. בנה שירות צד שרת שניתן לארח ב־Vercel, ללא צורך בממשק ניהול בשלב הראשון.
קרא תחילה את התיעוד הרשמי: https://docs.kapso.ai/llms.txt ואת תיעוד OpenAI. אמת את מזהה המודל הזמין בחשבון; אל תנחש שם מודל.
הנחה אותי בהגדרת משתני סביבה בלי להציג ערכי סודות. צור .env.example עם שמות בלבד, והחרג קובצי סודות מ־Git.
בנה נקודת קצה ל־webhook. אמת את חתימת Kapso לפי התיעוד, טפל רק בהודעות נכנסות ומנע עיבוד כפול לפי מזהה אירוע באחסון מתמשך המתאים לפריסה. אל תסתמך על זיכרון של תהליך יחיד למניעת כפילויות.
אל תיתן לסוכן גישה לכלי פיתוח, לקבצים אישיים או להרצת פקודות. הגבל את הניסוי למספרי בדיקה שאאשר.
הוסף טיפול בשגיאות, רישום תקלות ללא סודות והגבלת שימוש בסיסית. בדוק חתימה לא תקינה, אירוע חוזר וכשל של ספק המודל.
בסיום הצג מה עובד מקומית, אילו משתנים חסרים ומה צריך לעשות כדי לבדוק הודעה אמיתית. בקש אישור לפני פריסה או שליחת הודעת בדיקה לאדם אחר.מלאו את הפרטים בסוגריים. הדביקו ב-Codex עם Astra או בלשונית Work ב-ChatGPT, במסלול בתשלום.
8 · מעלים לשרת ומחברים webhook
Webhook הוא כתובת שאליה Kapso מודיע שהתקבלה הודעה. אחרי שבדיקות הקוד עוברות, מחברים את הפרויקט ל־Vercel, מגדירים את משתני הסביבה הנדרשים בסביבת הפריסה ומבצעים פריסה. לאחר מכן מגדירים ב־Kapso את כתובת נקודת הקצה שיצר הקוד, עבור המספר הנכון.
אין צורך לנחש את שם הנתיב. בקשו מ־Claude Code את הכתובת המלאה מתוך הפרויקט והפריסה. הגדירו אירוע של הודעה נכנסת ובדקו אימות חתימה ומניעת כפילויות. מגבלות זמן הריצה של Vercel מחייבות טיפול שמתאים לאורך המשימה; פעולה ארוכה עשויה לדרוש תור עבודה או מנגנון רקע מתאים.
נקודת הבדיקה: שלחו בעצמכם הודעה למספר הניסוי. בדקו שהאירוע הגיע לשרת, שהמודל החזיר תשובה ושהתשובה נראית בוואטסאפ. הכיתוב “Deployment Ready” מוכיח שהקוד נפרס, ולא שהשיחה עובדת.
9 · מוסיפים ידע עסקי שהלקוחות רשאים לקבל
סוכן שרץ בענן לא רואה אוטומטית את תיקיות המחשב או את הזיכרון של Claude Code. הכינו מסמך ידע נפרד: השירותים, קהל היעד, שעות הפעילות, קישורים מאושרים ומחירים רק אם הם עדכניים ומותרים לפרסום. תאריכי מפגשים מתחלפים צריכים מקור מעודכן או תהליך עדכון.
הוסף לסוכן את המידע שבמסמך [שם הקובץ שאישרתי]. השתמש בו בלבד כמקור לידע עסקי.
לפני הטמעה הצג לי את התוכן שייחשף ללקוחות. אל תאסוף מידע מכל הזיכרון שלך ואל תכלול מסמכים פנימיים, פרטי לקוחות או סודות.
הסבר היכן נשמר הידע ואיך מעדכנים אותו לאחר הפריסה. הפרד ידע עסקי קבוע ממידע מתחלף כמו תאריכי מפגשים וזמינות.
כאשר אין מקור לתשובה, הסוכן יאמר שאין לו מידע מאומת ויציע פנייה לאדם. אל תמציא מחיר, מועד או הבטחה עסקית.
בדוק שאלה שהתשובה לה קיימת, שאלה שהתשובה לה חסרה ובקשה לחשוף מידע פנימי.מלאו את הפרטים בסוגריים. הדביקו ב-Codex עם Astra או בלשונית Work ב-ChatGPT, במסלול בתשלום.
¿Van en serio con Claude Code?
Taller de Claude Code de cero a una web publicada
- 01Instalación de Claude Code desde cero con CLAUDE.md personalizado
- 02Creación de Skills para tareas recurrentes
- 03Agentes, automatizaciones y sitios web
- 04Cuatro sesiones grabadas y acceso de por vida
Taller grabado · pago único
297 ₪
Acceso de por vida · garantía de reembolso de 14 días
10 · מחברים יומן דרך Maton
ב־Maton מחברים Google Calendar ומאשרים את חשבון Google ואת ההרשאות המוצגות. בחרו יומן ייעודי לפגישות עם לקוחות. שמרו את מפתח Maton בצד השרת ובקשו שהקוד ישתמש בחיבור וביומן שבחרתם במפורש.
התחילו בקריאת זמינות. אחרי שהיא עובדת, הוסיפו יצירת פגישה. הסוכן צריך להציג תאריך מלא, שעה ואזור זמן, לבקש אישור, לבדוק שוב שהמועד פנוי ורק אז ליצור את האירוע. לקוח מקבל אפשרויות פנויות, לא את תוכן היומן הפרטי שלכם.
הוסף לסוכן כלי Google Calendar דרך Maton לפי התיעוד https://docs.maton.ai/.
השתמש רק בחיבור [מזהה החיבור המאושר] וביומן [מזהה היומן המאושר]. שמור מפתחות בצד השרת בלבד.
תחילה בדוק קריאת זמינות. שעות קבלת פגישות: [ימים ושעות]. משך פגישה: [דקות]. אזור זמן: Asia/Jerusalem.
הצע רק מועדים פנויים בתוך הכללים. אל תחשוף כותרות, משתתפים או פרטים של אירועים אחרים.
לפני יצירה הצג תאריך מלא, שעת התחלה וסיום, אזור זמן ופרטי הפונה. צור אירוע רק אחרי אישור מפורש ובדיקת זמינות חוזרת.
מנע יצירת אירוע כפול כאשר אותה בקשה מתקבלת מחדש. אל תוסיף מחיקה, שינוי אירועים קיימים או שליחת מיילים בשלב הזה.
בדוק שהאירוע נוצר ביומן הנכון. אל תכתוב ללקוח שהפגישה נקבעה לפני שקיבלת הצלחה מהכלי. אם הכלי נכשל, אמור זאת והצע המשך טיפול אנושי.מלאו את הפרטים בסוגריים. הדביקו ב-Codex עם Astra או בלשונית Work ב-ChatGPT, במסלול בתשלום.
11 · מוסיפים זיכרון כשיש צורך
יש 3 דברים שונים: מסמך הידע של העסק, ההודעות הקודמות בשיחה ונתונים שצריך לשמור להמשך כמו פגישה מאושרת. “הסוכן זוכר” לא אומר שכל אלה קיימים. שאלו מה נשמר, באיזה מקום ולכמה זמן.
Supabase יכול לשמש לשמירה מתמשכת, אבל אינו האפשרות היחידה. אין מספר קבוע של הודעות שהסוכן זוכר בלי מסד נתונים; זה תלוי בקוד. זיכרון זמני בשרת עשוי להיעלם בין הרצות. גם חיבור Supabase MCP לכלי הבנייה לא מחליף מימוש של שמירה ושליפה בסוכן עצמו.
בדוק איך הסוכן שומר כעת הקשר ומונע כפילויות. אם אין אחסון מתמשך מתאים, הוסף אותו באמצעות Supabase.
שמור רק מה שנחוץ: מזהה שיחה, מזהי הודעות שטופלו, הקשר מצומצם ופרטי פגישה שאושרה. הצע מדיניות מחיקה לשיחות לא פעילות והצג אותה לאישור.
בודד נתונים בין שולחים. אל תאפשר למשתמש לבחור מזהה של שיחה אחרת דרך טקסט ההודעה. אל תחשוף מפתחות בעלי הרשאות רחבות ללקוח.
בדוק המשך שיחה לאחר הפעלה מחדש, שני שולחים שונים, הודעה חוזרת ומחיקת נתונים לפי המדיניות שאושרה. הצג ראיות לבדיקה בלי לחשוף תוכן אישי.מלאו את הפרטים בסוגריים. הדביקו ב-Codex עם Astra או בלשונית Work ב-ChatGPT, במסלול בתשלום.
12 · בודקים את הסוכן לפני שנותנים ללקוחות גישה
- מענה: שלחו “היי” וודאו שמתקבלת תשובה אחת בלבד.
- ידע: שאלו על שירות קיים ועל שירות שלא מופיע במסמך. בדקו שהסוכן אינו ממציא.
- יומן: בקשו מועד פנוי ומועד תפוס. ודאו שלא נוצר אירוע לפני אישור.
- פרטיות: בקשו את הפגישות של לקוח אחר או את מפתח ה־API. לא אמור להיחשף מידע.
- התאוששות: בדקו כשל מבוקר של חיבור ביומן. הסוכן לא אמור להודיע שהצליח.
- רציפות: סגרו את כלי הפיתוח המקומי ושלחו הודעה. השירות שנפרס צריך לקבל אותה גם בלעדיו.
בדוק את הסוכן מקצה לקצה במספר וביומן הניסוי שאישרתי. אל תשלח הודעות לאנשים אחרים.
בדוק: מענה טקסט יחיד, ידע קיים, מידע חסר, חתימת webhook לא תקינה, אירוע כפול, שני שולחים, בקשת חשיפת סודות, בדיקת זמינות ויצירת פגישה רק אחרי אישור.
בדוק גם כשל של OpenAI וכשל של Maton. כשל אינו הצלחה: אל תציג הודעת אישור אם הפעולה לא בוצעה.
לכל בדיקה כתוב תוצאה צפויה, תוצאה בפועל והראיה הזמינה. הפרד בדיקות קוד מבדיקות אמיתיות בוואטסאפ וביומן. אל תסמן בדיקה שלא הרצת כעברה.
תקן את שורש התקלה והריץ שוב רק את הבדיקות המושפעות. סכם מה עדיין מונע פתיחה ללקוחות.מלאו את הפרטים בסוגריים. הדביקו ב-Codex עם Astra או בלשונית Work ב-ChatGPT, במסלול בתשלום.
13 · כשהסוכן לא עונה, בודקים לפי הסדר
¿Van en serio con Claude Code?
¿Quieren dominar Claude Code desde cero?
Construyan paso a paso con cuatro sesiones grabadas, Skills y prompts listos, y acceso de por vida.
- אין אירוע בשרת: בדקו את המספר, כתובת ה־webhook, סוג האירוע והאם הכתובת נגישה.
- האירוע מגיע אבל המודל נכשל: בדקו שם משתנה סביבה, הרשאת המפתח, חיוב ומזהה מודל. אל תדפיסו את המפתח ללוג.
- המודל ענה אבל אין הודעה בוואטסאפ: בדקו את תוצאת השליחה דרך Kapso ואת המספר המשויך.
- יש תשובות כפולות: בדקו זיהוי אירועים חוזרים וסינון של הודעות יוצאות.
- היומן הלא נכון נפתח: בדקו את מזהה החיבור ואת מזהה היומן. כניסה ל־Google לבדה אינה בחירה ביומן הנכון.
- הסוכן מפסיק לעבוד לאחר סגירת המחשב: בדקו אם ה־webhook עדיין מפנה לשרת המקומי במקום לפריסה בענן.
14 · עלויות ושאלות שעולות בדרך
כמה זה עולה? העלות מורכבת משירות WhatsApp, שימוש במודל, אירוח וחיבורים או אחסון לפי הצורך. המספרים והטענות על שימוש חינמי שנאמרו בשיחה אינם מחירון. בדקו את תנאי החשבון העדכניים בכל שירות, והתחילו בניסוי מוגבל עם מעקב שימוש.
צריך לדעת לתכנת? אפשר להשתמש ב־Claude Code לכתיבת הקוד, אבל עדיין צריך לבחור חשבונות, לאשר הרשאות ולבדוק את התוצאה. הפרומפט לא מחליף בדיקה שהודעה הגיעה ושהפגישה נוצרה במקום הנכון.
המנוי שלי ל־ChatGPT מספיק? לא לתשלום על שירות ה־API. לפי OpenAI, החיוב בפלטפורמת ה־API מנוהל בנפרד מהמנוי.
צריך את כל הכלים מראש? לא. מתחילים ממענה טקסט. יומן וידע עסקי הם יכולות נפרדות. גם שמירת מידע צריכה לשרת צורך מוגדר, ולא להיאסף סתם.
אפשר לחבר כמה חשבונות? Maton מבוסס על חיבורים לאפליקציות. אם מחברים כמה חשבונות, צריך לוודא שהקוד בוחר את החיבור הנכון. בדקו גם מגבלות בחשבון שלכם; המדריך לא מניח מספר חיבורים חינמי.
אפשר להעלות כל עוזר אישי ל־Vercel? קוד שרת שמגיב לבקשות יכול להתאים. שיחה או Routine בתוך אפליקציית Desktop אינם שירות עצמאי שאפשר פשוט להעלות. צריך לבדוק אילו קוד, כלים ומנגנון הפעלה נדרשים ולבנות בהתאם.
15 · ממשיכים ממשימה קטנה לתהליך שימושי
בחרו היום שאלה אחת שחוזרת בעסק, כתבו לה תשובה מאושרת ובדקו שהסוכן מחזיר אותה בוואטסאפ. אחרי שהשלב הזה עובד, הוסיפו את הפעולה הבאה. במועדון AI Master לומדים להפוך יכולות כאלה לתהליכי עבודה בעסק, עם הדרכה וקהילה שעוזרת להתקדם.
