انتقل إلى المحتوى
مستندات المطورينتجريبي

حدود الطلبات وتوزيع الإرسال

كم مرة يمكنك استدعاء الـ API، وبأي سرعة يرسل موجود.

شيئان مختلفان يتحكمان في السرعة: عدد مرات استدعائك للـ API (حدود الطلبات)، وسرعة إرسال موجود للرسائل (توزيع الإرسال على الوقت).

حدود الطلبات

يستطيع كل مفتاح إرسال 600 طلب في الدقيقة. عند تجاوزها، ترد الواجهة البرمجية بـ 429 وerror.code: "rate_limited" مع ترويسة Retry-After (بالثواني). انتظر هذه المدة، ثم أعد المحاولة بفاصل زمني متزايد (مثلًا 1 ثانية، ثم 2، ثم 4… مع قدر بسيط من العشوائية)، مع الإبقاء على Idempotency-Key نفسه في POST /campaigns.

نادرًا ما تحتاج إلى طلبات كثيرة: طلب POST /campaigns واحد يحمل حتى 10,000 مستلم، والـ webhooks تغنيك عن الاستعلام المتكرر. إذا كنت تقرأ الحملات في حلقة متكررة، فانتقل إلى الـ webhooks.

توزيع الإرسال على الوقت

يحدد واتساب عدد الأشخاص الذين يمكن لكل رقم مراسلتهم، ويراقب تفاعل العملاء. وإرسال قائمة كبيرة دفعة واحدة قد يخفض تقييم جودة رقمك. لذلك فالحملة التي تتجاوز حد الإرسال دفعة واحدة في مساحة عملك تخرج steady، على أقل عدد من الساعات يسمح به الحد في الساعة.

ويمكنك تحديدها بنفسك عبر pacing في POST /campaigns: { "mode": "all_at_once" } أو { "mode": "steady", "overHours": 6 } (من 1 إلى 336 ساعة). السرعة الأعلى مما يسمح به حدك تُرفع إلى الحد الأدنى. وإذا كانت 336 ساعة نفسها أسرع من اللازم، يفشل الطلب بـ 422 split_required: قسّم القائمة. وتخبرك استجابة الإنشاء بما استُخدم:

الحقلالمعنى
pacing.modeall_at_once: دفعة واحدة بأقصى سرعة يسمح بها الرقم. steady: موزع على الوقت.
pacing.overHoursمع steady: عدد الساعات التقريبي الذي يستغرقه الإرسال.
pacingAdjustedtrue عندما يختار موجود سرعة الإرسال أو يرفعها لتناسب حد الإرسال دفعة واحدة.

يعمل التوزيع لكل رقم، لذا فإن تقسيم قائمة واحدة إلى عدة حملات من الرقم نفسه لا يسرّع الإرسال. كما أن القوالب التسويقية تنتظر انتهاء ساعات الهدوء، وهذا قد يجعل الإرسال يستغرق أكثر من overHours.

ويعرض GET /numbers قيمتي qualityRating وmessagingLimit لكل رقم كما تحددهما Meta.

في هذه الصفحة