ما هو Throughput (سرعة الإرسال) في واتساب API؟ شرح مبسط بالأمثلة

آخر تحديث: 5 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر الأساسي: صفحة Throughput وصفحة أكواد الأخطاء وتوثيق حدود الرسائل من Meta

الإجابة المختصرة: Throughput (سرعة الإرسال) هو أقصى عدد رسائل في الثانية يتعامل معه كل رقم مسجّل على Cloud API، والوارد والصادر يُحسبان معاً. القيمة الافتراضية 80 رسالة في الثانية، وترتفع تلقائياً ومجاناً إلى 1,000 بثلاثة شروط، أما رقم الربط المزدوج مع تطبيق واتساب بيزنس فسرعته ثابتة عند 20. وتجاوزها يرجع الخطأ 130429. وهي غير حد الرسائل الذي يعدّ العملاء خلال 24 ساعة.

لا تخلط بين المصطلحين: سرعة الإرسال تقيس الرسائل في الثانية، أما حد الرسائل فيقيس عدد العملاء المختلفين خارج نافذة الخدمة في 24 ساعة. تعريف الثاني في ما هو Messaging Limit (حد الرسائل)؟، وخطوات رفعه في حدود الرسائل اليومية في واتساب API 2026 وكيف ترفعها.

محتوى المقال:

ما هو Throughput في واتساب API؟

Throughput مصطلح من توثيق Meta معناه «معدل المعالجة»، ويُترجم عملياً «سرعة الإرسال»، ووحدته رسالة في الثانية (messages per second، واختصارها mps). تقول Meta إن Cloud API يدعم لكل رقم أعمال مسجّل حتى 80 رسالة في الثانية افتراضياً.

  • لكل رقم لا لكل حساب: كل رقم مسجّل له سرعته الخاصة، بعكس حد الرسائل الذي تتشاركه أرقام محفظة الأعمال كلها.
  • الوارد والصادر معاً: تنص Meta على أن السرعة تشمل الرسائل الواردة والصادرة بكل أنواعها، فرسائل عملائك إليك تُحسب أيضاً.
  • مجانية: لا تدفع مقابل السرعة، وتقول Meta إن الترقية لا تغيّر أسعار الرسائل.
  • ليست الحد الوحيد: تذكّر Meta بأن حدود معدل الطلبات لحساب واتساب للأعمال، وحدود الرسائل، تبقى سارية مهما كانت سرعتك.

وCloud API نفسه شرحناه في ما هو Cloud API في واتساب؟

كم رسالة في الثانية؟ المستويات الثلاثة

حالة الرقمالسرعة القصوىفي الدقيقة تقريباًملاحظة
رقم مسجّل على Cloud API80 رسالة/ثانية4,800القيمة الافتراضية
بعد الترقية التلقائية1,000 رسالة/ثانية60,000بثلاثة شروط في القسم التالي
رقم الربط المزدوج (تطبيق واتساب بيزنس + Cloud API)20 رسالة/ثانية1,200ثابتة حسب Meta

حسب صفحة Throughput ووثيقة ربط مستخدمي تطبيق واتساب بيزنس من Meta، اطّلعنا عليهما في 5 نوفمبر 2026. عمود الدقيقة حسابنا: السرعة × 60.

والربط المزدوج (Coexistence) يعني أن رقمك يعمل على التطبيق في موبايلك وعلى الـ API معاً؛ الشرح في ربط رقم واتساب بيزنس الحالي مع بقاء التطبيق.

كيف ترتفع السرعة إلى 1,000 رسالة في الثانية؟

لا يوجد طلب تقدمه. تنص صفحة Throughput على ترقية تلقائية للرقم إذا تحققت فيه الشروط الثلاثة، وكل منها مكتوب بصيغة «يجب»:

  1. حد رسائل غير محدود: محفظة الأعمال المرتبطة بالرقم يجب أن يكون حد رسائلها Unlimited، وهو أعلى مستوى بعد 250 و2,000 و10,000 و100,000.
  2. 100,000 عميل في يوم: الرقم نفسه يجب أن يكون قد راسل 100,000 رقم واتساب مختلف أو أكثر خارج نافذة خدمة العملاء خلال 24 ساعة متحركة.
  3. جودة أصفر أو أعلى: تقييم جودة الرقم (quality_score) يجب أن يكون YELLOW (متوسط) أو أفضل. والتقييم مشروح في ما هو Quality Rating؟
  • التكلفة: بلا رسوم، والأسعار لا تتغير.
  • دقيقة توقف: تقول Meta إن الترقية قد تستغرق حتى دقيقة، يكون الرقم خلالها غير قابل للاستخدام، وأي طلب API يرجع الخطأ 131057، وهو كود وضع الصيانة المشروح في الخطأ 131057 (الحساب في وضع الصيانة).
  • الزيادات اللاحقة: تتم تلقائياً بلا توقف.
  • الإشعار: يصل Webhook ‏phone_number_quality_update بالقيمة THROUGHPUT_UPGRADE في حقل event.

عملياً: الشرط الثاني وحده يعني أن 1,000 رسالة في الثانية مصممة للمرسلين الكبار جداً، كالبنوك وشركات الاتصالات وسلاسل التجزئة. أما متجر أو عيادة أو مكتب عقار في القاهرة أو الرياض فسرعة 80، بل 20، تكفيه في الغالب كما سترى في الأمثلة.

ما الفرق بين سرعة الإرسال وحد الرسائل؟

البندThroughput (سرعة الإرسال)Messaging Limit (حد الرسائل)
ماذا يقيس؟رسائل في الثانيةعملاء مختلفون خارج نافذة الخدمة خلال 24 ساعة متحركة
على أي مستوى؟الرقم الواحدمحفظة الأعمال كلها، تتشاركه أرقامها
ما الذي يُحسب؟الوارد والصادر بكل أنواعهالعملاء الذين تبدأ مراسلتهم خارج النافذة فقط؛ الردود داخلها لا تُحسب
القيم80، أو 1,000، أو 20 ثابتة للربط المزدوج250 ثم 2,000 ثم 10,000 ثم 100,000 ثم غير محدود
كيف يرتفع؟تلقائياً بالشروط الثلاثةالتوثيق أو مسارات التوسع إلى 2,000، ثم تلقائياً مع الجودة والاستخدام
أين تراه؟طلب API على الحقل throughputWhatsApp Manager، أو الحقل whatsapp_business_manager_messaging_limit

حسب صفحتي Throughput وMessaging limits من Meta، اطّلعنا عليهما في 5 نوفمبر 2026.

وهناك حدان آخران يختلطان بهما: Pair rate limit حين ترسل رسائل كثيرة لنفس العميل في وقت قصير، ويظهر بالخطأ 131056 (شرح الخطأ 131056)، وحد التسويق لكل مستخدم الذي يظهر بالخطأ 131049. وتقول Meta إن مستويات السرعة مصممة لحملات تذهب لأرقام عملاء مختلفة، لا لرقم واحد.

كم تستغرق حملتك فعلاً؟ أمثلة بالأرقام

متجر ملابس في القاهرة، حده 2,000 وسرعته 80: حملة عروض لـ 2,000 عميل تحتاج 2,000 ÷ 80 = 25 ثانية. ولو كانت قائمته 5,000 عميل فالسرعة تكفي لإرسالها في نحو دقيقة، لكن حد الرسائل لن يسمح بأكثر من 2,000 عميل مختلف خلال 24 ساعة. العائق هنا الحد لا السرعة، والحل تقسيم القائمة على 3 أيام.

محل عطور في جدة برقم ربط مزدوج (20 في الثانية): تذكير لـ 1,000 عميل يأخذ 1,000 ÷ 20 = 50 ثانية. ولأن الوارد يُحسب أيضاً، فإذا أطلق الحملة وقت ذروة الرسائل الواردة مساء الخميس تقل حصة الصادر من الـ 20، فالأفضل إطلاقها صباحاً.

سلسلة تجزئة كبيرة في الرياض: 100,000 رسالة بسرعة 80 تأخذ 1,250 ثانية، أي نحو 21 دقيقة، وبعد الترقية إلى 1,000 تأخذ 100 ثانية. هنا فقط تصنع السرعة فرقاً ملموساً.

الخلاصة لمعظم الأنشطة الصغيرة والمتوسطة: ركّز على رفع حد الرسائل وعلى جودة القوالب، فالسرعة نادراً ما تكون المشكلة.

ماذا يحدث إذا تجاوزت السرعة؟ الخطأ 130429

تقول صفحة Throughput إن الـ API يرجع الخطأ 130429 حتى تعود داخل المستوى المسموح. وفي صفحة أكواد الأخطاء يقع الكود ضمن أخطاء الحد من المعدل (Throttling)، ونص تفاصيله: Cloud API message throughput has been reached، أي بلغت سرعة الرسائل المسموحة. والحل الذي تكتبه Meta: أعد المحاولة لاحقاً، أو قلّل وتيرة إرسال تطبيقك.

  1. لا تطلق القائمة كلها في لحظة واحدة: أرسل بطابور منتظم أقل من حد رقمك.
  2. أعد المحاولة بانتظار متزايد: انتظر ثواني ثم أعد الرسائل التي رجعت بالكود، وضاعف الانتظار إذا تكرر.
  3. احسب الوارد: وقت الحملات تزيد ردود العملاء، وهي تأكل من السرعة نفسها.
  4. لا تخلطه بالخطأ 131056: ذاك يخص عميلاً واحداً، وتقول Meta إنك تستطيع مراسلة غيره دون انتظار.

والقائمة الكاملة للأكواد في دليل أكواد أخطاء واتساب API.

نصائح للمطورين: الفحص والـ Webhooks والميديا

  • افحص سرعة رقمك: GET /?fields=throughput. ومعرّف الرقم مشروح في ما هو Phone Number ID؟
  • جهّز خادم الـ Webhooks: توصي Meta بأن يتحمل 3 أضعاف حجم الرسائل الصادرة (لإشعارات الحالة) مع ضعف واحد من الوارد المتوقع، وبزمن استجابة وسيط 250 ملّي ثانية أو أقل، وأقل من 1% من الطلبات فوق ثانية. والإشعارات الفاشلة تعيد Meta إرسالها حتى 7 أيام.
  • الميديا: لسرعة أعلى ارفع الصور والملفات إلى خوادم Meta وأرسل معرّف الميديا بدل رابط على خادمك، وإن استضفتها بنفسك ففعّل التخزين المؤقت (HTTP caching).
  • راقب حدث الترقية في Webhook جودة الرقم، وتوقّع دقيقة من الخطأ 131057 أثناءها.

ما المفاهيم الخاطئة الشائعة عن سرعة الإرسال؟

  • «Throughput هو عدد الرسائل المسموح يومياً»: لا، هو معدل في الثانية. العدد اليومي للعملاء هو حد الرسائل.
  • «أستطيع شراء سرعة أعلى»: الترقية في توثيق Meta تلقائية ومجانية بشروط، ولا يذكر التوثيق طريقة لشرائها.
  • «ردود العملاء لا تُحسب»: تُحسب؛ السرعة تشمل الوارد والصادر.
  • «رقم ثانٍ يضاعف حد الرسائل»: كل رقم مسجّل له سرعته، لكن حد الرسائل واحد للمحفظة كلها.
  • «رقم الربط المزدوج لا يصلح للحملات»: 20 رسالة في الثانية تعني 1,200 في الدقيقة، وهذا يكفي معظم حملات الأنشطة الصغيرة.

كيف يساعدك مظبوت؟

  • حملات مجدولة حسب المنطقة الزمنية مع قوائم وشرائح، فتقسم القائمة الكبيرة على أيام وأوقات مناسبة بدل إطلاقها مرة واحدة. التفاصيل في الحملات الجماعية بالقوالب في مظبوت.
  • فحص الرقم ورمز الوصول قبل كل حملة، حتى لا تبدأ حملة على رقم غير جاهز.
  • رقمك الحالي مع بقاء التطبيق: بالربط المزدوج يبقى تطبيق واتساب بيزنس على موبايلك، بسرعة Meta الثابتة 20 رسالة في الثانية، وتنزل محادثاتك القديمة حتى 6 شهور.
  • حملات الـ 24 ساعة لمن راسلك اليوم، برسائل عادية داخل النافذة لا تُحسب من حد الرسائل.
  • واجهة API لإرسال القوالب من نظامك، مع Webhooks صادرة.
  • بدون أي عمولة على رسائل Meta، والاشتراك من 6$ شهرياً بعد خصم 50% (السعر الأصلي 12$).

أسئلة شائعة

كم رسالة في الثانية يرسل واتساب API؟

حتى 80 رسالة في الثانية لكل رقم مسجّل على Cloud API افتراضياً، وحتى 1,000 بعد الترقية التلقائية، و20 ثابتة لرقم يعمل على تطبيق واتساب بيزنس والـ API معاً، حسب Meta.

هل سرعة الإرسال هي حد الرسائل اليومي؟

لا. السرعة رسائل في الثانية لكل رقم، أما حد الرسائل فعدد العملاء المختلفين الذين تراسلهم خارج نافذة الخدمة خلال 24 ساعة، ويبدأ من 250 لمحفظة الأعمال كلها.

هل أدفع مقابل رفع السرعة إلى 1,000؟

لا. تقول Meta إن الترقية بلا رسوم ولا تغيّر الأسعار، وتتم تلقائياً عند تحقق الشروط الثلاثة.

ماذا يعني الخطأ 130429؟

أن رقمك بلغ حد سرعة الرسائل في Cloud API. أعد المحاولة بعد قليل، أو قلّل وتيرة الإرسال ووزّع حملتك على طابور منتظم.

هل يحتاج نشاط صغير إلى 1,000 رسالة في الثانية؟

غالباً لا. بسرعة 80 تصل حملة من 2,000 عميل في 25 ثانية، والعائق الحقيقي عادة حد الرسائل وجودة القوالب، لا السرعة.

المصادر

حملات منظمة.. لعملاء وافقوا

مع مظبوت تجدول حملات القوالب على شرائح من وافق وحسب المنطقة الزمنية، وتتابع من راسلك اليوم بحملات الـ 24 ساعة، وتربط رقمك الحالي مع بقاء تطبيق واتساب بيزنس، بدون أي عمولة على أسعار Meta. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%، مع 250,000 توكن ذكاء اصطناعي مجاناً للحسابات الجديدة.

ابدأ تجربتك المجانية