ממשק API לשליחה למספרים מרובים

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

מערכת Wbiztool יוצרת הודעה אחת לכל נמען ומחזירה msg_id לכל אחת, כך שאפשר לבדוק את הסטטוס שלהן בנפרד.

דוגמה מהירה#

curl -X POST https://wbiztool.com/api/v1/send_msg/multi/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210,9812345670,Sales Team Mumbai",
    "msg": "Our Diwali sale starts tomorrow. Get 20% off on all orders!"
  }'

import requests

response = requests.post(
    "https://wbiztool.com/api/v1/send_msg/multi/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "msg_type": 0,
        "country_code": "91",
        "phone": ",".join(["9876543210", "9812345670", "Sales Team Mumbai"]),
        "msg": "Our Diwali sale starts tomorrow. Get 20% off on all orders!",
    },
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 400

if result.get("status") == 1:
    for item in result["messages"]:
        print(item["contact"], "->", item["msg_id"])
else:
    print("Failed:", result.get("message", "no message in response"))

// 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/multi/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: 12345,
    api_key: "YOUR_API_KEY",
    whatsapp_client: 678,
    msg_type: 0,
    country_code: "91",
    phone: ["9876543210", "9812345670", "Sales Team Mumbai"].join(","),
    msg: "Our Diwali sale starts tomorrow. Get 20% off on all orders!",
  }),
});
const result = await response.json(); // read the body even when the HTTP code is 400

if (result.status === 1) {
  for (const item of result.messages) {
    console.log(item.contact, "->", item.msg_id);
  }
} else {
  console.error("Failed:", result.message ?? "no message in response");
}

<?php
$payload = [
    'client_id'       => 12345,
    'api_key'         => 'YOUR_API_KEY',
    'whatsapp_client' => 678,
    'msg_type'        => 0,
    'country_code'    => '91',
    'phone'           => implode(',', ['9876543210', '9812345670', 'Sales Team Mumbai']),
    'msg'             => 'Our Diwali sale starts tomorrow. Get 20% off on all orders!',
];

$ch = curl_init('https://wbiztool.com/api/v1/send_msg/multi/');
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) {
    foreach ($result['messages'] as $item) {
        echo $item['contact'] . ' -> ' . $item['msg_id'] . PHP_EOL;
    }
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no message in response');
}

החליפו את 12345, YOUR_API_KEY ו-678 בערכים שלכם. בסעיף אימות מוסבר איפה למצוא אותם.

פרמטרי הבקשה#

curl -X POST https://wbiztool.com/api/v1/send_msg/multi/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210,9812345670",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts tomorrow."
  }'

איך הנמענים מזוהים#

מערכת Wbiztool מפצלת את phone לפי פסיקים, מסירה רווחים סביב כל פריט ואז מחליטה מה כל פריט:

• ספרות בלבד (+ בהתחלה או אפסים מובילים הם בסדר): מטופל כמספר טלפון. הקידומת country_code מתווספת, אלא אם המספר כבר מתחיל בה, ואז המספר חייב להיות באורך של 6 עד 15 ספרות.
• כל דבר אחר: מטופל כשם של קבוצת WhatsApp, שמאותרת באותה דרך כמו ב-שליחה לקבוצה.
• קבוצה ששמה מורכב מספרות בלבד (למשל 2024) מטופלת כמספר טלפון, ואי אפשר לשלוח מה-endpoint הזה לקבוצות ששמן מכיל פסיקים. לקבוצות כאלה השתמשו ב-שליחה לקבוצה.

דברים נוספים שכדאי לדעת:

• מספרים קצרים מדי או ארוכים מדי אחרי הוספת קידומת המדינה מדולגים בשקט. הם לא מופיעים בתגובה ולא מקבלים msg_id.
• כפילויות לא מוסרות. מספר שמופיע פעמיים מקבל שתי הודעות.
• אם מספר מקומי מתחיל במקרה באותן ספרות כמו country_code (למשל 9123456780 עם country_code 91), הקידומת לא מתווספת. שלחו מספרים כאלה כשקידומת המדינה כבר כלולה בהם (919123456780).
• כתובות URL של תמונות וקבצים לא נבדקות כשאתם קוראים ל-API. הן מורדות בזמן שליחת כל הודעה, כך שקישור שבור גורם להודעות להיכשל מאוחר יותר, ולא לבקשה עצמה. חלים אותם כללים של זמן שליחה כמו בשליחת הודעה: תמונות מעל 16 MB וסרטונים מעל 64 MB נכשלים, אודיו WAV ו-OGG לא נתמך, ולקבצים (msg_type 2) בלי סיומת נתמכת מתווסף ‎.pdf. ראו שליחת תמונות וקבצים.

קרדיטים#

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

{
  "message": "Not enough credits: 120 messages requested, 85 credits remaining",
  "status": 0
}

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

תגובה#

בקשה מוצלחת מחזירה HTTP 200:

{
  "msg_ids": [9817263, 9817264, 9817265],
  "messages": [
    { "msg_id": 9817263, "contact": "919876543210", "is_group": false },
    { "msg_id": 9817264, "contact": "919812345670", "is_group": false },
    { "msg_id": 9817265, "contact": "Sales Team Mumbai", "is_group": true }
  ],
  "message": "Successfully created 3 messages",
  "status": 1
}

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

שגיאות#

רוב השגיאות מחזירות HTTP 200 עם status שמוגדר ל-0, לכן תמיד בדקו את status בגוף התגובה. מלבד שגיאות HTTP 400 ו-403, התגובות (כולל תגובות מוצלחות) הן JSON שנשלח עם Content-Type: text/html, לכן פענחו את הגוף בעצמכם ואל תסתמכו על זיהוי JSON אוטומטי (למשל בכלי no-code):

{ "message": "Invalid whatsapp client", "status": 0 }

טיפים#

• שלחו את phone כמחרוזת: חברו את הרשימה שלכם בפסיקים. מערך JSON מחזיר {}.
• אל תשתמשו כרגע ב-send_bulk_messages של לקוח ה-Python: הוא שולח את הרשימה בתור phones, וה-endpoint הזה מתעלם מזה. קראו ל-endpoint ישירות, כמו בדוגמאות שלמעלה.
• עקבו אחרי כל הודעה: שמרו כל msg_id מתוך messages, או העבירו webhook כדי לקבל התראה כשכל הודעה נשלחת או נכשלת.
• השאירו את המספר מחובר: כל הודעה נשלחת ממספר ה-WhatsApp שלכם, ולכן הוא חייב להישאר מחובר בהגדרות WhatsApp עד שכל האצווה יוצאת.
• טקסט שונה לכל אדם: ה-endpoint הזה שולח את אותו msg לכולם. כדי להתאים אישית כל הודעה, קראו ל-שליחת הודעה פעם אחת לכל נמען.