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

أرسل تذكيرات WhatsApp متكررة باستخدام API

أرسل رسالة WhatsApp نفسها وفق جدول – إيجار شهري، أو جدول أسبوعي، أو متابعة يومية – من رقمك الخاص. أنشئ التذكير مرة واحدة بتعبير cron ومنطقة زمنية، وسيضيف WbizTool الرسالة إلى قائمة الانتظار في كل مرة يتطابق فيها الجدول. التذكيرات جزء من كل باقة مدفوعة، بدءًا من $25 شهريًا في الولايات المتحدة (سعرك في صفحة الأسعار).

ابدأ مجانًا

تحتاج التذكيرات إلى باقة مدفوعة: تبدأ من $25 شهريًا في الولايات المتحدة.

كيف يعمل

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

    اربط رقم WhatsApp الخاص بك في صفحة أرقام WhatsApp برمز QR أو رمز الربط، وأنشئ مفتاحًا في الإعدادات ← مفاتيح API. تحتاج التذكيرات إلى باقة مدفوعة (Lite أو Standard أو Advanced أو Enterprise).

  2. اختر الجدول

    اكتبه كتعبير cron من خمسة حقول: 0 10 1 * * هو الساعة 10:00 في اليوم 1 من كل شهر، و0 9 * * 1-5 هو الساعة 9:00 في أيام العمل. أضف منطقة زمنية IANA مثل Asia/Kolkata.

  3. أنشئ التذكير

    أرسل POST إلى /api/v1/reminder/create/ مع reminder_name وphone وmessage وcron_expression وtimezone. احفظ reminder_id من الرد.

  4. اعرضه أو ألغِه لاحقًا

    يُرجع /api/v1/reminder/list/ تذكيراتك، 50 في كل صفحة. يوقف /api/v1/reminder/cancel/ مع reminder_id تذكيرًا نهائيًا – مثلًا عندما يدفع العميل.

أمثلة شيفرة API التذكيرات

إنشاء تذكير شهري
curl -X POST https://wbiztool.com/api/v1/reminder/create/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "reminder_name": "Monthly rent reminder",
    "phone": "919876543210",
    "message": "Hi Aman, a reminder that your rent is due on {current_date_formatted}.",
    "cron_expression": "0 10 1 * *",
    "timezone": "Asia/Kolkata"
  }'
إنشاء تذكير في Python
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/reminder/create/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "reminder_name": "Monthly rent reminder",
        "phone": "919876543210",
        "message": "Hi Aman, a reminder that your rent is due on {current_date_formatted}.",
        "cron_expression": "0 10 1 * *",
        "timezone": "Asia/Kolkata",
    },
    timeout=60,
)

try:
    result = response.json()  # read the body even when the HTTP code is 400
except ValueError:
    raise SystemExit(f"HTTP {response.status_code}: not JSON. Send every text value as a string.")

if result["status"] == 1:
    print("Reminder created with reminder_id", result["reminder_id"])
else:
    print("Failed:", result["message"])
تذكير أسبوعي مع صورة
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/reminder/create/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "reminder_name": "Weekly class timetable",
        "phone": "919876543210",
        "msg_type": 1,
        "img_url": "https://example.com/timetable.png",
        "message": "Here is this week's timetable.",
        "cron_expression": "0 8 * * 1",
        "timezone": "Asia/Kolkata",
    },
    timeout=60,
)
print(response.status_code, response.text)
عرض تذكيراتك
curl -X POST https://wbiztool.com/api/v1/reminder/list/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "page": 1
  }'
إلغاء تذكير
curl -X POST https://wbiztool.com/api/v1/reminder/cancel/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "reminder_id": "3187"
  }'

ما يمكنك فعله

  • أي جدول يعبّر عنه cron

    يوميًا في 9:00 (0 9 * * *)، أو كل اثنين (0 9 * * 1)، أو مرتين يوميًا (0 9,18 * * *)، أو اليوم 15 من كل شهر (0 10 15 * *)، أو كل 6 ساعات (0 */6 * * *).

  • تواريخ تُملأ تلقائيًا

    تُستبدل متغيرات القوالب مثل {current_date_formatted} و{current_time_12h} و{reminder_name} في كل مرة يعمل فيها التذكير، وفق منطقته الزمنية.

  • الصور والملفات

    يرسل msg_type بالقيمة 1 صورة من img_url. للملف، استخدم msg_type بالقيمة 2 مع الرابط العام للملف في img_url واسمه في file_name.

  • ظاهرة في لوحة التحكم

    تظهر التذكيرات المنشأة عبر API أيضًا في صفحة التذكيرات، حيث يمكنك إيقافها مؤقتًا أو تعديلها. ويمكن لتلك الصفحة أيضًا استيراد تذكيرات كثيرة من جدول CSV أو Excel.

  • يرسل من الرقم الذي تختاره

    اضبط whatsapp_client لاختيار الرقم. إذا حذفته، تستخدم كل دورة رقمًا متصلًا في تلك اللحظة.

من المفيد معرفته

  • تحتاج التذكيرات إلى باقة مدفوعة. على الفترة التجريبية المجانية يرد API بـ Upgrade your plan to use reminders feature.
  • استخدم أسماء المناطق الزمنية IANA مثل Asia/Kolkata أو America/Chicago. تُرفض الاختصارات مثل IST أو CST بالخطأ Invalid timezone؛ ودون منطقة زمنية، يعمل الجدول بتوقيت UTC.
  • يقبل phone الرقم مع رمز الدولة، مثل 919876543210 – لا يوجد حقل country_code في نقطة النهاية هذه.
  • لا يوجد استدعاء للتحديث أو الإيقاف المؤقت في API. لتغيير جدول، ألغِ التذكير وأنشئ تذكيرًا جديدًا؛ وللإيقاف المؤقت، استخدم صفحة التذكيرات.
  • تُفحص التذكيرات دوريًا، لا بالثانية، فقد تُرسل الدورة بعد موعدها بما يصل إلى 10 دقائق؛ وإذا تأخر الفحص أكثر من ذلك، تُتخطّى الدورة. تُحتسب كل دورة من رسائل الرقم الـ 1,000 يوميًا.
  • في عرض التذكيرات، يُحسب next_run كما لو كانت المنطقة الزمنية للتذكير هي UTC. راجع صفحة التذكيرات لمعرفة الموعد التالي الصحيح.
  • إذا أُرسل حقل نصي مثل phone أو message أو reminder_name كرقم أو true أو null، يكون الرد صفحة خطأ HTML ‏(HTTP 500)، لذا أرسل القيم النصية كسلاسل نصية وتعامل مع جسم ليس JSON، كما يفعل مثال Python.
  • إذا كان رقم whatsapp_client مسجّل الخروج عند إنشاء التذكير، يرفضه API بالرسالة WhatsApp Logged Out. Please Reconnect!!
  • تُرسل الرسائل من رقم WhatsApp الخاص بك، لذا تنطبق قواعد WhatsApp نفسها: راسل من يتوقعون رسائلك.

أسئلة

ما الفرق بين التذكير والرسالة المجدولة؟
الرسالة المجدولة (/api/v1/schedule_msg/) تُرسل مرة واحدة، في التاريخ والوقت اللذين تحددهما. أما التذكير فيتكرر وفق جدول cron الخاص به إلى أن تلغيه.
كيف أوقف تذكيرًا عندما يدفع العميل؟
استدعِ /api/v1/reminder/cancel/ مع reminder_id الخاص به. يتوقف فورًا ولن يعمل مرة أخرى. قد تُرسل رسالة كان قد أضافها إلى قائمة الانتظار قبل الإلغاء.
هل يمكنني إيقاف تذكير مؤقتًا أو تعديله عبر API؟
ليس بعد. أوقفه مؤقتًا أو عدّله في صفحة التذكيرات في لوحة التحكم، أو ألغِه وأنشئ تذكيرًا جديدًا بالجدول الجديد.
هل يمكن للتذكير إرسال ملف PDF؟
نعم. استخدم msg_type بالقيمة 2، وضع الرابط العام للملف في img_url واسمه مع الامتداد (مثل invoice.pdf) في file_name. يُنزَّل الملف في كل مرة يعمل فيها التذكير، فأبقِ الرابط عاملًا.
ما الباقات التي تتضمن التذكيرات؟
كل باقة مدفوعة: Lite (رقم واحد) وStandard (3 أرقام) وAdvanced (10 أرقام) – $25 و$59 و$149 شهريًا في الولايات المتحدة؛ وتعرض صفحة الأسعار سعر بلدك. جميعها ترسل رسائل غير محدودة في إطار الاستخدام العادل. لا تتضمن الفترة التجريبية المجانية التذكيرات.

اقرأ الأدلة

ذات صلة

أرسل أول رسالة WhatsApp تلقائية اليوم

أنشئ حسابًا، وامسح رمز QR، وأرسل رسالة في أقل من خمس دقائق.

ابدأ مجانًا

تبدأ الباقات المدفوعة من $25 شهريًا في الولايات المتحدة. الأسعار