آخر تحديث: 3 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر الأساسي: صفحة أكواد الأخطاء وتوثيق حدود المعدل (Rate limits) من Meta
الإجابة المختصرة: الخطأ 131056 يعني أن رقمك أرسل رسائل كثيرة إلى نفس العميل في وقت قصير، فتجاوز «حد الزوج» (Pair rate limit): رسالة كل 6 ثوانٍ تقريباً، أي نحو 10 في الدقيقة، مع دفعة حتى 45 رسالة تُخصم من رصيدك اللاحق. الحل: أوقف الإرسال لهذا الرقم مؤقتاً، وأعد المحاولة بعد 1 ثم 4 ثم 16 ثانية، وابحث عن السبب، وهو غالباً حلقة بوت أو إرسال مكرر. باقي عملائك لا يتأثرون.
محتوى المقال:
- ما معنى الخطأ 131056؟
- كم رسالة تستطيع إرسالها لنفس العميل؟
- 6 أسباب شائعة للخطأ
- الحل خطوة بخطوة
- للمطورين: كيف تمنعه في نظامك؟
- الفرق بينه وبين 130429 و131048 و131049
- كيف يساعدك مظبوت؟
- أسئلة شائعة
ما معنى الخطأ 131056 في واتساب API؟
حسب صفحة أكواد الأخطاء الرسمية من Meta، يظهر الكود 131056 ضمن «أخطاء الحدّ من الإرسال» (Throttling errors) عندما تخرج رسائل كثيرة من رقم شركتك إلى رقم العميل نفسه في فترة قصيرة. والحل الذي تكتبه Meta: انتظر ثم أعد المحاولة إذا كنت تريد مراسلة نفس الرقم.
- الحد على «الزوج» لا على رقمك كله: رقم شركتك مع رقم عميل واحد. تستطيع مراسلة باقي العملاء فوراً.
- اسمه في بعض المنصات: «Pair rate limit hit»، لكن اعتمد في نظامك على رقم الكود لا على العنوان.
- مؤقت: يستمر حتى يعود معدل رسائلك لهذا العميل إلى المسموح. ولا يعني مخالفة لسياسة واتساب، لكن الرسائل الكثيرة التي سبقته قد تزعج العميل فيحظرك، والحظر هو ما يضر جودة رقمك.
- لا تدفع ثمن الرسالة الفاشلة، لكنك تدفع ثمن كل قالب وصل قبلها، وهذا مهم إذا كان السبب حلقة ترسل قوالب.
كم رسالة تستطيع إرسالها لنفس العميل في واتساب API؟
يحدد توثيق Meta لحدود المعدل (Rate limits) «حد الزوج» بالأرقام:
| القاعدة | الرقم حسب Meta |
|---|---|
| المعدل المستمر لنفس العميل | رسالة كل 6 ثوانٍ (0.17 رسالة في الثانية)، أي نحو 10 في الدقيقة أو 600 في الساعة |
| الدفعة (Burst) | حتى 45 رسالة خلال 6 ثوانٍ، لكنها «تقترض» من رصيدك القادم |
| بعد الدفعة | تنتظر الوقت اللازم لإرسال نفس العدد بالمعدل العادي: 20 رسالة تعني نحو دقيقتين |
| عند تجاوز الحد | الخطأ 131056 حتى تعود إلى المعدل المسموح |
| إعادة المحاولة | بعد 4^X ثانية: 1، ثم 4، ثم 16، ثم 64، حتى تنجح |
حسب صفحة Meta «About the platform»، قسم Pair rate limits (اطّلعنا عليها في 3 نوفمبر 2026).
احسبها على نشاطك: دفعة من 12 رسالة لنفس العميل تعني انتظار نحو 72 ثانية (12 × 6) قبل الرسالة التالية، ودفعة من 45 رسالة تعني نحو 4.5 دقائق. وهذا الحد منفصل عن سرعة رقمك الكلية: 80 رسالة في الثانية افتراضياً، ترتفع تلقائياً حتى 1,000 للأرقام المؤهلة، و20 رسالة في الثانية للأرقام المربوطة بالربط المزدوج (Coexistence). وتجاوز السرعة الكلية له كود آخر هو 130429.
مثال من جدة: عيادة أسنان صمّمت فلو ترحيب يرسل 12 رسالة متتالية: ترحيباً، و10 صور للأطباء، وقائمة الخدمات. بعد 30 ثانية كتبت موظفة الاستقبال رداً للمريض ففشل بالخطأ 131056، لأن الدفعة تحتاج نحو 72 ثانية. الحل: قائمة اختيار واحدة بأسماء الأطباء بدلاً من 10 صور، وتأخير بين خطوات الفلو.
ما الأسباب الشائعة للخطأ 131056؟
الرد العادي لا يقترب من هذا الحد. إذا ظهر الخطأ فابحث عادة عن واحد من هذه الأسباب:
- حلقة بين بوتين: عميلك نفسه شركة عليها رد آلي، مثل مورّد في الرياض يرد على كل رسالة بـ «شكراً لتواصلك، سنرد قريباً». بوتك يرد «لم أفهم، اختر من القائمة»، وردّه الآلي يرد عليك، وهكذا بلا توقف.
- حلقة بسبب إشعارات الحالة: نظام متجر في الإسكندرية يرسل قالب «تم شحن طلبك» عند كل إشعار يصله، فيعامل إشعار «تم التسليم» الخاص بالقالب نفسه كحدث جديد ويرسل القالب مرة أخرى. وكل قالب يصل مدفوع.
- إعادة المحاولة بلا انتظار: انتهت مهلة الطلب (Timeout) فأعاد النظام الإرسال فوراً عدة مرات، مع أن الرسالة الأولى ربما خرجت فعلاً.
- إشعارات Webhook مكررة: إذا لم يرد خادمك على Meta بنجاح، تعيد Meta إرسال الإشعار لمدة قد تصل إلى 7 أيام، وتقول إن ذلك قد ينتج إشعارات مكررة. ونظام يرد على كل نسخة يرسل للعميل نفس الرد مراراً.
- أرقام الاختبار: مطور يجرّب فلو أو قالباً على موبايله عشرات المرات في دقائق، أو سكربت اختبار يستهدف رقماً واحداً.
- رسائل مقسّمة أو أنظمة متعددة: رد طويل مقسّم على 8 رسائل، أو صور منتجات تُرسل واحدة واحدة، أو بوت ونظام طلبات وحملة تراسل نفس العميل في نفس اللحظة. ويزيد الأمر سوءاً تكرار الرقم في القائمة بصيغ مختلفة، مثل 01012345678 و201012345678.
كيف تحل الخطأ 131056 خطوة بخطوة؟
- لا تعامله كخطأ دائم: رقمك وقالبك سليمان، والمشكلة في سرعة الرسائل لهذا العميل.
- أوقف الإرسال لهذا الرقم فقط، واترك باقي الإرسال يعمل.
- أعد المحاولة بتأخير متزايد كما توصي Meta: بعد ثانية، ثم 4، ثم 16، ثم 64 ثانية. ونقترح حداً أقصى 5 محاولات، ثم تحويل الرسالة لقائمة مراجعة بدلاً من التكرار بلا نهاية.
- افحص سجل هذا العميل: كم رسالة خرجت له في آخر 5 دقائق؟ ومن أي نظام؟ وهل هي ردود متطابقة على نفس الرسالة الواردة؟ التطابق علامة حلقة أو تكرار.
- اقطع الحلقة: أوقف البوت في هذه المحادثة وحوّلها لموظف، ثم أصلح القاعدة التي سببتها.
- ادمج الرسائل: رد واحد كامل بأزرار أو قائمة بدلاً من 5 رسائل قصيرة.
- اختبر بأكثر من رقم، أو انتظر بين التجارب حسب قاعدة الدفعة.
للمطورين: كيف تمنع الخطأ 131056 في نظامك؟
| المشكلة | الحل |
|---|---|
| إعادة محاولة متسرعة | تأخير متزايد بصيغة Meta 4^X ثانية، مع فارق عشوائي صغير بين الطلبات (اقتراحنا) |
| إشعارات مكررة | احفظ معرّف كل رسالة واردة (id، ويبدأ عادة بـ wamid)، وتجاهل أي إشعار عالجته من قبل |
| دفعات لنفس العميل | طابور (Queue) لكل رقم عميل: متوسط رسالة كل 6 ثوانٍ، ودفعات صغيرة فقط |
| حلقة بين بوتين | حد أقصى للردود الآلية المتتالية (3 مثلاً) دون رد بشري، وإيقاف البوت عند تكرار نفس الرسالة الواردة |
| حلقة إشعارات الحالة | لا تجعل إشعارات sent وdelivered وread تطلق رسائل جديدة |
| أرقام مكررة في القوائم | حوّل كل الأرقام إلى الصيغة الدولية (مثل 201012345678 أو 966501234567) واحذف التكرار قبل أي حملة |
والأهم: سجّل مع كل فشل رقم العميل ووقت آخر رسالة خرجت له، فبهذا وحده تكتشف الحلقات في دقائق.
ما الفرق بين 131056 و130429 و131048 و131049؟
| الكود | النطاق | المعنى حسب Meta | ماذا تفعل؟ |
|---|---|---|---|
| 131056 | رقمك مع عميل واحد | رسائل كثيرة لنفس العميل في وقت قصير | انتظر وأعد المحاولة بتأخير متزايد |
| 130429 | رقمك كله | تجاوزت سرعة الإرسال (Throughput) | أبطئ الإرسال وأعد المحاولة لاحقاً |
| 131048 | رقمك كله | قيود بسبب حظر أو بلاغات سبام | أوقف الحملات وحسّن الجودة (شرح الخطأ 131048) |
| 131049 | عميل واحد | العميل بلغ حد رسائل التسويق لكل مستخدم | انتظر 24 ساعة على الأقل (شرح الخطأ 131049) |
| 4 و80007 | تطبيقك أو حسابك | تجاوزت حد طلبات الـ API | قلّل عدد الطلبات وأعد لاحقاً |
حسب صفحة أكواد الأخطاء من Meta (اطّلعنا عليها في 3 نوفمبر 2026). القائمة الكاملة في دليل أكواد أخطاء واتساب API.
كيف يساعدك مظبوت؟
- موظف ذكاء اصطناعي ينتظر حتى ينتهي العميل من رسائله ثم يرد مرة واحدة، بدلاً من رد على كل رسالة.
- Flow Builder بتأخير لكل خطوة و12 نوعاً من الخطوات، منها الأزرار والقوائم، فتجمع الاختيارات في رسالة واحدة. اقرأ شرح بناء فلو على واتساب.
- قوالب كاروسيل من 2 إلى 10 بطاقات لعرض المنتجات في رسالة واحدة بدلاً من 10.
- تحويل لموظف بكلمات مثل «موظف» و«مساعدة» يوقف البوت وينبّه فريقك، فلا يرد البوت والموظف معاً.
- في الربط المزدوج (Coexistence) لا تعمل الأتمتة على الرسائل التي ترسلها من تطبيق واتساب بيزنس ولا على المحادثات القديمة المستوردة، فلا يرد البوت على رسائلك أنت.
- API وWebhooks لإرسال القوالب من نظامك، وتدفع رسائل Meta لـ Meta مباشرة بدون أي عمولة.
أسئلة شائعة
هل الخطأ 131056 يعني أن رقمي محظور؟
لا. هو حد سرعة مؤقت بين رقمك وعميل واحد، ويختفي عندما تبطئ الرسائل لهذا العميل. لكن عالج سببه بسرعة، فالحلقات التي تُغرق العميل بالرسائل تدفعه للحظر أو البلاغ.
كم أنتظر قبل مراسلة نفس العميل مرة أخرى؟
حسب Meta: رسالة كل 6 ثوانٍ في المتوسط، وبعد الدفعة تنتظر نحو 6 ثوانٍ عن كل رسالة فيها (20 رسالة تعني دقيقتين تقريباً). وعند الفشل أعد المحاولة بعد 1 ثم 4 ثم 16 ثانية.
هل يؤثر الخطأ على باقي عملائي؟
لا. الحد خاص بكل زوج من رقمك ورقم عميل واحد، وتستطيع مراسلة الآخرين فوراً.
هل أدفع على الرسالة التي فشلت بالخطأ 131056؟
لا، Meta تحاسب على المُسلَّم فقط. لكن القوالب التي وصلت قبل الفشل مدفوعة: حلقة ترسل قالب Utility لعميل سعودي 45 مرة تكلفك 45 × 0.0107 = 0.48$ تقريباً (أسعار Meta السارية من 1 أكتوبر 2026)، والأخطر أنها تدفع العميل للحظر.
هل يظهر الخطأ مع الحملات الجماعية العادية؟
نادراً، لأن الحملة ترسل رسالة واحدة لكل عميل. إذا ظهر أثناء حملة فابحث عن رقم مكرر في القائمة، أو حملتين مجدولتين في نفس الوقت، أو أتمتة تطلق رسائل إضافية لنفس العملاء.
هل الحد مختلف للأرقام المربوطة بالربط المزدوج؟
لا يذكر توثيق Meta حد زوج مختلفاً لها. الفرق الموثّق أن سرعة الرقم الكلية في الربط المزدوج ثابتة عند 20 رسالة في الثانية.
اقرأ أيضاً:
المصادر
- Meta: WhatsApp Cloud API error codes (Throttling errors) (اطّلعنا عليها في 3 نوفمبر 2026)
- Meta: About the platform (Rate limits و Pair rate limits) (اطّلعنا عليها في 3 نوفمبر 2026)
- Meta: Throughput (اطّلعنا عليها في 3 نوفمبر 2026)
- Meta: Webhooks overview (إعادة الإرسال والإشعارات المكررة) (اطّلعنا عليها في 3 نوفمبر 2026)
- Meta: Pricing on the WhatsApp Business Platform (اطّلعنا عليها في 3 نوفمبر 2026)
- ChakraHQ: Throttling errors (مثال على عنوان Pair rate limit hit) (اطّلعنا عليها في 3 نوفمبر 2026)
ردود أقل عدداً وأكثر فائدة
مع مظبوت: موظف ذكاء اصطناعي يرد مرة واحدة بعد أن ينتهي العميل من رسائله، وفلو بتأخير لكل خطوة، وكاروسيل بدل 10 رسائل، وتحويل فوري لموظف، بدون أي عمولة على أسعار Meta. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%، مع 250,000 توكن ذكاء اصطناعي مجاناً للحسابات الجديدة.