وحدة تجربة الأكواد التفاعلية (Playground)

اختر أحد المسارات المعتمدة، واطلع على حمولة البيانات ونموذج الاستجابة برمز 202 مع تتبع حالة المهمة.

/api/v1/send/textمسار بديل مدعوم: /send/text

POST

جدولة إرسال رسالة نصية عبر طابور الإرسال الموثوق. تُقبل العملية برمز 202 وتخضع لوتيرة إرسال محسوبة تلقائياً مع التحقق من الموافقة وعدم تكرار الطلبات.

حمولة الطلب (Payload Editor)

أكواد تكامل الخادم (Backend Only)

# Server-side only. Set the secret key in your environment.
# Set CONVOBEST_EVENT_ID once per business event; reuse on retries.
curl --fail-with-body --max-time 30 -X POST "https://convobest.com/api/v1/send/text" \
  -H "apikey: $CONVOBEST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $CONVOBEST_EVENT_ID" \
  --data-binary '{
  "number": "201012345678",
  "text": "تم تأكيد طلبك رقم 1049.",
  "consent": {
    "optedIn": true,
    "source": "web_checkout_registration",
    "obtainedAt": "2026-10-07T12:00:00.000Z"
  }
}'

نموذج توضيحي فقط — لا توجد نتيجة إرسال فعليةمخرجات الطرفية

// معاينة تعليمية فقط؛ لا يتم إرسال أي طلب أو رسالة.

محددات الوتيرة الذكية (Adaptive Pacing)

كيف يحسب الطابور الفترات الزمنية بين الرسائل؟

تعتمد خوارزمية الإرسال على مستوى تفاعل جهة الاتصال والرسائل الواردة الخاصة (الواردة الفردية وليست المجموعات)، مع الحفاظ على مرساة زمنية ثابتة وتأخير الإرسال الأول لتفادي الاشتباه:

90s – 180s (2 - 3 دقيقة)

نشاط وارد مرتفع حديثاً

رسالة واردة خاصة خلال أقل من ساعة واحدة + 20 رسالة واردة على الأقل خلال 24 ساعة

180s – 300s (3 - 5 دقيقة)

نشاط وارد معتدل حديثاً

رسالة واردة خاصة خلال أقل من ساعة واحدة + أقل من 20 رسالة واردة خلال 24 ساعة

300s – 600s (5 - 10 دقيقة)

ركود نسبي (1 - 6 ساعات)

آخر رسالة واردة خاصة كانت بين ساعة و6 ساعات مضت

600s – 1200s (10 - 20 دقيقة)

ركود متوسط (6 - 24 ساعة)

آخر رسالة واردة خاصة كانت بين 6 و24 ساعة مضت

1200s – 2400s (20 - 40 دقيقة)

ركود تام أو لا يوجد وارد (24+ ساعة)

آخر وارد منذ أكثر من 24 ساعة أو لا توجد رسائل واردة مسجلة على الإطلاق

حدود السلامة والـ Warmup

سقف 600 رسالة / 24 ساعة

حد أقصى نظري يصل إلى 600 رسالة لكل 24 ساعة متدحرجة، مع تطبيق سقف التهيئة التدريجية (50/150/300) وحد أقصى 10 رسائل يومياً للمستلمين الجدد بدون محادثة سابقة.

مفهوم حالة SENT والـ ACK

الحالة SENT تعني تأكيد استلام المحرك المحلي (WhatsMeow ACK)، ولا تضمن وصول الرسالة لهاتف العميل الفعلي أو قراءتها. في حال حدوث انقطاع غير مؤكد تتحول الرسالة إلى DELIVERY_UNKNOWN وتتطلب فحصاً يدوياً دون إعادة إرسال تلقائية.

الموافقة وسياسات Meta

تقديم كائن الموافقة consent هو إقرار من جهتك بحصولك على موافقة العميل المسبقة، ولا يمثل دليلاً تشفيرياً كما لا يعفي من الالتزام بسياسات واتساب. تعتمد المنصة على محرك WhatsMeow المرتبط وليست عقداً رسمياً لقوالب Cloud API.

أمان المفاتيح والويب هوك

مفاتيح الـ API سرية ويجب استخدامها فقط داخل كود الخادم الخلفي (Backend) وعدم كشفها في المتصفح. لا توفر المنصة خدمة ويب هوك ذاتية للمشتركين، والتتبع يتم عبر استدعاء /api/v1/messages/:id.

WhatsApp Developer API طابور إرسال موثوق ومحمي برمجياً