📘 תיעוד 1

Go WhatsApp: בנוי לשימוש יעיל בזיכרון

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

התמיכה שלך עוזרת להבטיח שהפרויקט ימשיך להתוחזק ויקבל עדכונים שוטפים!

#תמיכה ב-ARM, AMD64 ו-MCP

הורדה:

• Release
• Docker Hub
• GitHub Container Registry

#צומת קהילה של n8n

• חבילת n8n
• עבור אל Settings → Community Nodes, הזן @aldinokemal2104/n8n-nodes-gowa, ובחר Install.

#שינויים שוברים

• v6

  • מצב REST דורש <binary> rest במקום <binary>.
    • דוגמה: ./whatsapp rest במקום ./whatsapp.
  • מצב MCP דרש <binary> mcp.
    • דוגמה: ./whatsapp mcp.

• v7

  • החל מגרסה 7.x, קבצים בינאריים נבנים באמצעות GoReleaser וניתן להוריד אותם מהשחרור האחרון.

• v8

  • תמיכה בריבוי מכשירים: כעת ניתן לחבר ולנהל מספר חשבונות WhatsApp בו זמנית במופע שרת יחיד.

  • API חדש לניהול מכשירים: נקודות קצה חדשות תחת /devices מנהלות מספר מכשירים.

  • חובת הגדרת טווח מכשיר (Device scoping): כל קריאות ה-REST API ברמת המכשיר דורשות כעת אחד מהשניים:

    • כותרת X-Device-Id, או
    • פרמטר שאילתה device_id.
    • אם רשום מכשיר אחד בלבד, הוא משמש כברירת מחדל.

  • הגדרת טווח מכשיר ב-WebSocket: התחבר אל /ws?device_id=<id> כדי להגדיר את טווח חיבור ה-WebSocket למכשיר מסוים.

  • תמיכה בממשק משתמש מרוחק: CORS מאפשר את הכותרות Authorization ו-X-Device-Id, כך שממשק אינטרנט עצמאי (לדוגמה, gowa-ui) שמתארח במקור אחר יכול לקרוא ל-API ישירות. GET /app/info חושף את הגרסה ומגבלות גודל המדיה. מכיוון שדפדפנים אינם יכולים להגדיר כותרות בחיבורי WebSocket, העבר /ws?device_id=<id>&authorization=<base64(user:pass)> כאשר Basic Auth מופעל (השתמש ב-TLS, פרטי ההזדהות גלויים ב-URL).

  • שינויים במבנה נתוני Webhook (Payload): כל נתוני ה-webhook כוללים כעת שדה ברמה העליונה בשם device_id שמזהה איזה מכשיר קיבל את האירוע:

    העתק

    {
      "event": "message",
      "device_id": "[email protected]",
      "payload": { ... }
    }

• v9

  • MCP ו-API מאוחדים תחת rest: MCP אינו עוד מצב או תהליך נפרד. הפעל ./whatsapp rest כדי להגיש גם את ה-REST API וגם את ה-MCP. ה-MCP זמין ב-/mcp (ללא פקודת משנה עצמאית mcp). ראה שרת MCP (Model Context Protocol) לפרטי הגירה.
  • ממשק המשתמש הועבר למאגר נפרד: לוח הבקרה ברשת אינו כלול עוד במאגר זה. כעת הוא נמצא ב-aldinokemal/gowa-ui ומופץ כקובץ עצמאי יחיד gowa-ui.html. השרת מוריד את שחרור לוח הבקרה האחרון בעת ההפעלה, מאמת את סיכום ה-SHA-256 שלו, שומר אותו במטמון תחת storages/ui/, ומגיש אותו ב-/. ראה לוח בקרה ברשת (gowa-ui) עבור הגדרות APP_UI_*, נעילת שרשרת אספקה ופריסה בסביבה מבודדת רשת (air-gapped).

#תכונות

• שליחת הודעות WhatsApp דרך ה-HTTP API. ראה docs/openapi.yaml לפרטים.

• תמיכה בשרת MCP (Model Context Protocol): שילוב עם סוכני וכלי AI באמצעות פרוטוקול סטנדרטי.

• MCP OAuth 2.1 אופציונלי: חיבור לקוחות MCP מרוחקים שאינם יכולים לספק כותרת Basic Auth. ראה MCP OAuth.

• אזכור משתמשים:

  • @phoneNumber
  • דוגמה: Hello @628974812XXXX, @628974812XXXX

• אזכורי רפאים (אזכור כולם): אזכור משתתפי קבוצה בלי להציג @phone בטקסט ההודעה.

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

• פרסום עדכוני סטטוס ב-WhatsApp.

• סימון הודעות שמע והודעות קוליות נכנסות כמושמעות.

• שליחת מדבקות: המרה אוטומטית של תמונות לפורמט מדבקה של WebP.

  • תמיכה בפורמטים JPG, JPEG, PNG, WebP ו-GIF.
  • שינוי גודל אוטומטי של תמונות ל-512×512 פיקסלים.
  • שמירה על שקיפות בתמונות PNG.
  • מדבקות WebP מונפשות נתמכות אך חייבות לעמוד בדרישות WhatsApp:
    • בדיוק 512×512 פיקסלים.
    • פחות מ-500 KB.
    • אורך של לא יותר מ-10 שניות.
    • אם מדבקה מונפשת אינה עומדת בדרישות אלה, שנה את גודלה לפני ההעלאה באמצעות כלי כגון ezgif.com.

• דחיסת תמונות לפני שליחה.

• דחיסת סרטונים לפני שליחה.

• התאמה אישית של שם מערכת ההפעלה המוצג כשם המכשיר המקושר ב-WhatsApp:

  • --os=Chrome או --os=MyApplication

• אימות בסיסי (Basic Auth) עם מספר פרטי הזדהות:

  • --basic-auth=kemal:secret,toni:password,userName:secretPassword
  • צורה מקוצרת: -b=kemal:secret,toni:password,userName:secretPassword

• תמיכה בפריסה תחת נתיב משנה:

  • --base-path="/gowa" מאפשר פריסה תחת נתיב כגון /gowa.

• יציאה (Port) ומצב ניפוי שגיאות (Debug) ניתנים להתאמה:

  • --port 8000
  • --debug true

• מענה אוטומטי להודעות נכנסות:

  • --autoreply="Don't reply to this message"

• סימון אוטומטי של הודעות נכנסות כנקראו:

  • --auto-mark-read=true

• הורדה אוטומטית של מדיה מהודעות נכנסות:

  • --auto-download-media=false משבית הורדות מדיה אוטומטיות (ברירת מחדל: true).

• התעלמות מהורדת מדיה מסטטוסים:

  • --ignore-status-media=true משבית הורדת מדיה מסטטוסים (ברירת מחדל: false).

• דחייה אוטומטית של שיחות נכנסות:

  • --auto-reject-call=true או WHATSAPP_AUTO_REJECT_CALL=true (ראה Webhook Payload עבור אירועי שיחות).

• נוכחות (Presence) ניתנת להגדרה בעת התחברות:

  • --presence-on-connect=unavailable או WHATSAPP_PRESENCE_ON_CONNECT=unavailable
  • available: סמן את החשבון כמחובר (משתיק התראות בטלפון).
  • unavailable: רישום שם ה-push מבלי להתחבר (ברירת מחדל, שומר על התראות בטלפון).
  • none: דילוג מלא על נוכחות (שם ה-push אינו נרשם, כך שאנשי קשר עשויים לראות - כשם).

• פעימת נוכחות יומית:

  • --presence-pulse-enabled=true או WHATSAPP_PRESENCE_PULSE_ENABLED=true (ברירת מחדל: true).
  • --presence-pulse-interval=24h שולט בתדירות שבה מבוצעת פעימה לכל מכשיר מחובר.
  • --presence-pulse-duration=5m שולט במשך הזמן שבו החשבון נשאר במצב available לפני חזרה למצב unavailable.

• Webhooks עבור הודעות שהתקבלו ואירועים אחרים:

  • --webhook="http://yourwebhook.site/handler"
  • צורה מקוצרת: -w="http://yourwebhook.site/handler"
  • ראה תיעוד נתוני Webhook לפרטים.

• Webhooks לכל מכשיר: לכל מכשיר יכולה להיות כתובת URL של webhook ומסנני אירועים משלו.

  • הגדרה דרך API: PATCH /devices/:device_id/webhook עם {"webhook_url": "https://device-webhook.site/handler"}.
  • קבלה דרך API: GET /devices/:device_id/webhook.
  • כאשר למכשיר יש webhook מותאם אישית, אירועים עבור אותו מכשיר נשלחים לכתובת הספציפית למכשיר.
  • כאשר לא מוגדר webhook למכשיר, אירועים נופלים לברירת המחדל של ה-webhook הגלובלי (--webhook).
  • הגדר את webhook_url כמחרוזת ריקה עם PATCH כדי לנקות אותו ולהשתמש ב-webhook הגלובלי.
  • הגדר את WHATSAPP_WEBHOOK_DEVICE_MERGE_GLOBAL=true (או --webhook-device-merge-global=true) כדי להפוך webhook של מכשיר לתוספת במקום תחליף: כתובות ה---webhook הגלובליות עדיין יקבלו את אירועי המכשיר (חתומים באמצעות הסוד הגלובלי, מסוננים לפי WHATSAPP_WEBHOOK_EVENTS) בעוד שכתובת ה-URL של המכשיר שומרת על הסוד ומסנן האירועים שלה.

• חתימות Webhook: בקשות Webhook כוללות חתימת HMAC-SHA-256 בכותרת X-Hub-Signature-256, שנוצרת באמצעות מפתח ברירת המחדל secret.

  שנה את המפתח באמצעות:

  • --webhook-secret="secret"

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

• סינון אירועי Webhook: סנן אילו אירועים מועברים ל-webhook שלך באמצעות:

  • --webhook-events="message,message.ack" (רשימה מופרדת בפסיקים), או
  • WHATSAPP_WEBHOOK_EVENTS=message,message.ack.

  אירועי Webhook זמינים:

  Event	תיאור
  message	הודעות טקסט, מדיה, איש קשר, מיקום
  message.reaction	תגובות אימוג'י להודעות
  message.revoked	הודעות שנמחקו/בוטלו
  message.edited	הודעות שנערכו
  message.ack	אישורי מסירה וקריאה
  message.deleted	הודעות שנמחקו עבור המשתמש
  chat_presence	מחווני הקלדה והקלטה מאנשי קשר
  group.participants	אירועי הצטרפות, עזיבה, קידום והורדה של חברי קבוצה
  group.joined	צורפת לקבוצה
  label.edit	מטא-נתונים של תווית WhatsApp השתנו
  label.association	תווית הוחלה על צ'אט או הוסרה ממנו
  newsletter.joined	נרשמת לניוזלטר/ערוץ
  newsletter.left	ביטלת הרשמה לניוזלטר
  newsletter.message	הודעות חדשות שפורסמו בניוזלטר
  newsletter.mute	הגדרת השתקת ניוזלטר השתנתה
  call.offer	התקבלה שיחה נכנסת

  אם הגדרה זו ריקה, כל האירועים מועברים.

• סינון JID ב-Webhook

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

  • --webhook-ignore-jids="@g.us,[email protected]" (רשימה מופרדת בפסיקים), או
  • [email protected].
  • תומך בתווים כלליים מסוג @g.us / @s.whatsapp.net / @lid (התאמה למרחב כתובות שלם) וב-JID מדויקים.
  • פעולה זו מסננת לפי שיחה או שולח ואינה תלויה ב---webhook-events, שמסנן לפי סוג אירוע. לשילוב עם Chatwoot יש הגדרת CHATWOOT_IGNORE_JIDS נפרדת.

• תצורת TLS ב-Webhook

  אם אתה נתקל בשגיאות אימות תעודת TLS בעת שימוש ב-webhooks (לדוגמה, עם מנהרות Cloudflare או תעודות בחתימה עצמית):

  העתק

  tls: failed to verify certificate: x509: certificate signed by unknown authority

  ניתן להשבית את אימות תעודת ה-TLS באמצעות:

  • --webhook-insecure-skip-verify=true, או
  • WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY=true.

  אזהרת אבטחה: אפשרות זו משביתה את אימות תעודת ה-TLS ויש להשתמש בה רק בסביבות:

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

  עבור סביבות ייצור, השתמש בתעודת TLS תקיפה (לדוגמה, מ-Let's Encrypt) במקום להשבית את האימות.

#תצורה

התצורה נטענת לפי סדר עדיפויות זה:

1. דגלי שורת הפקודה (עדיפות עליונה)
2. משתני סביבה
3. קובץ .env (עדיפות תחתונה)

#משתני סביבה

כדי להשתמש במשתני סביבה:

1. משורש המאגר, העתק את קובץ הדוגמה: cp src/.env.example src/.env.
2. עדכן את הערכים ב-src/.env לפי הצורך.
3. לחלופין, הגדר את אותם המשתנים בסביבת התהליך.

#משתני סביבה זמינים

תיעוד:

• לסכמות מפורטות של נתוני webhook, יישום אבטחה ודוגמאות שילוב, ראה Webhook Payload Documentation.
• למדריך השילוב המקיף של Chatwoot, ראה Chatwoot Integration Documentation.
• לפרטי פריסה ואבטחה של OAuth, ראה MCP OAuth.

הפעל ./whatsapp --help כדי לראות את כל דגלי שורת הפקודה.

#דרישות

#דרישות מערכת

• Go 1.26.0 ומעלה (בעת בנייה מקוד מקור)
• FFmpeg (לעיבוד מדיה)

#פלטפורמות נתמכות

• Linux (x86_64, ARM64)
• macOS (Intel, Apple Silicon)
• Windows (x86_64; מומלץ WSL)

#תלויות (ללא Docker)

• macOS:
  • brew install ffmpeg webp
  • export CGO_CFLAGS_ALLOW="-Xpreprocessor"
• Linux:
  • sudo apt update
  • sudo apt install ffmpeg webp
• Windows (מומלץ WSL; ראה Install WSL):
  • התקן את FFmpeg.
  • התקן את libwebp, לאחר מכן חלץ אותו והוסף את ספריית ה-bin שלו ל-PATH.

הערה: החבילה webp מספקת את הכלים cwebp (מקודד), dwebp (מפענח) ו-webpmux (חולץ פריימים). FFmpeg נדרש לעיבוד מדיה. כלי libwebp (webpmux + dwebp) משמשים לתמיכה במדבקות WebP מונפשות.

#אופן השימוש

#בסיסי

1. שכפל את המאגר: git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.
2. פתח את הספרייה המשוכפלת במסוף.
3. הרץ cd src.
4. הרץ go run . rest.
5. פתח את http://localhost:3000.

#Docker

Docker מונע את הצורך בהתקנת Go, FFmpeg ו-libwebp ישירות במחשב המארח.

1. שכפל את המאגר: git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.
2. פתח את הספרייה המשוכפלת במסוף.
3. העתק את קובץ הסביבה: cp src/.env.example src/.env.
4. הרץ docker compose up -d --build.
5. פתח את http://localhost:3000.

#בניית קובץ בינארי בעצמך

1. שכפל את המאגר: git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.
2. פתח את הספרייה המשוכפלת במסוף.
3. הרץ cd src.
4. בנה את הקובץ הבינארי:
   • Linux ו-macOS: go build -o whatsapp
   • Windows (שורת הפקודה או PowerShell): go build -o whatsapp.exe
5. הפעל את השרת:
   • Linux ו-macOS: ./whatsapp rest
   • Windows: .\whatsapp.exe rest
6. פתח את http://localhost:3000 בדפדפן.

הפעל ./whatsapp --help (או .\whatsapp.exe --help ב-Windows) כדי לראות את כל הדגלים.

#הידור צולב עבור Raspberry Pi (ARM)

כדי לבנות עבור Raspberry Pi או מכשיר ARM אחר ללא שרשרת כלי C (כלומר CGO), השתמש בתג הבנייה purego. פעולה זו בוחרת מימוש SQLite ב-Go טהור.

1. שכפל את המאגר: git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.

2. פתח את הספרייה המשוכפלת במסוף.

3. הרץ cd src.

4. בנייה עבור Raspberry Pi Zero / 1 (ARMv6):

   העתק

   CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=6 go build -tags purego -o whatsapp-armv6

5. בנייה עבור Raspberry Pi 2 / 3 / 4 (ARMv7 32-bit):

   העתק

   CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -tags purego -o whatsapp-armv7

6. העבר את הקובץ הבינארי ל-Pi שלך, תן לו הרשאת הרצה (chmod +x), והפעל אותו:

   • אם בנית ARMv6: ./whatsapp-armv6 rest
   • אם בנית ARMv7: ./whatsapp-armv7 rest

#שרת MCP (Model Context Protocol)

MCP אינו מצב או תהליך נפרד, הוא מוגש על ידי שרת ה-REST עצמו. בכל זמן שבו ./whatsapp rest פועל, נקודת הקצה של MCP זמינה בכתובת http://<host>:<port><base-path>/mcp (ברירת מחדל http://localhost:3000/mcp) באמצעות תעבורת HTTP הניתנת להזרמה. השבת אותה באמצעות MCP_ENABLED=false או --mcp-enabled=false (ברירת מחדל: מופעל).

#כלי MCP זמינים

ישנם חמישה כלים מאוחדים; סוכנים בוחרים התנהגות באמצעות ארגומנט type/action במקום כלי אחד לכל פעולה:

#בחירת מכשיר

עבור פריסות מרובות מכשירים, הכותרת X-Device-Id בחיבור לקוח ה-MCP בוחרת את המכשיר המשמש עבור כל קריאת כלי באותו חיבור. אם הושמטה, היא נופלת למכשיר ברירת המחדל, בדיוק כמו ב-REST. כל קריאה בודדת יכולה לעקוף זאת באמצעות ארגומנט device_id אופציונלי.

#תצורת MCP

כוון את לקוח ה-MCP שלך אל נקודת הקצה /mcp. היא יורשת את ה-Basic Auth של שרת ה-REST, לכן כלול את אותה כותרת Authorization שבה משתמשות קריאות ה-REST שלך:

{
  "mcpServers": {
    "whatsapp": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Basic dXNlcjpzZWNyZXQ=",
        "X-Device-Id": "628123456789"
      }
    }
  }
}

headers הוא אופציונלי: כלול את Authorization רק כאשר מוגדר Basic Auth, ואת X-Device-Id רק עבור הגדרות של ריבוי מכשירים.

#OAuth עבור לקוחות MCP מרוחקים

OAuth 2.1 זמין עבור לקוחות מרוחקים שאינם יכולים לצרף כותרת Basic Auth. הוא מושבת כברירת מחדל. תצורה מינימלית היא:

APP_BASIC_AUTH=admin:replace-with-a-strong-password
MCP_ENABLED=true
MCP_OAUTH_ENABLED=true
MCP_OAUTH_ISSUER_URL=https://gowa.example.com

כאשר OAuth מופעל, /mcp מקבל טוקן מסוג Bearer או את פרטי ה-Basic Auth המוגדרים. OAuth אינו מבצע אימות לנתיבי REST או UI. ראה MCP OAuth עבור הגדרת לקוח, דרישות Reverse Proxy, התנהגות נתיב משנה ומודל האבטחה.

#מעבר ממצב MCP העצמאי

• ./whatsapp mcp ← ./whatsapp rest (MCP נכלל כעת אוטומטית).
• http://localhost:8080/sse ← http://localhost:3000/mcp.
• 40 כלים מפורטים ← 5 כלים מאוחדים (סוכנים בוחרים פעולות דרך השדה type/action).

#שרת REST לייצור (Docker)

שימוש ב-Docker Hub:

docker volume create whatsapp-storages
docker volume create whatsapp-statics
docker run --detach \
  --publish 3000:3000 \
  --name whatsapp \
  --restart always \
  --volume whatsapp-storages:/app/storages \
  --volume whatsapp-statics:/app/statics \
  aldinokemal2104/go-whatsapp-web-multidevice \
  rest --autoreply="Don't reply to this message, please"

שימוש ב-GitHub Container Registry:

docker volume create whatsapp-storages
docker volume create whatsapp-statics
docker run --detach \
  --publish 3000:3000 \
  --name whatsapp \
  --restart always \
  --volume whatsapp-storages:/app/storages \
  --volume whatsapp-statics:/app/statics \
  ghcr.io/aldinokemal/go-whatsapp-web-multidevice \
  rest --autoreply="Don't reply to this message, please"

#שרת REST לייצור (Docker Compose)

צור קובץ docker-compose.yml עם אחת מהתצורות הבאות.

שימוש ב-Docker Hub:

services:
  whatsapp:
    image: aldinokemal2104/go-whatsapp-web-multidevice
    container_name: whatsapp
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - whatsapp_storages:/app/storages
      - whatsapp_statics:/app/statics
    command:
      - rest
      - --basic-auth=admin:admin
      - --port=3000
      - --debug=true
      - --os=Chrome
      - --account-validation=false

volumes:
  whatsapp_storages:
  whatsapp_statics:

שימוש ב-GitHub Container Registry:

services:
  whatsapp:
    image: ghcr.io/aldinokemal/go-whatsapp-web-multidevice
    container_name: whatsapp
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - whatsapp_storages:/app/storages
      - whatsapp_statics:/app/statics
    command:
      - rest
      - --basic-auth=admin:admin
      - --port=3000
      - --debug=true
      - --os=Chrome
      - --account-validation=false

volumes:
  whatsapp_storages:
  whatsapp_statics:

שימוש במשתני סביבה עם Docker Hub:

services:
  whatsapp:
    image: aldinokemal2104/go-whatsapp-web-multidevice
    container_name: whatsapp
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - whatsapp_storages:/app/storages
      - whatsapp_statics:/app/statics
    environment:
      - APP_BASIC_AUTH=admin:admin
      - APP_PORT=3000
      - APP_DEBUG=true
      - APP_OS=Chrome
      - WHATSAPP_ACCOUNT_VALIDATION=false

volumes:
  whatsapp_storages:
  whatsapp_statics:

שימוש במשתני סביבה עם GitHub Container Registry:

services:
  whatsapp:
    image: ghcr.io/aldinokemal/go-whatsapp-web-multidevice
    container_name: whatsapp
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - whatsapp_storages:/app/storages
      - whatsapp_statics:/app/statics
    environment:
      - APP_BASIC_AUTH=admin:admin
      - APP_PORT=3000
      - APP_DEBUG=true
      - APP_OS=Chrome
      - WHATSAPP_ACCOUNT_VALIDATION=false

volumes:
  whatsapp_storages:
  whatsapp_statics:

הפעל את המערך שנבחר באמצעות docker compose up -d.

#שרת ייצור (קובץ בינארי)

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

ניתן גם ליצור fork או לשנות את קוד המקור.

#API נוכחי

#MCP (Model Context Protocol) API

• מוגש ב-/mcp על ידי שרת ה-REST באמצעות HTTP בר-הזרמה בכל זמן שבו MCP_ENABLED מוגדר כ-true. כאשר APP_BASE_PATH מוגדר, הנתיב הוא <base-path>/mcp.
• הכלים הזמינים מפורטים בסעיף "כלי MCP זמינים" לעיל.
• תואם לכלי וסוכני AI בעלי יכולת MCP.

#HTTP REST API

• עיין ב-docs/openapi.yaml למפרטי API מפורטים.
• השתמש ב-Swagger Editor כדי להציג חזותית את ה-API.
• צור לקוחות HTTP באמצעות openapi-generator.

✅ = זמין. * = בעל מגבלות ידועות; ראה את ההערות להלן.

הערות:

• *List My Groups: מחזיר מקסימום 500 קבוצות עקב מגבלת פרוטוקול של WhatsApp. השרתים של WhatsApp, ולא ה-API הזה, אוכפים את המגבלה. ראה את קוד המקור של whatsmeow לפרטים.
• הנתיב /health הוא ציבורי ותמיד רשום בנתיב השורש, גם כאשר APP_BASE_PATH מוגדר.
• נתיבי Chatwoot נרשמים רק כאשר CHATWOOT_ENABLED=true.

#ממשק משתמש

#ממשק משתמש MCP

• הגדרת MCP (נבדק ב-Cursor)
• בדיקת MCP
• הגדרת MCP מוצלחת

#לוח בקרה ברשת (gowa-ui)

לוח הבקרה נמצא במאגר משלו: aldinokemal/gowa-ui. כל שחרור של gowa-ui מפרסם קובץ עצמאי יחיד gowa-ui.html; השרת מוריד את השחרור האחרון בעת ההפעלה (וכל APP_UI_UPDATE_INTERVAL, שברירת המחדל שלו היא 3h), מאמת את סיכום ה-SHA-256 שלו, שומר אותו במטמון תחת storages/ui/, ומגיש אותו ב-/ מאחורי Basic Auth.

מודל אמון: סיכום השחרור מוכיח שההורדה תואמת למה ש-GitHub מפרסם, ולא מי פרסם אותה. מפעילים שבודקים גרסת בנייה ספציפית יכולים לנעול אותה באמצעות APP_UI_ASSET_SHA256 (כל שחרור מספק נכס .sha256, זוהי ההגדרה היחידה שנועלת גרסת בנייה מדויקת), לכוון את APP_UI_REPO ל-fork בשליטתם (המעדכן עדיין עוקב אחר השחרור האחרון של אותו מאגר), או להזין מראש את המטמון ולהשבית את העדכון האוטומטי לחלוטין.

שרתים מבודדי רשת (Air-gapped): שים קובץ gowa-ui.html שהורד בנתיב storages/ui/index.html והגדר APP_UI_AUTO_UPDATE=false. ניתן גם לארח את לוח הבקרה באופן עצמאי בכל מקום סטטי ולכוון אותו לכתובת ה-URL של שרת זה (ראה את ה-README של gowa-ui).

#הערה עבור macOS

אם אתה רואה invalid flag in pkg-config --cflags: -Xpreprocessor, הרץ:

export CGO_CFLAGS_ALLOW="-Xpreprocessor"

#חשוב

• פרויקט זה אינו רשמי ואינו קשור ל-WhatsApp.
• השתמש ב-WhatsApp Business Platform הרשמי כאשר אתה זקוק לאינטגרציה נתמכת המתאימה לסביבת ייצור.