פרק 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 לסוכן.