انتقل إلى المحتوى
WbizTool

أرسل رسائل إلى مجموعة WhatsApp عبر API

انشر إعلانات الفريق وتحديثات المجتمع والتقارير اليومية في مجموعة WhatsApp من شيفرتك الخاصة. يرسلها رقم WhatsApp المربوط إلى أي مجموعة هو عضو فيها، وتُختار المجموعة باسمها الدقيق.

ابدأ مجانًا

فترة تجريبية مجانية: 50 رسالة خلال أي 30 يومًا، دون بطاقة.

كيف يعمل

  1. احصل على مفتاح API واربط رقمك

    سجّل، ثم اربط رقم WhatsApp الخاص بك في صفحة أرقام WhatsApp برمز QR أو رمز الربط، مثل WhatsApp Web. في الإعدادات ← مفاتيح API، أنشئ مفتاحًا وانسخ Client ID (يوضح دليل مفاتيح API أدناه مكانه). المعرّف الظاهر على بطاقة الرقم (مثل ID 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): صورة من رابط
// 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 في حقل اسمه 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 شهريًا في الولايات المتحدة. الأسعار