الأخطاء

شكل واحد لكل أخطاء v2، بكود ثابت وحالة HTTP ومعناه وتعمل إيه — ومعاه قائمة الأخطاء كاملة.

كل الأخطاء ليها نفس الشكل. اعتمد على error.code (ثابت)، مش على الرسالة (ممكن صياغتها تتغير).

422 Unprocessable Entity

{
  "error": {
    "code": "SAFETY_SUPPRESSED",
    "message": "The recipient opted out of messages from this number.",
    "details": {
      "to": "2010****4567"
    },
    "docsUrl": "https://mursilat.com/developers/v2/errors#SAFETY_SUPPRESSED",
    "requestId": "req_6604bedc8c489f20e582691a"
  }
}

الحقل	المعنى
`code`	المعنىكود ثابت للبرامج. كل الأكواد تحت وكل واحد ليه رابط.
`message`	المعنىشرح بالإنجليزي للبني آدمين (ممكن يتغير).
`details`	المعنىبيانات إضافية اختيارية: الحقل الغلط، `retryAt`، الحدود…
`docsUrl`	المعنىرابط على الكود في القائمة دي على طول.
`requestId`	المعنىموجود كمان في هيدر `X-Request-Id`. اديه للدعم.

ردود 5xx عمرها ما بتكشف تفاصيل داخلية (INTERNAL_ERROR). الأكواد المكتوب عليها ممكن تتكرر ممكن تنجح بعدين من غير تغيير — احترم Retry-After / details.retryAt؛ الباقي محتاج تغيير من ناحيتك.

قائمة الأخطاء

فلترة الأخطاء

174 كود

Code	الحالة	المعنى	تعمل إيه
`ACCOUNT_KEY_REQUIRED`المصادقة	الحالة401صلّح الطلب	المعنىالـ endpoint ده محتاج مفتاح حساب مش مفتاح رقم.	تعمل إيهاستخدم مفتاح الحساب wsl_live_ (مفتاح الرقم بيبعت رسايل من رقمه بس).
`API_KEY_EXPIRED`المصادقة	الحالة401صلّح الطلب	المعنىصلاحية المفتاح خلصت.	تعمل إيهاعمل مفتاح جديد (أو غيّره قبل ما يخلص).
`API_KEY_INVALID`المصادقة	الحالة401صلّح الطلب	المعنىمفتاح الـ API غلط.	تعمل إيهانسخ المفتاح تاني من الإعدادات ← مفاتيح API (بيظهر مرة واحدة؛ اعمل مفتاح جديد لو ضاع).
`API_KEY_REQUIRED`المصادقة	الحالة401صلّح الطلب	المعنىمفيش مفتاح API في الطلب.	تعمل إيهابعت الهيدر Authorization: Bearer wsl_live_…
`API_KEY_REVOKED`المصادقة	الحالة401صلّح الطلب	المعنىالمفتاح اتلغى.	تعمل إيهاستخدم مفتاح تاني أو اعمل واحد جديد.
`IMPERSONATION_ACTION_FORBIDDEN`المصادقة	الحالة403صلّح الطلب	المعنىمش مسموح أثناء جلسة دعم.	تعمل إيهصاحب الحساب لازم يعملها بنفسه.
`IP_NOT_ALLOWED`المصادقة	الحالة403صلّح الطلب	المعنىالمفتاح مسموح من عناوين IP تانية بس.	تعمل إيهنادِ من IP مسموح أو عدّل قائمة الـ IP للمفتاح.
`KEY_NUMBER_RESTRICTED`المصادقة	الحالة403صلّح الطلب	المعنىالمفاتيح المقصورة على أرقام مينفعش تعمل حاجة على مستوى الحساب كله.	تعمل إيهاستخدم مفتاح على كل الأرقام.
`NUMBER_NOT_ALLOWED`المصادقة	الحالة403صلّح الطلب	المعنىالمفتاح مقصور على أرقام تانية.	تعمل إيهاستخدم مفتاح فيه الرقم ده.
`SCOPE_REQUIRED`المصادقة	الحالة403صلّح الطلب	المعنىالمفتاح مش معاه الصلاحية دي.	تعمل إيهضيف الصلاحية المكتوبة في details.required للمفتاح.
`USER_SUSPENDED`المصادقة	الحالة403صلّح الطلب	المعنىالحساب موقوف.	تعمل إيهكلّم الدعم.
`API_KEY_NOT_FOUND`المصادقة	الحالة404صلّح الطلب	المعنىالمفتاح مش موجود.	تعمل إيهراجع الـ id.
`API_KEY_LIMIT_REACHED`المصادقة	الحالة409صلّح الطلب	المعنىعندك مفاتيح كتير (20).	تعمل إيهالغِ مفتاح مش مستخدم.
`API_TEMPORARY_BAN`المصادقة	الحالة429ممكن تتكرر	المعنىالإرسال عن طريق الـ API متوقف مؤقتًا للرقم ده بسبب ضغط عالي.	تعمل إيهخفّف السرعة وجرّب بعد retryAfterSeconds.
`AUTH_TOO_MANY_FAILURES`المصادقة	الحالة429ممكن تتكرر	المعنىمحاولات دخول فاشلة كتير من الـ IP بتاعك.	تعمل إيهصلّح المفتاح واستنى الثواني اللي في Retry-After.
`RATE_LIMITED`المصادقة	الحالة429ممكن تتكرر	المعنىوصلت لحد الطلبات للمفتاح.	تعمل إيهاستنى Retry-After وراقب X-RateLimit-Remaining.
`API_KEY_EXPIRY_INVALID`الطلب	الحالة400صلّح الطلب	المعنىexpiresInDays لازم من 1 لـ 730.	تعمل إيهصلّح القيمة.
`API_KEY_GRACE_INVALID`الطلب	الحالة400صلّح الطلب	المعنىgraceMinutes لازم من 0 لـ 1440.	تعمل إيهصلّح القيمة.
`API_KEY_IP_ALLOWLIST_INVALID`الطلب	الحالة400صلّح الطلب	المعنىIP أو نطاق غلط في القائمة.	تعمل إيهاستخدم عناوين IPv4/IPv6 أو نطاقات CIDR.
`API_KEY_NAME_INVALID`الطلب	الحالة400صلّح الطلب	المعنىاسم المفتاح مطلوب (1–80 حرف).	تعمل إيهابعت اسم.
`API_KEY_NUMBERS_INVALID`الطلب	الحالة400صلّح الطلب	المعنىnumbers لازم تكون "ALL" أو أرقامك.	تعمل إيهاختار ALL أو أرقام صحيحة.
`API_KEY_SCOPES_INVALID`الطلب	الحالة400صلّح الطلب	المعنىصلاحيات غلط أو ناقصة.	تعمل إيهاختار صلاحيات من القائمة.
`CONFIRMATION_REQUIRED`الطلب	الحالة400صلّح الطلب	المعنىالعملية دي محتاجة تأكيد صريح.	تعمل إيهضيف باراميتر confirm المكتوب في الدوكيومنتيشن.
`IDEMPOTENCY_KEY_INVALID`الطلب	الحالة400صلّح الطلب	المعنىIdempotency-Key لازم 1–191 حرف ASCII.	تعمل إيهاستخدم مثلًا order-1042-confirm.
`IDEMPOTENCY_KEY_REQUIRED`الطلب	الحالة400صلّح الطلب	المعنىالهيدر Idempotency-Key مطلوب.	تعمل إيهابعت قيمة مختلفة لكل عملية.
`PAGINATION_CURSOR_INVALID`الطلب	الحالة400صلّح الطلب	المعنىcursor غلط.	تعمل إيهابعت nextCursor زي ما هو.
`PAGINATION_LIMIT_INVALID`الطلب	الحالة400صلّح الطلب	المعنىlimit خارج الحدود.	تعمل إيهاستخدم من 1 لـ 100.
`VALIDATION_FAILED`الطلب	الحالة400صلّح الطلب	المعنىالطلب فيه بيانات غلط.	تعمل إيهشوف details.errors أو details.field.
`ROUTE_NOT_FOUND`الطلب	الحالة404صلّح الطلب	المعنىالـ endpoint ده مش موجود.	تعمل إيهراجع الـ method والمسار (/api/v2/…).
`IDEMPOTENCY_IN_PROGRESS`الطلب	الحالة409ممكن تتكرر	المعنىالطلب الأول بنفس المفتاح لسه شغال.	تعمل إيهجرّب بعد ثواني.
`IDEMPOTENCY_KEY_REUSED`الطلب	الحالة409صلّح الطلب	المعنىالـ Idempotency-Key ده اتستخدم مع طلب مختلف.	تعمل إيهاستخدم مفتاح جديد للطلب الجديد.
`UNSUPPORTED_CONTENT_TYPE`الطلب	الحالة415صلّح الطلب	المعنىالـ body لازم JSON (أو multipart للملفات).	تعمل إيهحط Content-Type: application/json.
`API_ACCESS_NOT_IN_PLAN`الباقة	الحالة403صلّح الطلب	المعنىباقتك مش فيها الـ API.	تعمل إيهرقّي لباقة فيها API.
`AUTO_REPLIES_NOT_IN_PLAN`الباقة	الحالة403صلّح الطلب	المعنىباقتك مش فيها الردود التلقائية.	تعمل إيهرقّي الباقة.
`FEATURE_NOT_IN_PLAN`الباقة	الحالة403صلّح الطلب	المعنىباقتك مش فيها الميزة دي.	تعمل إيهرقّي الباقة (details.feature).
`GROUPS_NOT_IN_PLAN`الباقة	الحالة403صلّح الطلب	المعنىباقتك مش فيها الجروبات.	تعمل إيهرقّي الباقة.
`MESSAGES_QUOTA_EXCEEDED`الباقة	الحالة403صلّح الطلب	المعنىرصيد الرسايل في باقتك خلص.	تعمل إيهاشتري باقة رسايل أو رقّي.
`NO_ACTIVE_PLAN`الباقة	الحالة403صلّح الطلب	المعنىمفيش باقة فعّالة.	تعمل إيهاشترك.
`PLAN_NUMBERS_LIMIT_REACHED`الباقة	الحالة403صلّح الطلب	المعنىوصلت لعدد الأرقام في باقتك.	تعمل إيهرقّي الباقة أو امسح رقم.
`WEBHOOKS_NOT_IN_PLAN`الباقة	الحالة403صلّح الطلب	المعنىباقتك مش فيها الويب هوك.	تعمل إيهرقّي الباقة.
`NUMBER_ID_REQUIRED`الأرقام	الحالة400صلّح الطلب	المعنىnumberId مطلوب مع مفتاح الحساب.	تعمل إيهابعت numberId.
`SESSION_NOT_CONNECTED`الأرقام	الحالة400ممكن تتكرر	المعنىالرقم مش متصل.	تعمل إيهاربطه تاني (امسح الـ QR) وجرّب.
`NUMBER_NOT_FOUND`الأرقام	الحالة404صلّح الطلب	المعنىالرقم مش موجود في الحساب.	تعمل إيهراجع numberId من GET /v2/numbers.
`NUMBER_ALREADY_CONNECTED`الأرقام	الحالة409صلّح الطلب	المعنىالرقم متصل بالفعل.	تعمل إيهمفيش داعي للربط.
`NUMBER_BANNED`الأرقام	الحالة409صلّح الطلب	المعنىواتساب قيّد الرقم ده.	تعمل إيهكلّم الدعم؛ متحاولش تعيد الربط كتير.
`NUMBER_NOT_CONNECTED`الأرقام	الحالة409ممكن تتكرر	المعنىالرقم مش متصل.	تعمل إيهاربطه الأول.
`NUMBER_NOT_PAIRING`الأرقام	الحالة409صلّح الطلب	المعنىالرقم مش في وضع الربط.	تعمل إيهنادِ POST /reconnect الأول.
`PAIRING_CODE_UNAVAILABLE`الأرقام	الحالة409صلّح الطلب	المعنىكود الربط مش متاح؛ استخدم الـ QR.	تعمل إيههات GET /qr.
`SESSION_OWNED_BY_OTHER_INSTANCE`الأرقام	الحالة409ممكن تتكرر	المعنىالرقم شغال على سيرفر تاني.	تعمل إيهجرّب بعد دقيقة.
`CONTACT_CHECK_TOO_MANY`الأرقام	الحالة422صلّح الطلب	المعنىلحد 50 رقم في المرة.	تعمل إيهقسّم القائمة؛ للقوائم الكبيرة اعمل حملة (بتتشيك بأمان).
`PAIRING_CODE_FAILED`الأرقام	الحالة502ممكن تتكرر	المعنىواتساب مرجعش كود ربط.	تعمل إيهجرّب تاني أو استخدم الـ QR.
`INTERACTIVE_INVALID`الرسايل	الحالة400صلّح الطلب	المعنىأزرار/قائمة/زرار رابط غلط (أكواد INTERACTIVE_*).	تعمل إيهشوف details.field وحدود الرسايل التفاعلية.
`INTERACTIVE_RESERVED_TITLE`الرسايل	الحالة400صلّح الطلب	المعنىعنوان اختيار هو كلمة إلغاء اشتراك.	تعمل إيهغيّر الاسم (مثلًا "إلغاء الطلب").
`INVALID_RECIPIENT`الرسايل	الحالة400صلّح الطلب	المعنىرقم غلط.	تعمل إيهأرقام بكود الدولة، مثلًا 201001234567.
`MESSAGE_CONTACT_INVALID`الرسايل	الحالة400صلّح الطلب	المعنىكارت جهة اتصال غلط.	تعمل إيهشوف details.reason و index.
`MESSAGE_EVENT_INVALID`الرسايل	الحالة400صلّح الطلب	المعنىتواريخ الحدث غلط.	تعمل إيهشوف details.reason.
`MESSAGE_FIELD_INVALID`الرسايل	الحالة400صلّح الطلب	المعنىحقل شكله غلط.	تعمل إيهشوف details.field و details.reason.
`MESSAGE_FIELD_REQUIRED`الرسايل	الحالة400صلّح الطلب	المعنىحقل مطلوب ناقص.	تعمل إيهشوف details.field.
`MESSAGE_LOCATION_INVALID`الرسايل	الحالة400صلّح الطلب	المعنىخط العرض/الطول غلط.	تعمل إيهالعرض −90..90 والطول −180..180.
`MESSAGE_MEDIA_REQUIRED`الرسايل	الحالة400صلّح الطلب	المعنىلازم ملف أو ميديا.	تعمل إيهابعت media.url أو media.id أو ملف.
`MESSAGE_MENTIONS_GROUP_ONLY`الرسايل	الحالة400صلّح الطلب	المعنىالمنشن في الجروبات بس.	تعمل إيهشيل المنشن.
`MESSAGE_POLL_INVALID`الرسايل	الحالة400صلّح الطلب	المعنىاستطلاع غلط.	تعمل إيهشوف details.reason.
`MESSAGE_REACTION_INVALID`الرسايل	الحالة400صلّح الطلب	المعنىلازم إيموجي واحد (أو "").	تعمل إيهابعت إيموجي واحد.
`MESSAGE_TEXT_TOO_LONG`الرسايل	الحالة400صلّح الطلب	المعنىالنص أطول من المسموح.	تعمل إيهشوف details.limit.
`MESSAGE_TYPE_NOT_SUPPORTED`الرسايل	الحالة400صلّح الطلب	المعنىالنوع ده مينفعش يتبعت من جهاز مربوط.	تعمل إيهdetails.reason بيشرح؛ استخدم البديل المقترح.
`MESSAGE_TYPE_REQUIRED`الرسايل	الحالة400صلّح الطلب	المعنىtype مطلوب.	تعمل إيهشوف أنواع الرسايل.
`MESSAGE_UNEXPECTED_FIELD`الرسايل	الحالة400صلّح الطلب	المعنىحقل بتاع نوع رسالة تاني.	تعمل إيهشيل details.field.
`MESSAGE_VIDEO_NOTE_TOO_LONG`الرسايل	الحالة400صلّح الطلب	المعنىرسالة الفيديو الدائرية لحد 60 ثانية.	تعمل إيهقصّ الفيديو.
`SCHEDULE_AT_INVALID`الرسايل	الحالة400صلّح الطلب	المعنىscheduleAt لازم من دقيقة لـ 30 يوم قدام.	تعمل إيهابعت وقت ISO زي 2026-11-01T09:00:00+02:00.
`MESSAGE_MEDIA_NOT_FOUND`الرسايل	الحالة404صلّح الطلب	المعنىmedia id مش معروف (أو بتاع رقم تاني).	تعمل إيهارفعه تاني على نفس الرقم.
`MESSAGE_NOT_FOUND`الرسايل	الحالة404صلّح الطلب	المعنىالرسالة مش موجودة.	تعمل إيهاستخدم الـ id اللي رجع من POST /v2/messages (بيتحفظ 30 يوم).
`MESSAGE_REPLY_TARGET_NOT_FOUND`الرسايل	الحالة404صلّح الطلب	المعنىreplyTo مش رسالة في الشات ده.	تعمل إيهاستخدم id رسالة من نفس الشات.
`MESSAGE_DELETE_WINDOW_PASSED`الرسايل	الحالة409صلّح الطلب	المعنىالمسح عند الكل خلال 48 ساعة بس.	تعمل إيهامسحها عندك بس.
`MESSAGE_EDIT_WINDOW_PASSED`الرسايل	الحالة409صلّح الطلب	المعنىالتعديل خلال 15 دقيقة بس.	تعمل إيهابعت رسالة جديدة.
`MESSAGE_NOT_CANCELLABLE`الرسايل	الحالة409صلّح الطلب	المعنىالرسالة المجدولة بتتبعت دلوقتي.	تعمل إيهامسحها بعد ما تتبعت.
`MESSAGE_NOT_DELETABLE`الرسايل	الحالة409صلّح الطلب	المعنىالرسالة دي مينفعش تتمسح عند الكل.	تعمل إيهامسحها عندك بس (forEveryone=false).
`MESSAGE_NOT_EDITABLE`الرسايل	الحالة409صلّح الطلب	المعنىالرسالة دي مينفعش تتعدل.	تعمل إيهرسايلك النصية المبعوتة بس.
`MESSAGE_NOT_SENT_YET`الرسايل	الحالة409صلّح الطلب	المعنىالرسالة مجدولة ولسه متبعتتش.	تعمل إيهالغيها بـ DELETE.
`SCHEDULE_LIMIT_REACHED`الرسايل	الحالة409صلّح الطلب	المعنىرسايل مجدولة كتير مستنية (1000 للحساب).	تعمل إيهالغي شوية أو ابعت دلوقتي.
`MESSAGE_MEDIA_EXPIRED`الرسايل	الحالة410صلّح الطلب	المعنىالملف المرفوع انتهى (24 ساعة).	تعمل إيهارفعه تاني.
`MESSAGE_MEDIA_TOO_LARGE`الرسايل	الحالة413صلّح الطلب	المعنىالملف أكبر من المسموح.	تعمل إيهشوف details.limitBytes.
`MESSAGE_MEDIA_TYPE_NOT_ALLOWED`الرسايل	الحالة415صلّح الطلب	المعنىمحتوى الملف مش مطابق للنوع.	تعمل إيهابعت الملف أو النوع الصح.
`MESSAGE_MEDIA_FETCH_FAILED`الرسايل	الحالة422ممكن تتكرر	المعنىمعرفناش نجيب media.url بأمان.	تعمل إيهاستخدم رابط https عام بيرد في 20 ثانية.
`MESSAGE_STICKER_INVALID`الرسايل	الحالة422صلّح الطلب	المعنىالصورة مينفعش تبقى ستيكر.	تعمل إيهاستخدم PNG/WebP أصغر.
`SCHEDULE_MEDIA_URL_ONLY`الرسايل	الحالة422صلّح الطلب	المعنىالميديا المجدولة لازم media.url.	تعمل إيهاستخدم رابط https عام؛ الملفات المرفوعة بتتمسح بعد الإرسال.
`SCHEDULING_DISABLED`الرسايل	الحالة422صلّح الطلب	المعنىالرسائل المجدولة مش مفعّلة (متاحة عند الطلب).	تعمل إيهابعت دلوقتي من غير scheduleAt، أو اطلب تفعيل الجدولة من الدعم.
`LIMITS_INVALID`حماية الرقم	الحالة400صلّح الطلب	المعنىحدود غلط.	تعمل إيهأرقام صحيحة في الحدود؛ maxPerHour ≤ maxPerDay.
`STATS_RANGE_INVALID`حماية الرقم	الحالة400صلّح الطلب	المعنىفترة غلط.	تعمل إيهYYYY-MM-DD، لحد 92 يوم.
`ACCOUNT_NUMBER_ROTATION`حماية الرقم	الحالة403صلّح الطلب	المعنىاتربط رقم جديد بعد حظر على طول: الرسايل لأرقام جديدة مستنية مراجعة.	تعمل إيهكلّم الدعم؛ فريقنا هيراجع الحساب.
`ACCOUNT_RESTRICTED`حماية الرقم	الحالة403صلّح الطلب	المعنىالحساب مقيّد: مسموح بس الرد على اللي كلموك خلال ٢٤ ساعة.	تعمل إيهكلّم الدعم؛ فريقنا بيراجع ويرفع التقييد.
`SAFETY_NUMBER_BANNED`حماية الرقم	الحالة403صلّح الطلب	المعنىواتساب قيّد الرقم.	تعمل إيهكلّم الدعم.
`NUMBER_NOT_CONNECTED_YET`حماية الرقم	الحالة409صلّح الطلب	المعنىاربط الرقم مرة الأول.	تعمل إيهاربطه.
`NUMBER_PAUSE_NOT_YOURS`حماية الرقم	الحالة409ممكن تتكرر	المعنىالإيقاف ده لحماية الرقم ومينفعش يتشال من الـ API.	تعمل إيهبيخلص لوحده عند details.until.
`SESSION_PHONE_UNKNOWN`حماية الرقم	الحالة409ممكن تتكرر	المعنىرقم التليفون لسه مش معروف.	تعمل إيهاربط تاني وجرّب.
`SAFETY_CONTENT_BLOCKED`حماية الرقم	الحالة422صلّح الطلب	المعنىالمحتوى اتمنع لحماية الرقم (reasons[]).	تعمل إيهشيل روابط الاختصار / الروابط للأرقام الجديدة / نوّع النصوص؛ السبب CONTENT_PROHIBITED (+ category) = محتوى ممنوع لأرقام جديدة.
`SAFETY_SUPPRESSED`حماية الرقم	الحالة422صلّح الطلب	المعنىالمستلم لغى اشتراكه.	تعمل إيهمتبعتلوش.
`SAFETY_NUMBER_PAUSED`حماية الرقم	الحالة423ممكن تتكرر	المعنىالرقم متوقف (منك أو من حماية الرقم).	تعمل إيهجرّب عند retryAt؛ الردود على المحادثات الحديثة شغالة.
`ACCOUNT_COD_CAP_REACHED`حماية الرقم	الحالة429ممكن تتكرر	المعنىحد الحساب اليومي لرسايل تأكيد الطلبات خلص.	تعمل إيهجرّب عند retryAt (نص الليل)؛ الحد بيزيد مع مستوى الحساب.
`ACCOUNT_DAILY_CAP_REACHED`حماية الرقم	الحالة429ممكن تتكرر	المعنىحد الحساب اليومي للرسايل لأرقام جديدة (كل أرقامك مع بعض) خلص.	تعمل إيهجرّب عند retryAt (نص الليل)؛ الحد بيزيد مع مستوى الحساب.
`SAFETY_DAILY_CAP_REACHED`حماية الرقم	الحالة429ممكن تتكرر	المعنىحد الرقم اليومي خلص (التسخين أو حدك).	تعمل إيهجرّب عند retryAt (نص الليل).
`SAFETY_HOURLY_CAP_REACHED`حماية الرقم	الحالة429ممكن تتكرر	المعنىحد الساعة خلص.	تعمل إيهجرّب عند retryAt.
`SAFETY_NUMBER_BUSY`حماية الرقم	الحالة429ممكن تتكرر	المعنىفيه رسالة تانية بتتبعت من الرقم.	تعمل إيهجرّب كمان شوية.
`SAFETY_PACING`حماية الرقم	الحالة429ممكن تتكرر	المعنىالرسايل للأرقام الجديدة بتتبعت بفواصل.	تعمل إيهجرّب عند retryAt؛ أو سيب الحملات تنظم السرعة.
`SAFETY_QUIET_HOURS`حماية الرقم	الحالة429ممكن تتكرر	المعنىالحملات بتستنى في ساعات الهدوء.	تعمل إيهجرّب عند retryAt.
`CAMPAIGN_CONTENT_INVALID`الحملات	الحالة400صلّح الطلب	المعنىمحتوى الحملة غلط.	تعمل إيهشوف details.field.
`CAMPAIGN_NOT_CANCELLABLE`الحملات	الحالة400صلّح الطلب	المعنىالحملة دي مينفعش تتلغي.	تعمل إيههي خلصت بالفعل.
`CAMPAIGN_RECIPIENTS_REQUIRED`الحملات	الحالة400صلّح الطلب	المعنىحدد مستلمين أو contactListId أو audience (واحد بس).	تعمل إيهاختار مصدر واحد.
`URL_SHORTENER`الحملات	الحالة400صلّح الطلب	المعنىروابط الاختصار ممنوعة.	تعمل إيهاستخدم الرابط الكامل.
`AUP_NOT_ACCEPTED`الحملات	الحالة403صلّح الطلب	المعنىصاحب الحساب لسه ما وافقش على سياسة الاستخدام.	تعمل إيهادخل الداشبورد مرة ووافق على السياسة.
`CAMPAIGN_NOT_FOUND`الحملات	الحالة404صلّح الطلب	المعنىالحملة مش موجودة.	تعمل إيهراجع الـ id.
`CAMPAIGN_ACTIVE`الحملات	الحالة409صلّح الطلب	المعنىالحملة الشغالة مينفعش تتمسح.	تعمل إيهالغيها الأول.
`CAMPAIGN_NOT_DRAFT`الحملات	الحالة409صلّح الطلب	المعنىالمسودات بس اللي تتبدأ.	تعمل إيهراجع الحالة.
`CAMPAIGN_RESUME_BLOCKED`الحملات	الحالة409صلّح الطلب	المعنىالمنصة وقفت الحملة؛ مينفعش تكملها.	تعمل إيهشوف details.pauseReason؛ الإيقاف المؤقت بيرجع بعد pausedUntil.
`CAMPAIGN_STATE_CHANGED`الحملات	الحالة409ممكن تتكرر	المعنىالحملة اتغيرت في نفس الوقت.	تعمل إيهاقراها تاني وجرّب.
`CAMPAIGN_PURGED`الحملات	الحالة410صلّح الطلب	المعنىالمستلمين اتمسحوا بعد ما الحملة خلصت (خصوصية).	تعمل إيهالإجماليات بس اللي فاضلة؛ صدّر خلال فترة الحفظ المرة الجاية.
`CAMPAIGN_NO_RECIPIENTS`الحملات	الحالة422صلّح الطلب	المعنىمفيش مستلمين صالحين.	تعمل إيهراجع الأرقام.
`CAMPAIGN_OPT_IN_REQUIRED`الحملات	الحالة422صلّح الطلب	المعنىأكّد إن المستلمين موافقين يستلموا رسايلك.	تعمل إيهابعت optInConfirmed: true (للموافقين فعلًا بس).
`CAMPAIGN_TOO_MANY_RECIPIENTS`الحملات	الحالة422صلّح الطلب	المعنىلحد 10,000 مستلم في الطلب.	تعمل إيهاستخدم قائمة جهات اتصال.
`CONTENT_PROHIBITED`الحملات	الحالة422صلّح الطلب	المعنىالحملة فيها محتوى ممنوع (details.category)؛ الحساب بياخد إنذار.	تعمل إيهشيل الموضوع الممنوع (قروض، مراهنات، توصيات عملات، محتوى للكبار، دعاية سياسية، سلاح/مخدرات، روابط واتساب، انتحال صفة).
`LIST_QUALITY_LOW`الحملات	الحالة422صلّح الطلب	المعنىقائمة الأرقام شكلها ضعيف (details.reason).	تعمل إيهابعت بس للي وافقوا؛ شيل الأرقام الغلط أو المتولّدة.
`AUTO_REPLY_DELAY_INVALID`الردود التلقائية	الحالة400صلّح الطلب	المعنىdelaySeconds لازم 0 ≤ min ≤ max ≤ 120.	تعمل إيهصلّح القيم.
`AUTO_REPLY_KEYWORDS_REQUIRED`الردود التلقائية	الحالة400صلّح الطلب	المعنىقاعدة الكلمات محتاجة كلمات.	تعمل إيهضيف trigger.keywords.
`AUTO_REPLY_PATTERNS_REQUIRED`الردود التلقائية	الحالة400صلّح الطلب	المعنىقاعدة التعبير النمطي محتاجة نمط واحد على الأقل.	تعمل إيهضيف trigger.patterns (من 1 لـ 10 أنماط).
`AUTO_REPLY_REGEX_INVALID`الردود التلقائية	الحالة400صلّح الطلب	المعنىفيه نمط مش تعبير RE2 صحيح، أو بيستخدم حاجة RE2 مش بيدعمها (النظر للأمام/للخلف، الإشارة لمجموعة سابقة، المجموعات الذرّية)، أو عدّى الحدود (200 حرف، {n} ≤ 100، التعقيد)، أو بيطابق رسالة فاضية.	تعمل إيهالتفاصيل فيها patternIndex و reason و position (من 1) و messages {en, ar}. صلّح النمط ده وجرّبه بـ POST /auto-replies/test.
`AUTO_REPLY_REGEX_RULE_LIMIT`الردود التلقائية	الحالة400صلّح الطلب	المعنىالحساب أقصاه 50 قاعدة تعبير نمطي.	تعمل إيهاحذف أو ادمج قواعد REGEX (details.limit و details.used).
`AUTO_REPLY_REGEX_TOO_MANY_PATTERNS`الردود التلقائية	الحالة400صلّح الطلب	المعنىالقاعدة أقصاها 10 أنماط.	تعمل إيهاجمع البدائل بـ \| أو قسّم القاعدة.
`AUTO_REPLY_SCHEDULE_REQUIRED`الردود التلقائية	الحالة400صلّح الطلب	المعنىرد الغياب محتاج مواعيد العمل.	تعمل إيهضيف schedule.
`INVALID_SCHEDULE`الردود التلقائية	الحالة400صلّح الطلب	المعنىمواعيد أو منطقة زمنية غلط.	تعمل إيهاستخدم HH:mm ومنطقة زمنية صحيحة.
`AUTO_REPLY_ACCOUNT_WIDE_READ_ONLY`الردود التلقائية	الحالة403صلّح الطلب	المعنىالقواعد اللي على كل الأرقام للقراءة بس للمفاتيح المقصورة على أرقام.	تعمل إيهاستخدم مفتاح على كل الأرقام.
`AUTO_REPLY_NOT_FOUND`الردود التلقائية	الحالة404صلّح الطلب	المعنىالقاعدة مش موجودة على الرقم ده.	تعمل إيهراجع الـ ids.
`AUTO_REPLY_REGEX_ENGINE_UNAVAILABLE`الردود التلقائية	الحالة503ممكن تتكرر	المعنىالتعبيرات النمطية مش متاحة دلوقتي.	تعمل إيهجرّب تاني بعدين؛ قواعد الكلمات العادية شغّالة.
`OTP_INPUT_INVALID`OTP	الحالة400صلّح الطلب	المعنىطلب OTP غلط.	تعمل إيهشوف details.field.
`OTP_NOT_FOUND`OTP	الحالة404صلّح الطلب	المعنىالـ OTP مش موجود.	تعمل إيهاستخدم otpId من POST /v2/otp (بيتحفظ 7 أيام).
`OTP_ACCOUNT_RATE_LIMITED`OTP	الحالة429ممكن تتكرر	المعنىأرقام كتير مختلفة اتبعتلها أكواد من حسابك الساعة دي.	تعمل إيهاستنى؛ الأكواد للناس اللي طلبوها حالًا بس.
`OTP_RECIPIENT_RATE_LIMITED`OTP	الحالة429ممكن تتكرر	المعنىأكواد كتير للرقم ده (5 في الساعة).	تعمل إيهخلّي المستخدم يستنى؛ متكررش الإرسال.
`OTP_VERIFY_RATE_LIMITED`OTP	الحالة429ممكن تتكرر	المعنىمحاولات تحقق كتير من المفتاح.	تعمل إيهخفّف.
`GROUP_ID_INVALID`الجروبات	الحالة400صلّح الطلب	المعنىid الجروب غلط.	تعمل إيهاستخدم 1203…@g.us.
`GROUP_NOT_FOUND`الجروبات	الحالة404صلّح الطلب	المعنىالرقم مش في الجروب ده.	تعمل إيهاعرض الجروبات الأول.
`GROUPS_UNAVAILABLE`الجروبات	الحالة502ممكن تتكرر	المعنىواتساب مرجعش الجروبات.	تعمل إيهجرّب كمان شوية.
`URL_PORT_NOT_ALLOWED`الويب هوك	الحالة400صلّح الطلب	المعنىالبورتات 443 و 80 بس.	تعمل إيهاستخدم بورت https العادي.
`URL_PRIVATE_ADDRESS`الويب هوك	الحالة400صلّح الطلب	المعنىالرابط بيشاور على عنوان داخلي.	تعمل إيهاستخدم رابط https عام.
`WEBHOOK_EVENTS_INVALID`الويب هوك	الحالة400صلّح الطلب	المعنىنوع حدث غلط.	تعمل إيهشوف GET /v2/webhooks/events.
`WEBHOOK_URL_NOT_SET`الويب هوك	الحالة400صلّح الطلب	المعنىمفيش رابط ويب هوك.	تعمل إيهاعمل PUT للويب هوك الأول.
`WEBHOOK_VERSION_INVALID`الويب هوك	الحالة400صلّح الطلب	المعنىversion لازم 2.	تعمل إيهاستخدم 2.
`WEBHOOK_DELIVERY_NOT_FOUND`الويب هوك	الحالة404صلّح الطلب	المعنىالتسليم مش موجود.	تعمل إيهبيتحفظ 7 أيام.
`NO_NUMBER`الويب هوك	الحالة409صلّح الطلب	المعنىضيف رقم الأول.	تعمل إيهالأحداث دايمًا مرتبطة برقم.
`WEBHOOK_DISABLED`الويب هوك	الحالة409صلّح الطلب	المعنىالويب هوك متوقف (رد بـ 410).	تعمل إيهاحفظ الرابط تاني.
`DELIVERY_PAYLOAD_EXPIRED`الويب هوك	الحالة410صلّح الطلب	المعنىإعادة الإرسال ممكنة في فترة المحاولات بس (حوالي ساعة).	تعمل إيهابني الحالة من عندك (مثلًا GET /v2/messages/{id}).
`LINK_FIELD_INVALID`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىفيه حقل مش صحيح في الرابط (details.field و details.reason).	تعمل إيهصلّح الحقل (الرسالة ≤ 1000، قيم utm ≤ 150).
`LINK_NUMBER_INVALID`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىالرقم مش من أرقامك.	تعمل إيهاستخدم id من GET /v2/numbers.
`LINK_NUMBER_NO_PHONE`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىالرقم ده عمره ما اتربط، فرقمه مش معروف.	تعمل إيهاربط الرقم الأول.
`LINK_SLUG_INVALID`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىاسم الرابط: من 3 لـ 40 حرف إنجليزي صغير أو أرقام أو شرطة.	تعمل إيهسيبه فاضي ونعملك واحد عشوائي.
`LINK_SLUG_RESERVED`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىالاسم ده محجوز.	تعمل إيهاختار اسم تاني.
`WIDGET_DOMAIN_INVALID`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىفيه دومين مش صحيح.	تعمل إيهاستخدم أسماء زي example.com أو *.example.com (من غير مسارات).
`WIDGET_DOMAINS_REQUIRED`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىلازم دومين واحد على الأقل للموقع.	تعمل إيهابعت allowedDomains، مثلاً ["example.com"].
`WIDGET_DOMAINS_TOO_MANY`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىدومينات كتير (أقصى حد 20).	تعمل إيهاستخدم *.example.com بدل كل واحد لوحده.
`WIDGET_NAME_INVALID`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىالاسم مطلوب (من 1 لـ 80 حرف).	تعمل إيهابعت اسم قصير.
`WIDGET_NUMBER_INVALID`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىالرقم (أو رقم أحد الموظفين) مش من أرقامك.	تعمل إيهاستخدم id من GET /v2/numbers.
`WIDGET_NUMBER_NO_PHONE`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىالرقم ده عمره ما اتربط، فرقمه مش معروف.	تعمل إيهاربط الرقم الأول.
`WIDGET_SETTINGS_INVALID`زرار الموقع والروابط	الحالة400صلّح الطلب	المعنىفيه إعداد مش صحيح (details.field و details.reason).	تعمل إيهصلّح الحقل اللي اسمه في الرد.
`LINK_CUSTOM_SLUG_PLAN`زرار الموقع والروابط	الحالة403صلّح الطلب	المعنىاسم الرابط المخصص محتاج باقة مدفوعة.	تعمل إيهسيب الاسم فاضي (هيتعمل اسم عشوائي) أو رقّي باقتك.
`LINK_LIMIT_REACHED`زرار الموقع والروابط	الحالة403صلّح الطلب	المعنىباقتك مش بتسمح بروابط واتساب أكتر.	تعمل إيهامسح رابط أو رقّي باقتك (النمو: 50، الأعمال: بلا حدود).
`WIDGET_BRANDING_LOCKED`زرار الموقع والروابط	الحالة403صلّح الطلب	المعنىإخفاء «مدعوم من مرسلات» محتاج باقة النمو أو أعلى.	تعمل إيهرقّي باقتك أو خلّي branding.show = true.
`WIDGET_LIMIT_REACHED`زرار الموقع والروابط	الحالة403صلّح الطلب	المعنىباقتك مش بتسمح بزراير موقع أكتر.	تعمل إيهامسح واحد أو رقّي باقتك (النمو: 5، الأعمال: بلا حدود).
`WIDGET_ORIGIN_NOT_ALLOWED`زرار الموقع والروابط	الحالة403صلّح الطلب	المعنىضغطة من موقع مش في الدومينات المسموحة.	تعمل إيهضيف الدومين لـ allowedDomains.
`LINK_NOT_FOUND`زرار الموقع والروابط	الحالة404صلّح الطلب	المعنىالرابط مش موجود.	تعمل إيهاتأكد من linkId (من GET /v2/links).
`WIDGET_NOT_FOUND`زرار الموقع والروابط	الحالة404صلّح الطلب	المعنىزرار الموقع مش موجود.	تعمل إيهاتأكد من widgetId (من GET /v2/widgets).
`LINK_SLUG_TAKEN`زرار الموقع والروابط	الحالة409صلّح الطلب	المعنىالاسم ده مستخدم.	تعمل إيهاختار اسم تاني.
`WIDGET_CLICK_RATE_LIMITED`زرار الموقع والروابط	الحالة429ممكن تتكرر	المعنىقديم: مبقاش بيرجع. فوق الحد الضغطة بترد 200 من غير كود (والزائر بيوصل لواتساب عادي).	تعمل إيهمفيش حاجة تعملها.
`WIDGET_RATE_LIMITED`زرار الموقع والروابط	الحالة429ممكن تتكرر	المعنىطلبات كتير لزرار الموقع من نفس الشبكة.	تعمل إيهجرّب تاني بعد Retry-After ثانية.
`INTERNAL_ERROR`السيرفر	الحالة500ممكن تتكرر	المعنىخطأ غير متوقع.	تعمل إيهجرّب تاني؛ كلّم الدعم ومعاك requestId.
`API_V2_NOT_CONFIGURED`السيرفر	الحالة503ممكن تتكرر	المعنىمفاتيح الـ API مش متاحة لسه على السيرفر.	تعمل إيهجرّب بعدين.
`ENCRYPTION_NOT_CONFIGURED`السيرفر	الحالة503ممكن تتكرر	المعنىمينفعش نخزن المفاتيح بأمان دلوقتي.	تعمل إيهجرّب بعدين.
`SCHEDULING_UNAVAILABLE`السيرفر	الحالة503ممكن تتكرر	المعنىالجدولة مش متاحة مؤقتًا.	تعمل إيهابعت دلوقتي أو جرّب بعدين.