איך מחברים סוכן AI לקבוצת וואטסאפ?

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

למה אי אפשר פשוט להשתמש ב-API הרשמי של וואטסאפ?

ה-Groups API של Meta מאפשר לעסק רק ליצור קבוצות משלו, שמצטרפים אליהן דרך קישור הזמנה ומוגבלות ל-8 אנשים. אין נקודת קצה שמאפשרת להצטרף לקבוצה שכבר קיימת בין שני חשבונות רגילים. המגבלה האחת הזו פוסלת כל פלטפורמה מבוססת-API רשמי למשימה הזו. כל דבר שכן מסוגל להצטרף לקבוצה שלכם רוכב על קליינט לא רשמי מתחת.

איך מקימים את זה, שלב אחר שלב?

שלושה חלקים עושים את העבודה: מספר טלפון ייעודי שמתווסף לקבוצה כחבר רגיל, קליינט לא רשמי של מכשיר מקושר שבנוי על Baileys (ספריית WhatsApp Web שעברה הנדסה לאחור) ומאפשר לשרת לשלוח ולקבל בתור המספר הזה, וסביבת ריצה של סוכן, OpenClaw, בתור המוח. שישה שלבים, בערך שעתיים.

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

כל הודעה

OpenClaw על VPS קטןמחובר כאותו מספר, כמו מכשיר מקושר (Baileys)

Claudeקורא, מסווג, ושותק אלא אם פונים אליו

כרטיסים ב-Linearמשימות, בלי כפילויות

ספריית מסמכיםניתנת לחיפוש

חזרה בקבוצהתשובות וסימוני אמוג'י

1. השיגו מספר ייעודי. eSIM או SIM נטענים מראש עם מספר סלולרי אמיתי, לא מספר VoIP (וואטסאפ חוסם אותם). רשמו חשבון וואטסאפ חדש עליו; אפליקציית ה-Business מאפשרת לו לחלוק טלפון עם החשבון האישי שלכם.

   whatsappNew number+1 555 0142 Registered · not VoIP

2. הקימו את OpenClaw וחברו אותו ל-Claude. כל VPS זול של 20–40 שקל לחודש מספיק. התקינו את OpenClaw, ואז תנו לו את מפתח ה-API של Anthropic כדי שהסוכן שלו ירוץ על מודל Claude. וואטסאפ מגיע כתוסף של OpenClaw. מדריך ההתקנה של OpenClaw מכסה התקנה וצימוד מקצה לקצה.

   openclaw$ openclaw start OpenClaw running connected to Claude · API key set

3. צמדו את המספר. התחילו את ההתחברות לוואטסאפ וסרקו את קוד ה-QR מהטלפון של הבוט תחת מכשירים מקושרים, בדיוק כמו WhatsApp Web.

   link a deviceScan to pair Paired

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

   foundersFounders3 members bot added

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

   • "כל טקסט שאתה מייצר מתפרסם לקבוצה. בין קריאות כלים אל תוציא כלום; פלט הטקסט היחיד שלך הוא אסימון סיום שקט."
   • "שתוק כברירת מחדל. הגב רק אחרי שאתה באמת עושה משהו, והתגובה היא האישור: וי כשאתה יוצר כרטיס, תיקייה כשאתה מתייק מסמך. החלטה, שאלה, שיחת חולין, הודעה קולית, או כפילות של משהו שכבר מתועד, לא מקבלים שום דבר."
   • "לפני יצירת כרטיס, חפש כרטיס קיים. בקשה אחת לעולם לא מולידה חמישה כרטיסים."
   • "שאל 'האם פונים אליי?' לפני שאתה מסווג משהו, ועשה מזה מבחן חד־משמעי: כן רק אם יש תיוג מפורש שלך, המילה 'בוט' כפנייה ישירה אליך בכל מקום בהודעה (מילה ראשונה, מילה אחרונה, או באמצע המשפט: 'תגיד, בוט, מה פתוח'), תשובה להודעה ששלחת, או הודעה שמגיבה ישירות לדבר האחרון שאמרת, תיקון או שאלת המשך, צעד אחד בלבד. דיבור עליך בגוף שלישי ('הבוט לא הגיב') הוא לא דיבור אליך, וכשאתה לא בטוח מה משני אלה זה, זה לא. פקודה רגילה בין שני האנשים ('תתקן את הכפתור') היא הם שמחלקים עבודה זה לזה, אף פעם לא בקשה אליך."
   • "תיוג שלך מגיע כטקסט גולמי, לא כמטא־דאטה: האסימון המילולי @<bot-LID>, המזהה הפנימי של וואטסאפ לחשבון שלך, שהוא לא מספר הטלפון שלך ולא שם התצוגה שלך. ההוראות האלה מפרטות מילה במילה גם את אסימון המזהה שלך וגם את המספר שלך; כל אחד מהם בכל מקום בהודעה אומר שפונים אליך, ו-@ עם כל מספר אחר הוא אדם שמתייג אדם. תיוג ריק בלי בקשה עדיין מקבל תשובה קצרה אחת שמזמינה את הבקשה, אף פעם לא שקט."

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

   founderssamsend the deck by Friday✅↓FOU-214Send the deck by Fridaynew

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

   message-logLog · reconcileddeck by Friday→ticketinvestor update→ticketfix the login bug→ticket

העלות מהכיס היא בערך 25–45 שקל לחודש הכול כלול: כמה שקלים בודדים למספר והשאר ל-VPS. כל השאר הוא שימוש במודל על מפתח ה-API שלכם, שמשתנה לפי כמה הקבוצה עמוסה.

מה זה בעצם עושה עם ההודעות?

הקריאה היא החלק הקל; הערך הוא במה שקורה אחר כך.

• משימות הופכות לכרטיסי Linear. "תשלחו את מצגת המשקיעים עד יום שישי" הופך לכרטיס בצוות ה-Linear הנכון. Linear נשאר רשימת המשימות; הצ'אט חוזר להיות צ'אט. כשמשימה עוטפת פרטים של לקוח אמיתי, הכרטיס מתאר את הבעיה הטכנית ומשאיר את הלקוח בחוץ.

  linearLinear · FoundersFOU-214Send the deckTodoFOU-215Investor updateTodoFOU-216Fix the login bugTodo

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

  foundersReceipts✅ticket created📁document filed📌decision logged

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

  librarysearch the libraryQ3 pricing.pdfInvestor deck.pdf

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

  foundersyouwhat did we decide on pricing?botPaying customers only, from Q3.

• הוא עונה גם מתוך סיכומי הפגישות של הצוות. שאלו "מה החלטנו בפגישה לגבי התמחור?" והוא עונה מתוך הסיכומים של מתמלל ה-AI ומציין את תאריך הפגישה שממנה הוא מצטט, כך שאפשר לבדוק את התשובה.

• הוא יודע להסביר את עצמו. שאלו אותו "מה אתה יודע לעשות?" והוא מפרט מה הוא מטפל בו בשקט, מה אפשר לבקש ממנו, מילון של אישורי האימוג'י שלו, ושורה מפורשת שהשקט הוא מכוון ומשמעותו "ראיתי, אין מה לעשות".

איך מכילים את סיכון החסימה?

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

האם בוט אחד יכול לשרת כמה קבוצות ופרויקטים?

כן: הסשנים הם פר-קבוצה, כך שמספר בוט אחד יכול לשבת בהרבה קבוצות בלי שההקשרים יתערבבו, והנחיית מערכת פר-קבוצה ("הקבוצה הזו היא פרויקט B, הכרטיסים הולכים לצוות ההוא") מכסה את רוב המקרים. מכשול חיווט אחד: מפתח API של Linear רואה רק את סביבת העבודה שלו, אז פרויקט בסביבת עבודה אחרת של Linear צריך מפתח משלו. וזה עדיין מספר אחד, אז חסימה מפילה את כל הקבוצות בבת אחת; שמרו משתפי פעולה חיצוניים על מספר נפרד. הגבול הפר-קבוצתי חייב לחול גם על כל מה שהבוט קורא, לא רק על מה שהוא כותב: הבוט של כל קבוצה מוגבל לפגישות של הפרויקט שלה בלבד, כך שהבוט בקבוצה אחת לעולם לא יכול להעלות פגישות של פרויקט אחר. ברגע שמספר אחד משרת כמה קבוצות, ההגבלה הזו היא כל המשחק.

מה נדרש כדי לחבר כלי חיצוני כמו סיכומי פגישות?

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

מה נשבר קודם?

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

• הבוט תיאר את העבודה שלו לתוך הצ'אט. התיקון: כלל השקט משלב 5, בדיוק כפי שצוטט.
• הבוט הגיב לכל הודעה בודדת. בקבוצה של שני אנשים, אימוג'י על כל שורה הוא סוג של רעש בפני עצמו. התיקון: להפוך את השקט לברירת מחדל ואת התגובות לאישורים בלבד, ולקבע את מבחן "האם פונים אליי" כמבחן חד־משמעי (תיוג, "בוט" כפנייה ישירה בכל מקום בהודעה אבל אף פעם לא "הבוט" בגוף שלישי, תשובה לבוט, או תגובה ישירה לדבר האחרון שהבוט אמר) שנבדק לפני כל סיווג, כדי שפקודה רגילה בין שני האנשים לא תיחשב בטעות לבקשה לבוט.
• הבוט התעלם מתיוג אמיתי. וואטסאפ מוסר תיוג כאסימון טקסט גולמי, @ ועוד המזהה הפנימי של הבוט, שהוא לא מספר הטלפון שלו ולא שם התצוגה שלו, והקליינט לא מעביר לצדו שום מטא־דאטה של תיוג. כך ש"תגיב לתיוגים שלך" היה כלל שהבוט לא יכול לקיים. התיקון: בקשו ממישהו לתייג את הבוט פעם אחת, קראו את האסימון המילולי מתוך יומן ההודעות, והדביקו אותו ואת המספר של הבוט מילה במילה לתוך ההוראות.
• תגובות אימוג'י נכשלו בשקט בקבוצות. התיקון: אל תעבירו מזהה הודעה מפורש בקריאת התגובה; תנו לקליינט לזהות את המשתתף בעצמו.
• הודעה נעלמה במהלך אתחול סשן. התיקון: היומן משלב 6 והתיאום היומי; הסוכן יכול להיכשל, היומן לא.
• חריגות זמן העבירו את העבודה למודל הגיבוי הזול ביותר, שמציית לכללים גרוע יותר. התיקון: הגדילו את הזמן הקצוב, שימו מודל בדרג ביניים לפני הזול, וכתבו כל כלל בהנחה שהמודל החלש ביותר הוא זה שקורא אותו.
• התאמת מילות מפתח רופפת תייקה פגישות לפרויקט הלא נכון. סיכומים של מתמלל AI מזכירים מילים כמו "משפטי" או "לקוח" דרך אגב, וזה מספיק כדי להטעות התאמה מעורפלת. התיקון: שמרו על התאמה מחמירה, ותנו לכל דבר מעורפל לשבת בערימה לא ממוינת שאדם עובר עליה. ניחוש שנראה נכון גרוע יותר מתיבת נכנסות גלויה.
• בוט ששותק במכוון הוא בלתי ניתן לגילוי. אף אחד בקבוצה לא ידע במה הוא מטפל, והאימוג'ים שלו נראו שרירותיים. התיקון: לימדו אותו לענות על "מה אתה יודע לעשות?" עם מילון של האישורים שלו ושורה שאומרת שהשקט מכוון. הפכו את זה לסעיף חובה בהנחיות של כל בוט קבוצתי.

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

אפשר לדלג על ההקמה ולמסור את זה ל-Claude Code?

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

npx @meir-labs/skill-whatsapp-group-agent

המיומנות המלאה נמצאת כאן: whatsapp-group-agent. אותה אחת שאני מריץ, פחות הפרטים הספציפיים לשרתים שלי.

רוצים שזה ירוץ בקבוצה שלכם בלי לבנות בעצמכם?

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