דלגו לתוכן
WbizTool

שליחת הודעות לקבוצת WhatsApp עם ה-API

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

התחילו בחינם

ניסיון חינם: 50 הודעות בכל 30 יום, בלי כרטיס אשראי.

איך זה עובד

  1. קבלו מפתח API וקשרו את המספר שלכם

    הירשמו, ואז קשרו את מספר ה-WhatsApp שלכם בדף מספרי WhatsApp עם קוד QR או קוד צימוד, כמו WhatsApp Web. בהגדרות ← מפתחות API, צרו מפתח והעתיקו את ה-Client ID שלכם (המדריך למפתחות API למטה מראה איפה). המזהה שעל הכרטיס של המספר (כמו מזהה 678) הוא ה-whatsapp_client שלכם.

  2. ודאו שהמספר שלכם בקבוצה

    המספר שממנו אתם שולחים חייב להיות חבר בקבוצה, ומנהל אם רק מנהלים יכולים לפרסם בה. רשמו את שם הקבוצה בדיוק כמו ש-WhatsApp מציג אותו, כולל אימוג׳י וסימני פיסוק.

  3. שלחו לקבוצה

    שלחו POST אל https://wbiztool.com/api/v1/send_msg/group/ עם group_name ו-msg. תגובה עם "status": 1 ו-msg_id פירושה שההודעה נכנסה לתור.

  4. בדקו שההודעה יצאה

    מחפשים את הקבוצה כשההודעה נשלחת, לא כשאתם קוראים ל-API. בדקו את סטטוס ההודעה או Webhook: שם שגוי נכשל בשלב הזה עם Group not found.

דוגמאות קוד: הודעות לקבוצות

שליחת טקסט לקבוצה (cURL)
curl -X POST https://wbiztool.com/api/v1/send_msg/group/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "group_name": "Sales Team Mumbai",
    "msg": "Reminder: *weekly review* starts at 4 PM today."
  }'
Python (requests)
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/send_msg/group/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "msg_type": 0,
        "group_name": "Sales Team Mumbai",
        "msg": "Reminder: *weekly review* starts at 4 PM today.",
    },
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 400

if result.get("status") == 1:
    print("Queued with msg_id", result["msg_id"])
else:
    print("Failed:", result.get("message"))
Python (הלקוח הרשמי)
from wbiztool_client import WbizToolClient

client = WbizToolClient(api_key="YOUR_API_KEY", client_id=12345)

result = client.send_message_to_group(
    group_name="Sales Team Mumbai",
    msg="Reminder: weekly review starts at 4 PM today.",
    whatsapp_client=678,
)
print(result)
Node.js (fetch): תמונה מכתובת URL
// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v1/send_msg/group/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: 12345,
    api_key: "YOUR_API_KEY",
    whatsapp_client: 678,
    msg_type: 1,
    group_name: "Sales Team Mumbai",
    img_url: "https://example.com/reports/weekly-sales.png",
    msg: "This week's sales summary",
  }),
});
console.log(await response.json());
PHP (הרחבת cURL)
<?php
$payload = [
    'client_id'       => 12345,
    'api_key'         => 'YOUR_API_KEY',
    'whatsapp_client' => 678,
    'msg_type'        => 0,
    'group_name'      => 'Sales Team Mumbai',
    'msg'             => 'Reminder: *weekly review* starts at 4 PM today.',
];

$ch = curl_init('https://wbiztool.com/api/v1/send_msg/group/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['status'] ?? 0) === 1) {
    echo 'Queued with msg_id ' . $result['msg_id'];
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

מה אפשר לעשות

  • טקסטים, תמונות וקבצים

    msg_type 0 שולח טקסט, 1 תמונה מ-img_url ו-2 קובץ מ-file_url, או העלו את הקובץ כ-multipart form data בשדה בשם file.

  • לפי שם הקבוצה

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

  • תזמון הודעה לקבוצה

    תזמון הודעה (/api/v1/schedule_msg/) מקבל group_name במקום phone, עם תאריך, שעה ואזור זמן.

  • קבוצות ומספרים בבקשה אחת

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

  • סטטוס ב-Webhook

    העבירו webhook כדי לקבל POST עם ה-msg_id ועם SENT או FAILED, או קראו לנקודת הקצה של סטטוס ההודעה עם ה-msg_id.

טוב לדעת

  • שליחה לקבוצת WhatsApp דרך ה-API (group_name במקום phone) עובדת בכל תוכנית, כולל תקופת הניסיון החינמית.
  • שם הקבוצה לא נבדק כשאתם קוראים ל-API, ולכן "status": 1 פירושו רק שההודעה בתור. שם שלא תואם בדיוק, איש קשר עם אותו שם, או קבוצה שרק מנהלים מפרסמים בה והמספר שלכם לא יכול לפרסם בה – כל אלה נכשלים מאוחר יותר עם Group not found.
  • אם לשתי קבוצות יש בדיוק אותו שם, ההודעה נשלחת לראשונה בתוצאות החיפוש של WhatsApp. תנו לכל קבוצה שם ייחודי, ועדכנו את group_name אם מישהו משנה את שם הקבוצה.
  • כל הודעה לקבוצה נספרת כהודעה אחת במכסה של 1,000 הודעות ביום של המספר במסגרת שימוש הוגן.
  • ההודעות יוצאות ממספר ה-WhatsApp שלכם, ולכן הכללים של WhatsApp עצמה חלים: שלחו הודעות לאנשים שמצפים לשמוע מכם.

שאלות

איך מוצאים את המזהה של קבוצת WhatsApp?
לא צריך אותו. ה-API מוצא את הקבוצה לפי השם שלה: שלחו group_name בדיוק כמו ש-WhatsApp מציג אותו, כולל אימוג׳י וסימני פיסוק, ממספר שנמצא בקבוצה.
באילו תוכניות אפשר לשלוח לקבוצות דרך ה-API?
בכל תוכנית, כולל תקופת הניסיון החינמית. הודעה לקבוצה נספרת כהודעה אחת, כמו הודעה למספר טלפון.
למה ההודעה שלי לקבוצה נכשלה עם Group not found?
השם לא תאם בדיוק לקבוצה, לאיש קשר יש אותו שם, המספר שלכם לא בקבוצה, או שרק מנהלים יכולים לפרסם בה והמספר שלכם לא מנהל. בדקו ב-WhatsApp את האיות המדויק ואת האותיות הגדולות והקטנות.
אפשר לתזמן הודעה לקבוצה?
כן. שלחו POST אל /api/v1/schedule_msg/ עם group_name במקום phone, ועוד date (dd/mm/yyyy), time (HH:MM) ו-timezone.
צריך את WhatsApp Business API או אישור של Meta?
לא. WbizTool שולחת ממספר ה-WhatsApp או ה-WhatsApp Business שלכם, שמקושר כמו WhatsApp Web. אין אישור של Meta ואין תבניות הודעה שצריך לאשר.

קראו את המדריכים

עוד בנושא

שלחו היום את הודעת ה-WhatsApp האוטומטית הראשונה שלכם

צרו חשבון, סרקו את קוד ה-QR ושלחו הודעה בפחות מחמש דקות.

התחילו בחינם

תוכניות בתשלום מתחילות ב-25$ לחודש בארה״ב. מחירים