حدود المعدّل والحصص
ثلاث طبقات مستقلة تحمي أرقامك والمنصة. كل حد يجيب بـ 429 مع الترويسة Retry-After ورمز code محدد.
1. لكل مفتاح ولكل مجموعة نقاط نهاية
| المجموعة | الطلبات في الدقيقة لكل مفتاح |
|---|---|
/v1/messages |
60 |
/v1/sessions/... (بما فيها جهات الاتصال والمجموعات وإجراءات الرسائل) |
120 |
/v1/webhooks/... |
30 |
تحمل هذه الاستجابات الترويسات X-RateLimit-Limit وX-RateLimit-Remaining وX-RateLimit-Reset
(بالثواني). عند تجاوز الحد تصلك 429 RATE_LIMITED.
2. باقتك
| تجريبية (24 ساعة) | الأساسية | المتقدمة | |
|---|---|---|---|
| جلسات واتساب | حسب الباقة | 1 | 3 |
| الرسائل يومياً | 100 للحساب | 500 لكل جلسة | 500 لكل جلسة |
| الرسائل كل 30 يوماً | – | 10,000 | 40,000 |
| الوسائط يومياً | 20 للحساب | 50 لكل جلسة | 100 لكل جلسة |
| الويب هوك | 1 | 3 | 10 |
| مفاتيح API (على مستوى الحساب) | 1 | 2 | 10 |
| طلبات API في الدقيقة (للحساب) | 30 | 60 | 180 |
| تجميع عدة أرقام | – | – | ✓ |
| الرمز | HTTP | متى |
|---|---|---|
DAILY_LIMIT_REACHED، MEDIA_LIMIT_REACHED |
429 | بلغت حصة يومية. تتجدد عند 00:00 بتوقيت UTC |
PERIOD_LIMIT_REACHED |
429 | بلغت حصة الثلاثين يوماً، وهي نافذة متحركة |
API_RATE_LIMITED |
429 | طلبات الدقيقة للحساب كله |
PLAN_LIMIT_* |
402 | بلغ عدد ما (مثل الجلسات) حد الباقة. رقِّ باقتك لإضافة المزيد |
يعرض GET /v1/usage رسائل اليوم والأيام الأخيرة ووسائطها وطلبات API، بجانب حدودك. أما طلبات الدفع
والفوترة فلا تحدّها باقتك أبداً.
3. لكل رقم واتساب
يُطبَّق فوق ذلك تباعد محرك الأمان والإحماء: راجع الأمان والإحماء. هذه الحدود نابعة من سلوك واتساب لا من باقتك، فالباقة الأعلى لا تجعل رقماً واحداً يرسل أسرع.
التعامل مع 429
- انتظر
Retry-Afterثانية قبل إعادة المحاولة. - استخدم تباعداً متزايداً عند تكرار 429.
- للكميات استخدم
?async=true: يضع YASend الرسائل في طابور ويرسل كل رسالة حالما تسمح الحدود. عيّنexpiresInSecondsلكل ما هو حساس للوقت.