איך בונים סוכן וואטסאפ לעסק שלכם

מפגש בנייה חי · מספר וואטסאפ מאושר של Meta, מוח של OpenAI, ידיים של Maton ופריסה ל-Vercel. כל הפרומפטים, כל המחירים, וכל מקום שנתקענו בו בדרך.

איך בונים סוכן וואטסאפ לעסק שלכם

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

במפגש הבנייה הזה בנינו סוכן וואטסאפ מאפס, על מסך חי, מהרישום ועד הודעה ראשונה שהסוכן ענה עליה בפרודקשן. בלי n8n, בלי Make, ובלי לכתוב שורת קוד ידנית: Claude Code בונה את הקוד, Kapso נותן מספר וואטסאפ מאושר של Meta, OpenAI הוא המוח, ו-Maton מחבר את היומן והמייל.

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

מה הסוכן הזה עושה בפועל

  • לענות ללקוחות בוואטסאפ בעברית, בשפה חופשית, 24 שעות ביממה

  • לרוץ על מספר וואטסאפ עסקי מאושר של Meta · לא דרך חיבור אפור שנחסם

  • לדעת את המידע של העסק שלכם · שירותים, מחירים, מה שאתם מחליטים לחשוף

  • לפתוח אירוע ב-Google Calendar ולחבר כלים נוספים דרך Maton

  • לרוץ בענן על Vercel · המחשב שלכם יכול להיות כבוי

  • לזכור לקוח לאורך זמן דרך Supabase, ולא רק 15-20 הודעות אחרונות

הרעיון · זו לא משימת תכנות, זו משימת חיבור

הטעות הכי נפוצה היא לחשוב שבניית סוכן היא משימת תכנות. היא לא. היא משימת חיבור.

הסוכן עצמו הוא כמה עשרות שורות קוד שמישהו כבר כתב אלף פעם: מקבל הודעה, שולח אותה למודל שפה, מחזיר תשובה. מה שהופך אותו לשימושי הוא מה שמחובר אליו · מספר וואטסאפ רשמי, ידע על העסק, כלים לפעולה, ומקום לרוץ בו.

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

למה Kapso ולא חיבור אפור לוואטסאפ

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

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

Kapso הוא הגשר לחיבור הרשמי. הוא מנהל בשבילכם את התיק העסקי במטא, את אישור מספר הוואטסאפ ואת החיוב, ונותן API אחד נקי שהסוכן מדבר איתו. אתם לא צריכים להזין כרטיס אשראי במטא, ולא להתעסק עם Meta Business Suite.

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

הארכיטקטורה · פה, מוח, ידיים ובית

ארבעה רכיבים, כל אחד עם תפקיד אחד:

Kapso · הפה והאוזניים. מספר הוואטסאפ המאושר, ה-API והוובהוק שמעביר לסוכן כל הודעה נכנסת.

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

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

Vercel · הבית. השרת בענן שהסוכן חי עליו. בלעדיו הסוכן רץ רק כשהמחשב שלכם דלוק, וזה לא סוכן.

מכינים את Claude Code · Mintlify MCP קודם לכל

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

הפתרון הוא Mintlify MCP · חיבור שנותן לו לקרוא דוקומנטציה מעודכנת לבד, במקום שאתם תיכנסו לאתרים ותעתיקו לו קטעים ידנית. מוסיפים אותו פעם אחת ומרוויחים אותו בכל פרויקט.

מעתיקים את דף ההתקנה של Mintlify MCP, מבקשים מ-Claude Code להוסיף אותו, סוגרים את Claude Code ופותחים מחדש כדי שהחיבור ייטען.

אחרי כל הוספה של MCP צריך לסגור ולפתוח מחדש את Claude Code. בלי הריסטארט הוא פשוט לא רואה את החיבור החדש, ואז נראה שהכל שבור.

שלב 1 · מספר וואטסאפ מאושר בתוך עשר דקות

  1. נכנסים ל-Kapso ונרשמים עם חשבון גוגל · עדיף אימייל שלא נרשמתם איתו בעבר

  2. Phone Numbers ואז Setup Number · בוחרים באפשרות הראשונה, מספר שהם מספקים

  3. המערכת מעבירה לפייסבוק · מתחברים ובוחרים תיק עסקי, ואם אין, פותחים אחד בזריזות

  4. יצירת חשבון וואטסאפ ביזנס · שם, תחום עסקי ואתר. כל אתר יעבוד, זה שדה טכני

  5. הוספת מספר חדש · בוחרים אחד מהמספרים ש-Kapso מציע, ומאשרים

  6. ממתינים דקה עד שמופיע Phone Number Connected · מכאן יש לכם מספר וואטסאפ פעיל

שלוש דרכים לחבר מספר · ומה עולה כסף

יש שלוש אפשרויות בשלב המספר. מספר שהם מספקים הוא המהיר והיציב. חיבור למספר קיים מתאים למי שכבר יש לו מספר בענן. חיבור לאפליקציית WhatsApp Business הקיימת בטלפון עובד, אבל Kapso עצמם מסמנים אותו כפחות יציב.

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

שלב 2 · שלושת המפתחות שהסוכן צריך

  1. ב-Kapso נכנסים ל-Integrations ואז API Keys, יוצרים מפתח, נותנים שם ומעתיקים

  2. ב-OpenAI Platform נכנסים ל-Billing, מוסיפים אמצעי תשלום וטוענים 5 דולר. זה המינימום וזה מספיק

  3. מי שרוצה שקט נפשי מפעיל Auto Reload · כשהיתרה יורדת לדולר היא נטענת חזרה

  4. עוברים ל-API Keys, יוצרים Secret key, בוחרים פרויקט ומעתיקים

  5. ב-Maton מתחברים עם גוגל, מאשרים את ההרשאות לשירות שרוצים (למשל Google Calendar) ומעתיקים את ה-API key

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

שלב 3 · הפרומפט שבונה את כל הסוכן

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

שימו לב לשורה שמציינת את שם המודל במפורש. Claude Code לא מכיר מודלים שיצאו אחרי אימון המודל שלו, ובלי השורה הזאת הוא יבחר מודל ישן על דעת עצמו.

הפרומפט המלא · העתיקו כמו שהוא

I want to build a WhatsApp agent.

Use Kapso AI for the WhatsApp connection, and OpenAI as the language model.
Framework: Next.js, backend only. No visual interface, the whole product lives inside WhatsApp.

Here is my Kapso API key: <KAPSO_API_KEY>
Here is my OpenAI API key: <OPENAI_API_KEY>

Also add the Kapso MCP so you can configure things yourself instead of asking me to click around.
Use the Mintlify MCP to read the up to date documentation of both APIs. Do not rely on memory.

Store all keys in .env, never in the code.
When the code is ready, deploy it to Vercel and add all environment variables there.

מה קורה בזמן שהוא בונה

מכאן Claude Code עובד לבד. הוא קורא את הדוקומנטציה, בוחר סטאק (אצלנו TypeScript עם Next.js במצב API בלבד), ובונה את הרכיבים: וובהוק שמקבל הודעות מ-Kapso, שכבת סוכן שמדברת עם OpenAI, וניהול זיכרון בסיסי.

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

שלב 4 · פריסה ל-Vercel והודעה ראשונה

כשהוא מסיים, הוא שואל אם לפרוס. עונים Yes, deploy to Vercel and add the environment variables. הוא מעלה את הפרויקט, מזין את המפתחות בענן, ומחזיר כתובת חיה.

מי שאין לו חשבון Vercel פותח אחד בחינם עם אימייל. Vercel הוא לא רק לאתרים · זו מכונה וירטואלית בענן, בדיוק כמו VPS, רק שאתם לא מתחזקים אותה.

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

שלב 5 · לתת לסוכן ידע על העסק, בלי לדלוף

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

היתרון של בנייה ב-Claude Code הוא שהוא כבר מחובר למחשב שלכם ומכיר את החומרים. במקום להעתיק ידנית מסמכים, מבקשים ממנו לאסוף את מה שהוא יודע על העסק ולהטמיע בסוכן. הוא מייצר תיקיית Knowledge בפרויקט, והסוכן קורא ממנה.

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

הפרומפט להטמעת ידע העסק

I want you to take all the knowledge you have about my business and add it to the agent's knowledge base.
Only include information that customers are supposed to see: services, offering, general pricing, how to work with us.
Do not include internal data, costs, supplier names or private details.

שלב 6 · Maton · מכלי דיבור לכלי פעולה

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

מחברים את Maton לשירות שרוצים, מעתיקים את ה-API key שלו, ומבקשים מ-Claude Code להוסיף אותו כ-Tool. מהרגע הזה כל שירות שחיברתם ב-Maton זמין לסוכן: לפתוח אירוע ביומן, לקרוא מייל, לכתוב במסמך.

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

הפרומפט לחיבור Maton

Add Maton AI as a tool layer for the agent.
Here is my Maton API key: <MATON_API_KEY>
Start with Google Calendar: when a customer asks for a meeting, the agent should check availability and create the event.

שלב 7 · זיכרון אמיתי עם Supabase

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

התיקון הוא Supabase. נרשמים, יוצרים פרויקט בלחיצות Next, ואז לוחצים על Connect, בוחרים Claude Code, ומעתיקים את שורת ה-MCP. מדביקים אותה ל-Claude Code, מבקשים להוסיף, עושים ריסטארט, ואומרים לו לשמור שם את השיחות ואת פרטי הלקוחות.

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

הטיפ ששווה את כל המפגש: אחרי שבניתם את זה פעם אחת, בקשו מ-Claude Code ליצור Skill מהתהליך. הוא כבר זוכר כל מה שעשיתם. בפעם הבאה שתבנו סוכן ללקוח, מפעילים את ה-Skill והוא מנחה את התהליך שלב אחר שלב במקום שתתחילו מאפס.

כל הכלים במקום אחד

כל השירותים שהופיעו במפגש, בסדר שבו משתמשים בהם.

  • Kapso

    חיבור רשמי של מספר וואטסאפ עסקי, API ווובהוק

  • OpenAI Platform

    מפתח API וטעינת קרדיטים למודל השפה של הסוכן

  • Maton

    שכבת חיבור לגוגל קלנדר, ג'ימייל ועוד עשרות שירותים

  • Vercel

    פריסה לענן, כדי שהסוכן ירוץ גם כשהמחשב כבוי

  • Supabase

    מסד נתונים לזיכרון ארוך טווח ולנתוני לקוחות

  • Claude Code

    הכלי שבונה, בודק ופורס את כל הפרויקט

שאלות שחזרו במפגש

צריך לדעת לתכנת?

לא. כל הבנייה נעשית בפרומפטים בשפה חופשית, ו-Claude Code כותב ופורס. מה שכן צריך זה סבלנות לפתוח כמה חשבונות ולהעתיק מפתחות בין מסכים.

כמה זה עולה?

כ-5 דולר להתחלה. Kapso חינמי בחשבון חדש, Maton חינמי עד 30 חיבורים, Vercel ו-Supabase חינמיים בשלב הזה, והעלות היחידה היא טעינת קרדיטים ב-OpenAI. מעבר לזה משלמים למטא לפי הודעות, בהתאם למדיניות שלהם.

כמה זמן זה לוקח?

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

זה עובד גם כשהמחשב שלי כבוי?

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

אפשר לחבר את המספר העסקי הקיים שלי?

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

יש סיכון שהמספר ייחסם?

בחיבור הרשמי דרך Kapso, לא. גל החסימות מגיע משירותים לא רשמיים שיושבים על WhatsApp Web. זו בדיוק הסיבה לעבוד עם המסלול הרשמי גם אם הוא מסורבל יותר.

הסוכן יכול לדלוף מידע פנימי של העסק?

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

אפשר לחבר לסוכן עוד כלים חוץ מהיומן?

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

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

להצטרפות למועדון AI Master