الخطط والحصص
أربعة سقوف مختلفة تنطبق على أي تكامل، وتخفق بأربع طرق مختلفة. والخلط بينها هو سبب أن تبدو رسالة مرفوضة بلا تفسير — فهذه الصفحة تفصلها، ثم تعطي الأرقام الحقيقية لكل منها.
أربعة أنواع من الحدود
لكل منها إخفاقه وعلاجه وموضع النظر فيه.
| نوع الحد | الرمز | الوصف |
|---|---|---|
| استحقاق الخطة | ENTITLEMENT_LIMIT_REACHED | كم يسمح لك من مورد: جهات اتصال، قنوات، نقاط webhook. تحدده الخطة؛ ويُرفع بتغييرها. |
| حد معدل HTTP | RATE_LIMITED | كم مرة تستدعي مسارا واحدا. لكل مساحة عمل أو لكل IP، على نافذة قصيرة. انتظر وأعد. |
| معدل تمرير المزوّد | PROVIDER_RATE_LIMITED | كم بسرعة يقبل المزوّد الأعلى الرسائل على قناة. وليس شيئا ترفعه. |
| سياسة أمان الـ QR | QR_SAFETY_LIMIT_REACHED | سقف متحفظ تطبّقه المنصة على قنوات الـ QR غير الرسمية. خيار سياسة لا قاعدة من واتساب. |
استحقاقات الخطة
GET/v1/planاقرأ استحقاقاتك بدل تثبيتها في الكود — فقد تحمل مساحة العمل تجاوزا، والنقطة تبلّغ بالقيمة السارية ومعها source.
| الاستحقاق | free | starter | growth | enterprise | مطبَّق |
|---|---|---|---|---|---|
| monthly_message_quota | بلا حد | بلا حد | بلا حد | بلا حد | نعم |
| production_channels | 1 | 3 | 10 | بلا حد | نعم |
| contacts | 500 | 10,000 | 100,000 | بلا حد | نعم |
| webhook_endpoints | 1 | 5 | 20 | بلا حد | نعم |
| shared_test_sessions | 1 | 1 | 1 | بلا حد | نعم |
| sandbox_message_quota | بلا حد | بلا حد | بلا حد | بلا حد | ليس بعد |
| verified_sandbox_recipients | 1 | 1 | 1 | بلا حد | ليس بعد |
| api_keys | 2 | 10 | 25 | بلا حد | ليس بعد |
| team_seats | 1 | 5 | 20 | بلا حد | ليس بعد |
| active_automations | 2 | 20 | 100 | بلا حد | ليس بعد |
| campaigns_enabled | false | true | true | true | ليس بعد |
| admin_log_retention_days | 7 | 30 | 90 | بلا حد | ليس بعد |
| support_tier | docs | standard | priority | sla | ليس بعد |
ليس كل استحقاق مطبَّقا بعد
المفاتيح الموسومة بأنها غير مطبَّقة تبلّغ عنها نقطة الخطة لكن لا شيء يحسب عليها اليوم. عاملها نيّة منشورة لا حدا ستبلغه — ولا تبنِ عليها افتراضا في الفوترة.
الاستهلاك الحالي يأتي من نقطة أخرى، تبلّغ بالمجاميع المقيسة إلى جانب الحدود والمتبقي.
GET/v1/usage- الفترة دائما
الشهر الميلادي الجاري بتوقيت UTC، ونهايتها غير شاملة. وهي ليست ثلاثين يوما متحركة وليست بتوقيت مساحة العمل. - الأعداد تحت
currentمقاييس لحظية لا مجاميع فترة. فجهات الاتصال والقنوات المتصلة والمفاتيح والمقاعد كلها في لحظتها. - النقطة لا تأخذ معاملات. لا تفصيل يومي ولا سبيل لطلب شهر ماض، فلا يمكن اشتقاق رقم يومي منها.
حدود معدل HTTP
المسارات المحدودة ودلاؤها. والرفض يعطي 429 مع header باسم Retry-After — راجع الأخطاء والحدود للـ headers كاملة.
| Endpoint | الحد | الصلاحية |
|---|---|---|
| POST /v1/messages | 600 / 1min | workspace |
| POST /v1/channels | 20 / 1min | workspace |
| POST /v1/sandbox/sessions | 10 / 1h | workspace |
| POST /v1/sandbox/sessions/{id}/verify | 20 / 10min | workspace |
| POST /v1/contacts | 600 / 1min | workspace |
| POST /v1/contacts/imports | 20 / 1min | workspace |
| POST /v1/templates/{id}/test-send | 60 / 1min | workspace |
| POST /v1/conversations/{id}/messages | 600 / 1min | workspace |
| POST /v1/channels/{id}/qr/start | 30 / 1min | workspace |
هي إعداد لا عقد
هذه القيم المنشورة الافتراضية. وتحديد المعدل مفعّل في الإنتاج ومطفأ في غيره، والأرقام قابلة للضبط، فاقرأ الـ headers بدل تثبيت سقف في عميلك.
معدل تمرير المزوّد
كل قناة تنشر max_throughput_mps ضمن قدراتها، ويوزّع الموزّع الرسائل على ذلك الإيقاع.
| المزوّد | معدل التمرير | الوصف |
|---|---|---|
| sandbox | 2 msg/s | مريح للاختبار، وغير مشترك مع أحد: رقم المجموعة لك طوال الجلسة. |
| qr | 0.5 msg/s | بطيء عمدا. فالعميل غير الرسمي الذي يرسل بسرعة عميل يُلاحَظ. |
| meta | — | لا ينطبق بعد. فـ Meta تدرّج المعدل حسب تقييم الجودة وطبقة حد المراسلة. |
تجاوز معدل التمرير لا يُخفق الإرسال. تنتظر الرسائل في الطابور وتُوزَّع بترتيب الأولوية، وهو ما تتحكم به فئة الرسالة.
الحد الأمني للـ QR
سياسة منصة لا ضمان من واتساب
يجوز لقناة QR أن ترسل 200 رسالة صادرة في كل نافذة متحركة مدتها 24 ساعة. وتجاوز ذلك يُرفض بـ QR_SAFETY_LIMIT_REACHED.
اختير هذا الرقم ليكون متحفظا. والبقاء تحته لا يجعل الحساب آمنا: فسياسات واتساب تقيّد العملاء غير المصرّح بهم بصرف النظر عن الحجم، والحساب الموصول بهذه الطريقة قد يُقيَّد في أي وقت. انتقل إلى قناة رسمية قبل أن يصير الحجم مهما.
- النافذة
متحركة، تُحسب على الرسائل الصادرة فعلا لا على يوم تقويمي يُصفَّر منتصف الليل. - يمكن خفضه لمساحة عمل أو لقناة، ولا يُرفع أبدا دون قرار صريح من المنصة.
- وحدّ منفصل يحصر الرسائل إلى مستلم بعينه بـ
6في الدقيقة. - الحركة التسويقية تُوزَّع بأدنى أولوية، فهي أول ما تؤخّره قناة مزدحمة.
حدود الحمولة
| الحد | القيمة |
|---|---|
| نص الرسالة (حروف) | 4 096 |
| نص القالب (حروف) | 1 024 |
| ملف استيراد جهات الاتصال (بعد فك الترميز) | 5 MiB |
| صفوف استيراد جهات الاتصال | 50 000 |
| حجم صفحة القائمة | 100 |
| مفتاح Idempotency-Key (حروف) | 255 |
الأسعار
الحدود أعلاه حقيقية ومنشورة. أما الأسعار فلم تُحدَّد بعد، وصفحة الأسعار تقول ذلك بدل أن تعرض رقما لم يتفق عليه أحد.