مخطط حدود معدل WhatsApp API — ثلاثة أنظمة حدود: الإنتاجية لكل ثانية، طبقة المراسلة اليومية، حد التكرار لكل مستلم — مع حلقة تغذية راجعة لتقييم الجودة
في هذا المقال: أنظمة حدود المعدل الثلاثة · جدول طبقة المراسلة · قواعد ترقية الطبقة · تقييم الجودة (GREEN/YELLOW/RED) · حد التكرار لكل مستلم · أكواد الأخطاء الدقيقة والاستجابات · ما يجب عدم إعادة المحاولة أبداً · سلوك إيقاف الحساب · كود إعادة المحاولة للإنتاج · استراتيجية تسخين الرقم · الأسئلة الشائعة

أنظمة حدود المعدل الثلاثة — ولماذا هي مختلفة

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

01
الإنتاجية لكل ثانية
80 رسالة/ثانية لكل رقم هاتف. حد بنية API. يعيد HTTP 429 فوراً. أعد المحاولة بتراجع أسي.
HTTP 429
02
طبقة المراسلة اليومية
1K / 10K / 100K / غير محدود من جهات اتصال فريدة بدأها النشاط التجاري لكل 24 ساعة. يُعاد ضبطها عند منتصف الليل UTC. لا تعد المحاولة في نفس اليوم.
خطأ 131048
03
حد التكرار لكل مستلم
تحظر Meta بصمت رسائل التسويق للمستلمين الذين تلقوا الكثير من أي نشاط تجاري خلال آخر 24–48 ساعة. لا تعد المحاولة أبداً.
خطأ 131049

حد المعدل 1: إنتاجية API لكل ثانية

تدعم Cloud API 80 رسالة في الثانية لكل رقم هاتف افتراضياً. هذا حد بنية API نقي — مفروض على مستوى المللي ثانية. تجاوزه يعيد HTTP 429 فوراً مع خطأ حد معدل قياسي. هذا الحد قابل للتوسع: اتصل بـ Meta لزيادته إلى 1,000 رسالة في الثانية للمرسلين عاليي الحجم.

استجابة الخطأ عندما تصل إلى هذا الحد:

HTTP 429 Response
per-second-limit.json
HTTP/1.1 429 Too Many Requests Retry-After: 1 Content-Type: application/json { "error": { "message": "(#613) Calls to this api have exceeded the rate limit.", "type": "OAuthException", "code": 613, "fbtrace_id": "AbCdEfGh..." } } // إعادة المحاولة: نعم — استخدم تراجعاً أسياً بدءاً من ثانية واحدة // رأس Retry-After استشاري — احترمه ولكن أضف jitter أيضاً

الوقاية أفضل من الاسترداد. بمعدل 80 رسالة/ث، يستغرق إرسال 10,000 رسالة 125 ثانية. للعمليات المجمّعة، أضف تأخير 15–20 مللي ثانية بين الإرسالات للبقاء بشكل مريح تحت 50–60 رسالة/ث — بأمان دون الحد مع الحفاظ على معدل نجاح تسليم 99%+.

حد المعدل 2: حدود طبقة المراسلة اليومية

هذا هو الحد الذي يعنيه معظم الناس عندما يقولون "حدود معدل WhatsApp". طبقة المراسلة تتحكم في عدد العملاء الفريدين الذين يمكن لرقم هاتفك إرسال رسائل بدأها النشاط التجاري إليهم في نافذة متجددة لمدة 24 ساعة. الطبقة لكل رقم هاتف، لا لكل حساب.

رسائل الجلسة ليست محدودة بالطبقة. طبقة المراسلة اليومية تحسب فقط الرسائل التي بدأها النشاط التجاري — رسائل القوالب المُرسلة لبدء محادثات جديدة أو لعملاء خارج نافذة الخدمة لـ 24 ساعة. عندما يرسل عميل لك رسالة أولاً، كل الردود ضمن نافذة الخدمة الناتجة لـ 24 ساعة هي رسائل جلسة — لا تُحسب ضمن طبقتك اليومية. يمكنك إرسال رسائل جلسة غير محدودة في أي طبقة.
الطبقة جهات اتصال فريدة / 24 ساعة الحالة الأولية شرط الترقية شرط التخفيض
الطبقة 1 1,000 جهة اتصال فريدة جميع الأرقام الجديدة 7 أيام من الاستخدام المتسق بسعة 80%+، تقييم جودة GREEN/YELLOW تقييم الجودة ينخفض إلى RED
الطبقة 2 10,000 جهة اتصال فريدة مرقّاة تلقائياً 7 أيام بنسبة 80%+ من 10K/يوم، جودة GREEN/YELLOW تقييم الجودة RED ← ينخفض إلى الطبقة 1
الطبقة 3 100,000 جهة اتصال فريدة مرقّاة تلقائياً 7 أيام بنسبة 80%+ من 100K/يوم، جودة GREEN/YELLOW تقييم الجودة RED ← ينخفض إلى الطبقة 2
الطبقة 4 غير محدود مرقّاة تلقائياً تتحقق بعد تقدم الطبقة 3 تقييم الجودة RED ← ينخفض إلى الطبقة 3

استجابة الخطأ عند تجاوز طبقتك اليومية:

HTTP 200 مع خطأ في الجسم (الحالة: فشل)
error-131048.json
{ "messaging_product": "whatsapp", "contacts": [{ "input": "+15550001234", "wa_id": "15550001234" }], "messages": [{ "id": "wamid.HBgL..." }] } // الإرسال الأولي يعيد 200. الفشل يصل لاحقاً كحدث حالة webhook: { "statuses": [{ "id": "wamid.HBgL...", "status": "failed", "errors": [{ "code": 131048, "title": "Message failed to send because too many messages were sent from the sender phone number.", "details": "Messages to this phone number are being sent too quickly." }] }] } // حرج: لا تعد المحاولة على 131048. انتظر إعادة الضبط عند منتصف الليل UTC. // إعادة المحاولة تهدر استدعاءات API ولا تتجاوز حد الطبقة.

تقدم الطبقة: كيف تنتقل من 1K إلى غير محدود

ترقية الطبقة من Meta تلقائية — لا يمكنك طلبها مباشرة. تحدث بناءً على ثلاث إشارات تُقاس على مدى نافذة متجددة لمدة 7 أيام:

  1. عتبة الحجم: يجب أن تصل باستمرار إلى 80%+ من الحد اليومي لطبقتك الحالية. رقم في الطبقة 1 يرسل فقط 200 رسالة/يوم لن يُرقَّى أبداً — حتى مع تقييم جودة مثالي.
  2. تقييم الجودة: يجب أن يكون GREEN أو YELLOW. تقييم RED يمنع الترقية تماماً ويُطلق تخفيضاً فورياً.
  3. الوقت: تُقيّم Meta بعد 7 أيام متتالية من تلبية كلا المعيارين. الترقية ليست فورية.
التخفيض فوري، الترقية ليست كذلك: انخفاض تقييم الجودة إلى RED ينقلك فوراً طبقة واحدة للأسفل — تستيقظ في اليوم التالي بحد أقل. الاسترداد للأعلى يتطلب 7 أيام من التشغيل النظيف في الطبقة الأدنى الجديدة. هذا التفاوت يعني أن حملة بث سيئة واحدة يمكن أن تعيد تقدم طبقتك أسابيع للوراء. احمِ تقييم جودتك بنفس عدوانية حمايتك لسمعة المرسل.

حلقة التغذية الراجعة لتقييم الجودة

تقييم الجودة (GREEN / YELLOW / RED) هو أهم رقم في صحة WhatsApp API لديك. تحسبه Meta على نافذة متجددة لمدة 7 أيام بناءً على إشارات من مستلمي الرسائل — تحديداً: الحظر، وتقارير البريد المزعج، والتغذية الراجعة السلبية بالنسبة لحجم إرسالك.

GREEN
صحي — مؤهل لترقية الطبقة
معدل حظر وتقارير بريد مزعج منخفض بالنسبة لحجم الإرسال. المستلمون يتفاعلون إيجابياً — يردون، يواصلون المحادثات. مؤهل للترقية التلقائية للطبقة بعد 7 أيام بسعة 80%+. هذه هي الحالة المستهدفة لأي مرسل إنتاج.
YELLOW
تحذير — ترقية الطبقة متوقفة
معدل حظر أو تقارير بريد مزعج متوسط. لا تزال تستطيع الإرسال بحد طبقتك الحالية — لا تخفيض فوري. لكن ترقية الطبقة متوقفة. تراقب Meta لمدة 7 أيام: إذا تحسنت الجودة إلى GREEN، تبقى في الطبقة الحالية. إذا تدهورت إلى RED، يحدث تخفيض فوري.
RED
حرج — تخفيض فوري
معدل حظر أو تقارير بريد مزعج مرتفع. فوري: يتم نقلك طبقة واحدة للأسفل. RED مستدام لـ 7+ أيام يخاطر بأن يتم وسم رقم الهاتف أو تعطيله كلياً. هذه هي حالة الفشل المتسلسل — حملة سيئة تخلق تقييم RED ← تخفيض ← الحملة التالية لديها سعة أقل ← ضغط أكبر للإرسال بالحد ← المزيد من الحظر.

تقييم الجودة غير معروض في Cloud API مباشرة — يجب أن تتحقق منه في Meta Business Manager (WhatsApp Manager ← Phone Numbers ← عمود Quality Rating) أو الاشتراك في حقل webhook phone_number_quality_update. اشترك في هذا الحقل وابنِ تنبيهاً لتعرف فوراً عندما تتدهور جودتك.

حد المعدل 3: حد التكرار لكل مستلم (الذي لا يشرحه أحد)

هذا هو حد المعدل الذي يربك معظم المطورين لأنه منفصل تماماً عن طبقة حسابك، يعمل عالمياً عبر جميع الأنشطة التجارية، ويفشل بصمت مع رسالة خطأ مضللة.

تحدد ميزة تحديد التكرار من Meta عدد رسائل التسويق التي يمكن لمستخدم WhatsApp معين تلقيها من أي نشاط تجاري في نافذة زمنية محددة (24–48 ساعة). هذه Meta تحمي المستخدمين من فيضان رسائل التسويق عبر المنصة بأكملها — ليس فقط رسائلك. إذا تلقى المستخدم رسائل قوالب تسويقية من 5 أنشطة تجارية أخرى اليوم، فقد يتم حظر رسالتك التسويقية المشروعة تماماً لذلك المستخدم بصمت.

الخطأ الذي تتلقاه:

webhook الحالة — خطأ 131049
frequency-cap-error.json
{ "statuses": [{ "id": "wamid.HBgL...", "status": "failed", "errors": [{ "code": 131049, "title": "This message was not delivered to maintain a healthy ecosystem.", "details": "Unhealthy system activity" }] }] } // هذا تحديد تكرار لكل مستلم — ليس خطأ حسابك // يؤثر على قوالب التسويق فقط // قوالب UTILITY وAUTHENTICATION ليست محدودة بالتكرار لكل مستلم // لا تعد المحاولة — الحد على مستوى النظام، لا لكل مرسل // سجّل جهات الاتصال الفاشلة، لا تعد المحاولة لمدة 48 ساعة

حقائق رئيسية حول تحديد التكرار لكل مستلم:

  • قوالب التسويق فقط. قوالب Utility (تأكيدات الطلبات، تحديثات الشحن، تذكيرات المواعيد) وقوالب المصادقة (OTPs) ليست خاضعة لتحديد التكرار لكل مستلم. إذا كان من الممكن تصنيف حملتك "التسويقية" بشكل مشروع كـ utility، فأعد تصنيف القالب.
  • الحد عالمي، ليس لكل مرسل. ليس لديك رؤية في عدد رسائل التسويق التي تلقاها المستلم من أنشطة تجارية أخرى. لا يمكنك التنبؤ بأي إرسالات ستُحد.
  • معدل فشل متوقع 10–40% على حملات التسويق لمستخدمي WhatsApp النشطين جداً طبيعي. هذه ليست مشكلة في حسابك — إنها المنصة تحمي المستخدمين. خصص ميزانية لذلك.
  • لا تعد محاولة فشل 131049 أبداً. سيتم تحديد تكرار المستلم لـ 24–48 ساعة. إعادة المحاولة تهدر الإرسالات، تحرق حصة طبقتك اليومية، وقد تضر تقييم جودتك.

مرجع أكواد الأخطاء الكامل

HTTP 429
تم تجاوز حد الإنتاجية لكل ثانية
الكثير من استدعاءات API في وقت قصير جداً. يُعاد فوراً مع رأس Retry-After. معدل إرسالك تجاوز 80 رسالة/ث (أو حدك المخصص). هذا حظر على مستوى البنية — الرسالة لم تُجدول أبداً.
✓ أعد المحاولة بتراجع أسي + jitter
131048
تم تجاوز حد طبقة المراسلة اليومية
وصل رقم هاتفك إلى حد جهات الاتصال الفريدة لـ 24 ساعة للطبقة الحالية (1K، 10K، أو 100K). يبدو الإرسال ناجحاً في البداية (يعيد 200) لكنه يفشل بشكل غير متزامن — تتلقى هذا الكود في حدث webhook الحالة. الرسالة لم تُسلَّم.
⏳ لا تعد المحاولة اليوم — جدول بعد إعادة الضبط عند منتصف الليل UTC
131049
حد التكرار لكل مستلم — "Unhealthy system activity"
المستلم المحدد تلقى الكثير من رسائل التسويق من جميع الأنشطة التجارية خلال آخر 24–48 ساعة. حظرت Meta تسليم قالب التسويق الخاص بك لحماية هذا المستخدم. ينطبق فقط على قوالب فئة التسويق. قوالب utility والمصادقة غير متأثرة.
✗ لا تعد المحاولة أبداً — المستلم محدود عالمياً لـ 24–48 ساعة
131016
الخدمة غير متاحة مؤقتاً
خطأ عابر في بنية Meta التحتية. ليس حد معدل — فشل من جانب الخادم. الرسالة قد تكون أو لا تكون مُدرجة في قائمة الانتظار قبل الخطأ. آمن لإعادة المحاولة بعد 30–60 ثانية. تحقق من Meta Status للحوادث الجارية.
✓ أعد المحاولة بعد 30–60 ث (حد أقصى 3 محاولات)
131031
حساب النشاط التجاري مقفل
تم قفل WhatsApp Business Account الخاص بك مؤقتاً بسبب نشاط مشبوه أو انتهاك سياسة. كل الإرسالات تفشل فوراً. تحقق من Meta Business Manager لتفاصيل الانتهاك. لا تحاول الالتفاف — حل الانتهاك مباشرة مع دعم Meta.
✗ لا تعد المحاولة — حل الانتهاك في Meta Business Manager

ما يجب عدم إعادة المحاولة أبداً — القاعدة التي تنقذ تقييم جودتك

الخطأ الأكثر ضرراً في معالجة أخطاء WhatsApp API: إعادة محاولة أخطاء 131048 و131049. كلاهما فشل غير متزامن — أعاد API الرمز 200، اعتقدت أن الرسالة أُرسلت، ثم تتلقى الخطأ لاحقاً في حدث webhook الحالة. كثير من المطورين يرون الفشل ويعيدون المحاولة فوراً. هذا خطأ، وإليك السبب:

  • 131048 (حد الطبقة): النافذة لا تُعاد ضبطها حتى منتصف الليل UTC. إعادة المحاولة تعني أنك تحرق رسائل إضافية من حصتك اليومية، تفشل مرة أخرى، وتحرق المزيد من الحصة. تخاطر أيضاً بإرسال رسالة مكررة لنفس العميل عند إعادة ضبط النافذة. سجّل الفشل مع وقت إعادة المحاولة المجدول (منتصف الليل UTC) وامضِ.
  • 131049 (حد التكرار): المستلم محدود على مستوى النظام، لا منك. إعادة المحاولة لا تفعل شيئاً سوى: (أ) استهلاك حصة طبقتك اليومية، (ب) المخاطرة بتوليد إشارة "فشل" في حالة التسليم قد تؤثر هامشياً على تقييم جودتك إذا فُسرت كمحاولة بريد مزعج، (ج) احتمال إزعاج المستلم عند رفع الحد ويتلقى مكررات. سجّل وتجاوز لـ 48 ساعة.
شجرة قرار إعادة المحاولة: HTTP 429 ← أعد المحاولة بتراجع. خطأ 131048 في webhook الحالة ← سجّل، جدول بعد منتصف الليل UTC. خطأ 131049 في webhook الحالة ← سجّل، تجاوز لـ 48 ساعة. خطأ 131016 ← أعد المحاولة مرة واحدة بعد 30–60 ث. خطأ 131031 ← أوقف كل الإرسالات، أصلح الحساب. أي 5xx آخر ← أعد المحاولة حتى 3 مرات بتراجع أسي.

إيقاف الحساب مقابل التقييد على مستوى الرقم

هناك حالتان مختلفتان للحساب تبدوان مثل "حسابي توقف عن العمل" لكن لهما أسباب وحلول مختلفة:

تقييد رقم الهاتف — مراسلة رقم الهاتف المحدد محدودة أو متوقفة. يحدث هذا عندما يبقى تقييم الجودة RED لـ 7+ أيام أو عندما يتلقى الرقم انتهاك سياسة محدداً. الأرقام الأخرى في WABA الخاص بك تستمر في العمل. تحقق من حالة الرقم في WhatsApp Manager ← Phone Numbers. يُظهر حقل الحالة "Connected" أو "Offline" أو "Flagged" أو "Restricted".

تعليق WABA — WhatsApp Business Account بأكمله معلّق. كل أرقام الهواتف تحت WABA تتوقف عن الإرسال والاستقبال. يحدث هذا من انتهاكات سياسة جسيمة أو كشف احتيال على مستوى الحساب. تتلقى حدث webhook account_update بـ event: ACCOUNT_RESTRICTION أو event: ACCOUNT_VIOLATION.

للوكالات: لهذا السبب WABA واحد لكل عميل إلزامي. تعليق WABA لعميل واحد ليس له أي تأثير على WABAs العملاء الآخرين.

كود إعادة المحاولة للإنتاج: التعامل مع جميع أنواع حدود المعدل بشكل صحيح

Node.js — إرسال إنتاجي واعٍ بحد المعدل
rateLimitAwareSend.js
const { sendWhatsApp } = require('./whatsapp'); const { scheduleRetry } = require('./scheduler'); const { logFailure } = require('./logger'); // أكواد الأخطاء التي لا ينبغي أبداً إعادة محاولتها فوراً const NO_RETRY_CODES = new Set([131049, 131031]); // حد التكرار، قفل الحساب const RETRY_NEXT_DAY = new Set([131048]); // حد الطبقة const RETRY_WITH_BACKOFF = new Set([131016]); // خطأ عابر async function sleep(ms) { return new Promise(r => setTimeout(r, ms)); } // يتعامل مع 429s لكل ثانية بتراجع أسي async function sendWithThroughputRetry(to, body, attempt = 0) { try { return await sendWhatsApp(to, body); } catch (err) { if (err.status !== 429 || attempt >= 5) throw err; // تراجع أسي مع jitter لحد الإنتاجية لكل ثانية const delay = Math.min( 1000 * 2 ** attempt + Math.random() * 500, 60000 ); console.warn(`429 — waiting ${Math.round(delay)}ms (attempt ${attempt + 1}/5)`); await sleep(delay); return sendWithThroughputRetry(to, body, attempt + 1); } } // يُستدعى من معالج webhook الحالة عند فشل رسالة بشكل غير متزامن async function handleFailedStatus(failedStatus) { const errorCode = failedStatus.errors?.[0]?.code; const recipient = failedStatus.recipient_id; const messageId = failedStatus.id; if (NO_RETRY_CODES.has(errorCode)) { // 131049: حد التكرار — تجاوز لـ 48 ساعة. 131031: قفل الحساب — أصلح يدوياً. await logFailure({ messageId, recipient, errorCode, action: 'no_retry' }); return; } if (RETRY_NEXT_DAY.has(errorCode)) { // 131048: حد الطبقة اليومية — جدول إعادة المحاولة بعد منتصف الليل UTC const midnightUTC = new Date(); midnightUTC.setUTCHours(0, 5, 0, 0); // 00:05 UTC اليوم التالي — هامش 5 دقائق midnightUTC.setUTCDate(midnightUTC.getUTCDate() + 1); await scheduleRetry({ messageId, recipient, retryAt: midnightUTC }); await logFailure({ messageId, recipient, errorCode, action: 'scheduled_retry', retryAt: midnightUTC }); return; } if (RETRY_WITH_BACKOFF.has(errorCode)) { // 131016: خطأ عابر — أعد المحاولة مرة واحدة بعد 60 ث await scheduleRetry({ messageId, recipient, retryAt: new Date(Date.now() + 60000) }); return; } // كود خطأ غير معروف — سجّل ونبّه للمراجعة اليدوية await logFailure({ messageId, recipient, errorCode, action: 'manual_review' }); } // مرسل مجمّع مع تحديد معدل مدمج async function bulkSendThrottled(contacts, message, delayMs = 20) { const results = { sent: 0, failed: [] }; for (const contact of contacts) { try { await sendWithThroughputRetry(contact.phone, message); results.sent++; } catch (err) { results.failed.push({ ...contact, error: err.message }); } await sleep(delayMs); // 20 مللي ثانية = ~50 رسالة/ث — بأمان تحت حد 80 رسالة/ث } return results; } module.exports = { sendWithThroughputRetry, handleFailedStatus, bulkSendThrottled };

تسخين الرقم: الطريقة الصحيحة للبناء نحو الطبقة 4

رقم WhatsApp Business جديد يبدأ في الطبقة 1 (1,000 جهة اتصال/يوم). القفز فوراً إلى حملات بث كبيرة هو أسرع طريقة لتراكم الحظر وتقارير البريد المزعج، مما يدمر تقييم جودتك قبل بناء أي إشارة ثقة. النهج الصحيح: سخّن تدريجياً على مدى 2–4 أسابيع.

استراتيجية التسخين التي تعظّم سرعة تقدم الطبقة بينما تحمي تقييم الجودة:

  • الأسبوع 1: أرسل إلى جهات الاتصال الأعلى تفاعلاً فقط — العملاء الذين ردوا عليك سابقاً، أو اشتروا مؤخراً، أو اشتركوا صراحة من خلال عملية بها احتكاك. استهدف 500–800 جهة اتصال/يوم (80% من الطبقة 1). راقب تقييم الجودة يومياً.
  • الأسبوع 2–3: إذا كانت الجودة GREEN، يجب أن تُرقَّى تلقائياً إلى الطبقة 2. زِد إلى 7,000–8,000 جهة اتصال/يوم (80% من الطبقة 2). استمر في الإرسال إلى الشرائح المتفاعلة فقط. اقمع جهات الاتصال غير المستجيبة التي لم تتفاعل في 90+ يوماً.
  • الأسبوع 4+: استمر في النمط. كل طبقة تتطلب 7 أيام من استخدام 80%+ مع تقييم GREEN/YELLOW. إجمالي الوقت من الطبقة 1 إلى الطبقة 4: حد أدنى 3–4 أسابيع من حجم متسق وعالي الجودة.
  • راقب دائماً معدلات فشل 131049. إذا رأيت فشل 131049 (حد التكرار) يتجاوز 20–25% من إرسالاتك، فأنت تستهدف الكثير من المستخدمين عاليي التشبع. حسّن جودة قائمتك أو قلل التكرار قبل التوسع أكثر.
استثناء الوارد: الرسائل الواردة (العملاء الذين يتواصلون معك أولاً) وردود الجلسة لا تُحسب ضمن طبقتك اليومية. إذا كانت عملية خدمة العملاء لديك واردة بشكل أساسي — العملاء يتواصلون، فريقك يرد ضمن نافذة 24 ساعة — يمكنك التعامل مع آلاف المحادثات يومياً في الطبقة 1 دون أي قلق من حد المعدل على الإطلاق. تنطبق حدود المعدل فقط على الرسائل الصادرة التي بدأها النشاط التجاري. استقبل عدد الرسائل الواردة الذي تريد في SocialHook مقابل 50 دولاراً شهرياً ثابتة — لا حد معدل على جانب الاستقبال.

أسئلة شائعة

ما هي الأنواع الثلاثة لحدود معدل WhatsApp API؟
(1) الإنتاجية لكل ثانية: 80 رسالة/ثانية لكل رقم هاتف — تعيد HTTP 429 فوراً. أعد المحاولة بتراجع أسي. (2) طبقة المراسلة اليومية: تحدد جهات الاتصال الفريدة التي بدأها النشاط التجاري لكل 24 ساعة (1K/10K/100K/غير محدود) — تعيد خطأ 131048 بشكل غير متزامن عبر webhook. لا تعد المحاولة حتى منتصف الليل UTC. (3) حد التكرار لكل مستلم: تحظر Meta بصمت رسائل التسويق للمستخدمين الذين تلقوا الكثير من جميع الأنشطة التجارية في 24–48 ساعة — تعيد خطأ 131049. لا تعد المحاولة أبداً.
ماذا يعني خطأ 131048 وهل يجب علي إعادة المحاولة؟
خطأ 131048 يعني "Message failed to send because too many messages were sent from the sender phone number" — تجاوزت حد طبقة المراسلة اليومية. لا تعد المحاولة في نفس اليوم. تُعاد ضبط نافذة الطبقة عند منتصف الليل UTC. جدول إعادة المحاولة لـ 00:05 UTC اليوم التالي. إعادة المحاولة الفورية تهدر حصتك المتبقية ولا تتجاوز الحد.
ماذا يعني خطأ 131049 ولماذا معدل فشلي مرتفع؟
خطأ 131049 ("Unhealthy system activity") هو حد التكرار لكل مستلم من Meta. المستلم المحدد تلقى الكثير من رسائل التسويق من جميع الأنشطة التجارية في آخر 24–48 ساعة. معدل فشل 131049 بنسبة 10–40% على حملات التسويق لمستخدمي WhatsApp النشطين طبيعي تماماً — ليس مشكلة في حسابك. يؤثر هذا فقط على قوالب فئة التسويق. قوالب utility والمصادقة ليست محدودة بالتكرار لكل مستلم. لا تعد محاولة فشل 131049 أبداً.
كيف أرقي طبقة مراسلة WhatsApp الخاصة بي؟
ترقية الطبقة تلقائية — لا يمكنك طلبها. يجب: (1) الوصول باستمرار إلى 80%+ من الحد اليومي لطبقتك الحالية لـ 7 أيام متتالية، و(2) الحفاظ على تقييم جودة GREEN أو YELLOW طوال تلك الفترة. إذا كانت جودتك GREEN بعد 7 أيام بسعة 80%+، تُرقّيك Meta تلقائياً. YELLOW يوقف الترقية. RED يخفضك فوراً طبقة واحدة. ابنِ الطبقة بالتركيز على الجماهير المتفاعلة أولاً لحماية تقييم الجودة.
هل تُحسب رسائل الجلسة (الردود على المحادثات التي بدأها العميل) ضمن الطبقة اليومية؟
لا. طبقة المراسلة اليومية تحسب فقط الرسائل التي بدأها النشاط التجاري — رسائل القوالب المُرسلة لبدء محادثات جديدة أو لعملاء خارج نافذة الخدمة لـ 24 ساعة. عندما يراسلك عميل أولاً وترد ضمن نافذة 24 ساعة الناتجة، تلك رسائل جلسة. لا تُحسب ضمن حد طبقتك وليس لها حد يومي في أي مستوى طبقة.
ماذا يحدث لتقييم جودتي عندما أحصل على حظر وتقارير بريد مزعج؟
الحظر وتقارير البريد المزعج تقلل مباشرة تقييم جودتك على نافذة متجددة لمدة 7 أيام. تقييم YELLOW يوقف أهلية ترقية الطبقة. تقييم RED يخفضك فوراً طبقة واحدة (مثلاً، الطبقة 2 ← الطبقة 1) ويحظر الترقيات الأخرى حتى تعود إلى GREEN. RED مستدام لـ 7+ أيام يمكن أن يؤدي إلى وسم رقم الهاتف أو تعطيله مؤقتاً. احمِ تقييمك بالإرسال فقط إلى جهات اتصال اشتركت وتتوقع رسائلك، اقمع غير المتفاعلين، وصنّف الرسائل كـ utility/مصادقة بدلاً من التسويق حيث يكون مشروعاً.

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

كل رسالة واردة — بغض النظر عن الحجم — تُسلَّم إلى نقطة webhook الخاصة بك كـ JSON نظيف. لا حد لكل ثانية، لا طبقة يومية، لا حد تكرار على الاستقبال. اربط رقم WhatsApp الخاص بك بـ SocialHook وتعامل مع أي عدد من المحادثات الواردة التي يولدها عملاؤك.

لا حاجة لبطاقة ائتمان · 50 دولاراً شهرياً بعد التجربة · حجم وارد غير محدود