Meta Tech Provider

رموز أخطاء WhatsApp Cloud API

هذه كل رموز أخطاء WhatsApp Cloud API التي نوثقها، في جدول واحد، مع معنى كل رمز وما إذا كانت إعادة المحاولة مفيدة. معظمها لا يفيد معه ذلك، لأنها حتمية، فالطلب نفسه يفشل بالطريقة نفسها، وتحوّل حلقة إعادة المحاولة الطلب الخاطئ إلى تجاوز لمعدل الطلبات.

من دون تخزين للرسائلتطبيق الأعمال + Cloud APIMCP لـ Claude وChatGPTجاهز خلال دقيقتين

Request

Code	What it means	Retry
100	A parameter is unsupported, misspelled or malformed.	No
131008	A required parameter was not included at all.	No
131009	A parameter is present with a value the endpoint rejects.	No
131021	Sender and recipient are the same number.	No
131051	The message type is not supported, often a Coexistence limit.	No
131052	Meta could not download media a customer sent.	No
131053	Meta could not upload media you sent. Size, format or reach.	No

Template

Code	What it means	Retry
132000	The number of parameters does not match the template.	No
132001	No template exists with that name and language pair.	No
132007	The template breaks messaging policy. Rewrite and resubmit.	No
132012	Parameter format does not match what the template defines.	No
132015	The template is paused after a quality decline. Temporary.	Wait
132016	The template is permanently disabled. It will not come back.	No

Window and recipient

Code	What it means	Retry
131047	The 24-hour service window is closed. Send a template.	No
131026	The recipient cannot receive the message at all.	No
131050	The person opted out. There is no workaround, by design.	No
130497	Messaging that country is restricted for your account.	No

Registration and PIN

Code	What it means	Retry
131045	The number was never registered for Cloud API messaging.	No
133010	The number is not registered. Registration must be completed.	No
133006	The number must be verified before it can be registered.	No
133005	The two-step verification PIN was wrong. Stop guessing.	No
133008	Too many PIN attempts. Registration is locked for a period.	Wait

Access and account

Code	What it means	Retry
190	The access token expired or was invalidated.	No
368	The account is restricted after a policy violation.	No
131031	The account is restricted, or its data does not match Meta's.	No
131042	A payment problem on the business account blocks sending.	No
131049	Meta blocked the message to protect ecosystem health.	No

Rate limits

Code	What it means	Retry
130429	The account's messaging throughput limit was reached.	Wait
131048	A spam rate limit was hit. Quality, not volume, is the cause.	No
131056	Too many messages between your number and one recipient.	No
80007	The account hit its management call limit. Usually polling.	Wait

Transient

Code	What it means	Retry
131016	A Meta service is temporarily unavailable.	Yes
131000	Unclassified failure. Retry once, then escalate with the trace id.	Yes

Coexistence sync

Code	What it means	Retry
2593107	The chat history synchronisation limit was exceeded.	No
2593108	A sync was attempted outside the 24-hour sync window.	No

كيفية قراءة عمود إعادة المحاولة

يحتوي على ثلاث قيم، والاختيار الخاطئ بينها هو أغلى خطأ في هذا المرجع كله.

تعني «لا» أن الفشل حتمي. ما فشل هو الطلب أو القالب أو حالة المستلم، وإرسال الطلب نفسه مرة أخرى ينتج الخطأ نفسه ويستهلك سعة ستحتاج إليها لاحقًا. وتعني «نعم» أن الفشل كان من جهة Meta، وأن التراجع التدريجي يحله فعليًا. أما «انتظر» فتعني أن الحالة حقيقية لكنها مؤقتة، مثل حد أو قفل يزول تلقائيًا، حيث لا تفيد إعادة المحاولة قبل زوالها وقد تطيل مدتها.

لماذا لا يمكن إعادة محاولة معظم هذه الرموز

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

مشكلة الطلب لا تصبح صحيحة في المحاولة الثانية.
مشكلة القالب موجودة في القالب نفسه، ولا يستطيع الطلب تغييرها.
مشكلة النافذة أو إلغاء الاشتراك تتعلق بحالة المستلم، لا بحالتك.
تقييد الحساب قرار، وإعادة المحاولة ليست استئنافًا.

ما الذي يجب تسجيله عند وصول أحد هذه الرموز

ما يكفي لتشخيص المشكلة من دون إعادة إنتاجها، وهذا هو الفارق بين إصلاح يستغرق خمس دقائق ويوم كامل من التخمين.

استجابة الخطأ الكاملة، بما فيها trace id، وهو ما يطلبه دعم Meta.
نص الطلب كما أُرسل، لا كما قصدته. الفجوة بين الاثنين هي المشكلة عادةً.
معرّف رقم الهاتف، لتمييز مشكلة رقم واحد من مشكلة تشمل الحساب كله.
الطابع الزمني، لمقارنة الفشل بحالة الاتصال في تلك اللحظة.

الرموز الموجودة فقط في Coexistence

اثنان منها، وهما يربكان الناس لأنهما يبدوان كأنهما فشلا عاديان في الإرسال. يتعلق 2593107 و2593108 بمزامنة سجل المحادثات، وهي الخطوة التي تنسخ المحادثات الحديثة من تطبيق WhatsApp Business عند اتصال الرقم لأول مرة.

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

الأسئلة الشائعة

ما الأخطاء التي ينبغي إعادة المحاولة بشأنها؟

131016 و131000، مع تراجع تدريجي أُسّي. تزول 130429 و132015 و133008 تلقائيًا عند الانتظار. أما البقية فحتمية.

هل يعني رمز الخطأ أن رقمي غير متصل؟

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

ما هو trace id؟

معرّف في استجابة الخطأ يتيح لدعم Meta العثور على الطلب المحدد. سجّله عند كل فشل، فمن دونه لا يمكن معالجة طلب الدعم.

هل هذه الرموز متطابقة لدى كل مزود؟

نعم. تأتي من Cloud API لدى Meta، لذا فهي متطابقة أيًا كان المزود الذي وصل الرقم. ولا يستطيع المزود تغيير سوى مدى وضوح وصولها إليك.

هل أنت مستعد للبدء؟

أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.

ابدأ الفترة التجريبية المجانيةلن تُفرض أي رسوم لمدة 7 أيام. ألغِ في أي وقت.

تابع القراءة

ReferenceWhatsApp error 131047: re-engagement messageError 131047 means more than 24 hours have passed since that customer last messaged you, so the customer service window is closed and free text will not deliver.ReferenceWhatsApp error 100: invalid parameterError 100 means the request carried a parameter Meta does not accept: unsupported, misspelled, or the wrong shape for that endpoint.ReferenceWhatsApp error 131016: service unavailableError 131016 means a service on Meta's side is temporarily unavailable.ReferenceA number stopped working: how to find out whyWhen a connected number stops working, the cause is almost never the code.ReferenceWhatsApp webhook fields, and which ones go whereA WhatsApp Business Account delivers events as named fields.GuideWhatsApp Coexistence: the app and the API on one numberCoexistence is Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time.