💬 פרק 1

מה מקבלים, חיבור וואטסאפ לסוכני AI

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

רוצים לחבר את הוואטסאפ ל-AI בלי להסתבך בהתקנות?

ב-NeoTech Vision פיתחנו את Connecta, מערכת WhatsApp MCP מוכנה, המתארחת בשרת המאובטח שלנו. במקום להקים ולתחזק שרת בעצמכם, נרשמים, מחברים את הוואטסאפ בסריקת QR ומגדירים את החיבור לכלי AI תומך, כמו Claude או ChatGPT.

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

להיכרות עם Connecta ולפתיחת חשבון:

מעדיפים להתקין בעצמכם על המחשב או השרת שלכם? המשיכו למסלולי ההקמה במדריך.

הארכיטקטורה מבוססת על חיבור מאובטח ומקומי. על גבי המחשב או השרת רץ מנוע קוד פתוח בשם GOWA, המקיים תקשורת מול פרוטוקול WhatsApp Web בדיוק כמו דפדפן רגיל. לצדו פועל שרת MCP (פרוטוקול Model Context Protocol), החושף את יכולות הוואטסאפ ככלים מובנים עבור סביבות פיתוח וסוכנים כגון קלוד קוד (Claude Code), קלוד דסקטופ, קרסור (Cursor) או גרוק CLI.

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

flowchart LR
    A["טלפון נייד (WhatsApp)"] <-->|"סריקת QR חד-פעמית"| B["מנוע GOWA (קונטיינר מקומי)"]
    B <-->|"REST API מקומי (127.0.0.1)"| C["שרת MCP (FastMCP Python)"]
    C <-->|"פרוטוקול MCP"| D["סוכן AI (Claude Code / Cursor / Grok)"]
    D -->|"טיוטה לאישור"| E["משתמש מאשר"]
    E -->|"אישור שליחה"| D

#שני מסלולי הקמה במדריך

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

1. מסלול ההודעה האחת המלאה (מומלץ): פרומפט מקיף אחד שמוזן לקלוד קוד. הסוכן מזהה את סביבת מערכת ההפעלה, מתקין את מנוע GOWA בתוך קונטיינר Docker מבודד, מנחה אתכם לסרוק ברקוד, בונה שרת FastMCP מלא עם עשרות כלים מתקדמים (קריאה, שליחה, תזמון מקומי ב-SQLite, טיפול במדיה וניהול קבוצות), ומחבר את כל הכלים לסביבות המקומיות והמרוחקות.
2. המסלול המודולרי: התקנה של מנוע GOWA בלבד ואימות החיבור. החל מגרסה v9, שרת ה-MCP ושרת ה-REST מאוחדים תחת הפקודה ./whatsapp rest. נקודת הקצה של MCP זמינה ישירות בנתיב /mcp ללא צורך בהפעלת תהליך נפרד, וניתן לחבר אליה ישירות כל סוכן תומך. מסלול זה מתאים למי שמעוניין בהתקנה מינימליסטית.

#מה זה מנוע GOWA

מנוע GOWA (ראשי תיבות של go-whatsapp-web-multidevice) הוא פרויקט קוד פתוח הכתוב בשפת Go. המנוע מתחבר לפרוטוקול התקשורת הרב-מכשירי (Multi-Device) של וואטסאפ ופועל כמכשיר מקושר עצמאי. החל מגרסה v8, המנוע מאפשר לחבר ולנהל מספר חשבונות וואטסאפ במקביל על גבי אותו מופע שרת יחיד.

המנוע מספק:

• ממשק REST API מלא לשליחה וקבלה של הודעות, קבצים, אנשי קשר, סקרים, עדכוני סטטוס ומדבקות.
• שרת MCP מובנה המוגש כברירת מחדל בנתיב /mcp באותו תהליך של שרת ה-REST, עם תמיכה אפשרית באימות OAuth 2.1.
• ניהול מספר מכשירים דרך נקודות קצה ייעודיות תחת /devices. שיוך קריאה למכשיר ספציפי נעשה באמצעות כותרת X-Device-Id או פרמטר device_id (כאשר מחובר מכשיר אחד בלבד, הוא נבחר כברירת מחדל).
• ממשק משתמש מקומי בדפדפן לצפייה במצב החיבור וסריקת קוד QR. החל מגרסה v9, לוח הבקרה מנוהל כקובץ עצמאי בשם gowa-ui.html מתוך המאגר aldinokemal/gowa-ui. השרת מוריד אותו בעת ההפעלה, מוודא את חתימת ה-SHA-256, שומר אותו במטמון תחת storages/ui/ ומגיש אותו בנתיב /.
• תמיכה בהפעלת ממשק משתמש מרוחק (Remote UI) באמצעות כותרות CORS.
• תמיכה באימות Basic Auth והגבלת האזנה לכתובת מקומית (APP_HOST=127.0.0.1).
• מנגנון Webhooks להעברת אירועים בזמן אמת, כולל חתימת HMAC-SHA-256 בכותרת X-Hub-Signature-256, סינון אירועים, סינון כתובות JID, ואפשרות להגדרת Webhook עצמאי לכל מכשיר (PATCH /devices/:device_id/webhook).
• אחסון נתוני הפעלה ומפתחות (Session Storage) על גבי מסד נתונים מקומי (ברירת המחדל היא file:storages/whatsapp.db) ואמצעי אחסון קבוע (Volume), כך שהחיבור נשמר גם לאחר אתחול.

[!IMPORTANT] מנוע GOWA אינו שירות ענן חיצוני ואינו WhatsApp Business API הרשמי של מטא. הוא מתנהג בדיוק כמו חיבור של WhatsApp Web בדפדפן נוסף, תחת רשימת "מכשירים מקושרים" בהגדרות הטלפון שלכם.

[!WARNING] מלכודות ושינויי גרסה קריטיים ב-GOWA:

1. החל מגרסה v6, הפעלת השרת מחייבת לציין את תת-הפקודה rest, למשל ./whatsapp rest.
2. החל מגרסה v8, בכל מופע המנהל יותר ממכשיר אחד, חובה להוסיף את הכותרת X-Device-Id או את הפרמטר device_id לקריאות ה-API כדי לשייך אותן לחשבון המתאים.
3. החל מגרסה v9, שרת ה-MCP אינו דורש פקודה נפרדת. השרת פועל בתוך פקודת rest בנתיב /mcp, והתת-פקודה הישנה mcp בוטלה.
4. יש להימנע משימוש באחסון מפתחות בזיכרון בלבד בסביבת עבודה קבועה, משום שאתחול השרת עלול לאבד את מצב החיבור של וואטסאפ.

#מה הסוכן מסוגל לעשות לאחר החיבור

במסלול ההקמה המלא, הסוכן מקבל גישה לקטלוג כלים רחב:

• קריאה ומודיעין: שליפת רשימת שיחות אחרונות, קריאת הודעות בהקשר מלא, חיפוש טקסט חופשי בהיסטוריה, איתור שיחות שלא נענו, וסריקת קבוצות.
• שליחה ומולטימדיה: שליחת הודעות טקסט, תמונות, מסמכי PDF ו-Word, קטעי אודיו, סרטוני וידאו, מדבקות סטטיות ומונפשות (בפורמט WebP בגודל 512x512), אנשי קשר, סקרים ופרסום עדכוני סטטוס.
• תיוג והפצה בקבוצות: תיוג משתמשים לפי מספר טלפון, וכן תיוג נסתר של כל חברי הקבוצה באמצעות מילת המפתח @everyone או שליחת רשימת מספרים בשדה mentions.
• תזמון ואוטומציה: שמירת הודעות מתוזמנות במסד נתונים מקומי מאובטח (SQLite) וביצוע שליחה במועד המדויק.
• ניהול וסדר: סימון הודעות כנקראו, סימון הודעות קוליות ככאלה שהושמעו, הוספת תגובות רגש (Reactions), הצמדת שיחות, דחייה אוטומטית של שיחות קוליות וניהול הרשאות קבוצה.
• עיבוד מסמכים ומדיה: תמלול הודעות קוליות וקריאת תוכן מתוך קבצים מצורפים.

#למי הפתרון מתאים

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

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

#תחנת העצירה הקריטית: סריקת הברקוד

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

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

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