מדריך וואטסאפ ל-AI בעברית

פרק 7

בדיקות תקינות ואימות חיבור המנוע

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

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

#1. בדיקת פעילות קונטיינר ה-Docker

יש לוודא שתהליך הקונטיינר רץ באופן יציב ואינו מבצע אתחולים חוזרים (CrashLoop).

במסוף הפקודות או בשיחה עם קלוד קוד:

תבדוק אם קונטיינר GOWA רץ, באיזה פורט הוא מאזין, וכמה זמן הוא פעיל (uptime).

או באמצעות פקודת מסוף ישירה:

docker ps --filter "ancestor=aldinokemal2104/go-whatsapp-web-multidevice" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

התוצאה הרצויה: קונטיינר פעיל (Up) המאזין על הפורט המוגדר (למשל 127.0.0.1:3100->3000/tcp).

#2. בדיקת זמינות ממשק ה-REST API

מנוע GOWA חושף נתיב בדיקה /app/status המאפשר לבדוק את סטטוס החיבור תחת אימות Basic Auth.

בקשה מקלוד קוד:

תבצע קריאת בדיקה מקומית (curl) לכתובת GOWA בנתיב /app/status עם פרטי ה-Basic Auth, ותציג לי את הסטטוס שהוחזר.

או בפקודת curl ידנית:

curl -s -u "USERNAME:PASSWORD" http://127.0.0.1:3100/app/status

תשובה תקינה מחזירה מבנה JSON הכולל code: 200 ומצב is_logged_in: true.

#3. אימות מצב המכשיר המקושר בטלפון

פתחו את אפליקציית וואטסאפ בטלפון:

  • הגדרות (או שלוש נקודות) > מכשירים מקושרים.
  • ודאו שהמכשיר שהגדרתם (לדוגמה: Claude GOWA) מופיע ברשימה עם סטטוס פעיל, ולא מציג הודעת "פג תוקף" או "נותק".

#מדריך פתרון תקלות לפי תוצאת הבדיקה

ממצא הבדיקהגורם אפשריפעולת תיקון מומלצת
הקונטיינר במצב Exitedמנוע Docker קרס או שהפורט היה תפוסבקשו מקלוד: "תבדוק את לוגי ה-Docker של GOWA, תתקן את הפורט ותפעיל מחדש בלי למחוק את ספריית data"
שגיאת 401 Unauthorized בבדיקת APIאי התאמה בסיסמת ה-Basic Authבקשו מקלוד: "תשווה את פרטי ה-Basic Auth בקובץ .env המקומי להגדרות הקונטיינר"
הדף נפתח אך מציג שוב קוד QRהסשן בטלפון נותק או שלא הוגדר Volume קבועסרקו את הקוד מחדש וודאו שתיקיית ./data מקושרת כראוי ב-Compose
הדף אינו נטען כללהפורט חסום מקומית או שהכתובת שגויהודאו שהכתובת היא http://127.0.0.1:3100 ולא נעשה שימוש ב-HTTPS מקומי

כאשר שלוש הבדיקות מציגות תוצאה חיובית, המערכת מוכנה לשלב הבא: חיבור שרת ה-MCP לסוכן.