نحن بصدد إنهاء API داخل المواقع. راجع مستند حالة إنهاء API داخل المواقع للحصول على التفاصيل، والتعرف على كيفية الترحيل إلى API السحابة من الجيل القادم.
رسائل الخطأ والحالة
يقدم هذا المستند مزيدًا من المعلومات حول الأنواع التالية من رسائل الخطأ والحالة:
لاستكشاف أخطاء التسجيل المضمّن وإصلاحها، راجع أخطاء دفق التسجيل المضمّن.
رموز أخطاء عميل واجهة API الخاصة بتطبيق WhatsApp للأعمال
| رمز الخطأ | الوصف |
|---|---|
| تعذر تنزيل الوسائط الواردة من المُرسل. |
| فشل إرسال الرسالة نظرًا لوجود خطأ واحد أو أكثر متعلق بطريقة الدفع الخاصة بك.
تحقق من إعداد الدفع لديك في مدير واتساب وحاول مرة أخرى. |
| تعذر إرسال الرسالة نظرًا لأنها كانت مُعلقة لفترة طويلة جدًا. (أي، أكثر من يوم واحد). يكون هذا الأمر متوقعًا في حالة تعطيل عميل API الخاصة بتطبيق WhatsApp للأعمال لأكثر من يوم واحد، ثم إعادة تشغيله. أعد إرسال الرسالة. |
| فشل إرسال الرسالة أثناء فترة الصلاحية (TTL). |
|
|
| تعذر إرسال الرسالة نظرًا لوجود خطأ متعلق بشهادتك. قم بتنزيل الشهادة الجديدة من مدير واتساب وأعد التسجيل. |
| تعذر إرسال الرسالة نظرًا لوجود خطأ متعلق بشهادتك. قم بتنزيل الشهادة الجديدة من مدير واتساب وأعد التسجيل. |
| يمكن أن يحدث ذلك عند إرسال رسالة ولكن بدون التوقيع على شهادة عميل النشاط التجاري بشكل صحيح باستخدام مفاتيح هوية العميل. ويشير ذلك على الأرجح إلى أن العميل قد أعاد التسجيل باستخدام مفاتيح هوية جديدة، ولكنه لم يجتز دفق إنشاء الشهادة بالكامل. |
| تعذر إرسال الرسالة نظرًا لمرور أكثر من 24 ساعة منذ آخر رد للعميل على هذا الرقم. استخدم قالب رسالة للرد. |
| تعذر إرسال الرسالة نظرًا لوجود تقييدات على عدد الرسائل التي يمكن إرسالها من رقم الهاتف هذا. قد يرجع ذلك إلى حظر عدد كبير من الرسائل السابقة أو الإبلاغ عنها باعتبارها محتوى غير مهم أو احتيالي. تحقق من حالة الجودة لديك في مدير واتساب. لمزيد من المعلومات، يمكنك الرجوع إلى وثائق تقييدات معدلات الاستدعاء القائمة على الجودة. |
| تعذر إرسال الرسالة نظرًا إلى أن رقم هاتف هذا المستخدم يمثل جزءًا من تجربة. يمكنك تخطي إرسال الرسائل إلى هذا المستخدم. |
| تعذر إرسال الرسالة نظرًا لاحتمالية تغيير المستخدم الذي يملك رقم الهاتف هذا. |
| تعذر إرسال الرسالة نظرًا لحدوث خطأ غير معروف. أعد المحاولة لاحقًا. |
| رسائل المستند التي تتضمن شروحات توضيحية غير مدعومة حاليًا. |
| |
| يتجاوز طول الرسالة 4096 حرفًا. |
| أنواع المستلم الصالحة:
|
| يمكن أن يوجد بالفعل تعارض في معرف UUID لطلب تحميل الوسائط أو في الوسائط التي تتضمن معرف UUID هذا. |
|
|
| لم يتم العثور على الملف أو المورد |
| المستلم غير مُدرج في قائمة السماح |
| عدم توفير معلمة مطلوبة. إذا كنت ترسل قائمة رسائل، فمن الممكن أنه فاتك جزء إذا كنت تحاول إرسال رسالة منتج واحد أو رسالة تتعلق بمنتجات متعددة، فمن الممكن أنك قد فوت |
| إما أن القيمة التي تم إدخالها للمعلمة من النوع الخاطئ أو أنه توجد مشكلة أخرى. إذا كنت تحاول إرسال قائمة رسائل، فتحقق مما إذا كان كل معرف صف فريدًا أم لا. إذا كنت تحاول إرسال رسالة منتج واحد، فمن الممكن أن تكون قد أرسلت إذا كنت تحاول إرسال رسالة تتعلق بمنتجات متعددة، فتحقق من أن |
| توجد معلمة غير مطلوبة. |
| |
| |
|
|
| تم الوصول إلى تقييد معدلات الاستدعاء من جانب العميل |
| إذا كان النظام يتعرض لتحميل زائد، فسيتم إرجاع هذا الخطأ للسماح للنظام بالتعافي من التحميل الزائد. |
| يظهر هذا الخطأ عند إرسال طلب master فقط، مثل تعيين الإعدادات والحصول على الإعدادات والاستيراد والتصدير وطلب الرمز البرمجي والتسجيل وغير ذلك، إلى عقدة ليست عقدة master أساسية. قد يحدث ذلك في حالة عدم إعداد عميل API الخاصة بتطبيق واتساب للأعمال بشكل صحيح أو بسبب حدوث أخطاء داخلية. يجب أن تؤدي إعادة محاولة إجراء الطلب إلى حل هذا الخطأ. إذا لم يساعد ذلك في إزالة الخطأ، فيرجى الاتصال بفريق الدعم. |
| يحدث هذا الخطأ عند إرسال الطلبات إلى عقدة Coreapp التي لا تكون مالكة للجزء أو قيد عملية ما لتصبح مالكة للجزء. وقد يظهر هذا الخطأ عندما نجري عملية تجاوز الفشل للجزء في إعداد الاتصال المتعدد. يجب أن تؤدي غالبًا إعادة محاولة إجراء الطلب إلى حل هذا الخطأ. وإذا لم يتم حل هذا الخطأ، فيرجى الاتصال بفريق الدعم. |
| يحدث هذا الخطأ عندما ترسل رسالة إلى نفسك. |
| يحدث هذا الخطأ إذا لم تقم بتكوين تنسيق أحداث Webhooks لواجهة REST API. |
| |
| تكون مطالبًا بتغيير كلمة السر. |
| الطلب غير صالح. |
| تعذر إرسال الرسالة. راجع "لماذا لا يصل معدل التسليم إلى 100%؟" الأسئلة المتكررة |
| أرسلت رسالة إلى مستخدم واتساب الذي من المحتمل أنه قد تغير، وتم إرسال إشعار نظام |
| تم تقييد حسابك من إرسال أي رسائل بسبب انتهاك سياسة النزاهة. راجع إنفاذ سياسة منصة واتساب للأعمال لمزيد من المعلومات. |
| لا يتطابق عدد المعلمات المتوفر مع العدد المتوقع للمعلمات. |
| حالة القالب غير نشطة، أو أن القالب غير متوفر للغة والإعدادات المحلية. |
| تعذر على المتلقي تنزيل القالب. |
| لا توجد قوالب للغة والإعداد المحلي المحددين. |
| يتجاوز طول المعلمة الحد الأقصى |
| يتجاوز طول النص المُترجم الحد الأقصى |
| تم انتهاك سياسة المسافات البيضاء |
| تم انتهاك سياسة تنسيق الأحرف |
| تنسيق الوسائط المُستخدم غير مدعوم |
| المكون المطلوب في القالب غير موجود |
| عنوان URL في مكون الزر غير صالح |
| رقم الهاتف في مكون الزر غير صالح |
| لا يتطابق تنسيق المعلمة مع التنسيق الموجود في القالب الذي تم إنشاؤه |
| الأزرار غير مدعومة من جانب المُتلقي |
| يحدث هذا الخطأ عندما لا يتم تنزيل حزمة لغة رسالة القالب بعد. |
| يحتوي طلب الرسالة على عدد أقسام يقل عن الحد الأدنى أو يزيد عن الحد الأقصى. لمزيد من المعلومات، يمكنك الرجوع إلى الكائن تحتاج إلى كائن |
| يوجد عدد غير صالح من الصفوف. وبالنسبة لقائمة الرسائل، يجب أن يتوفر كائن |
| تم انتهاك سياسة تنسيق الأحرف. |
| لا يحتوي كائن القسم على أي منتجات أو أن إجمالي عدد المنتجات قد تجاوز الحد الأقصى المسموح به. |
| معرف الكتالوج الذي تم تقديمه إما غير موجود أو لا ينتمي إلى حساب WhatsApp للأعمال (WABA). |
| لم يتم ربط معرف الكتالوج الذي تم تقديمه برقم الهاتف الذي تستخدمه لإرسال رسالة. |
| لم يتم العثور على بعض المنتجات التي تم تقديمها ضمن الطلب في الكتالوج. |
| لم يتم العثور على أي منتجات في الكتالوج الذي تم تقديمه. |
| متوفر فقط للأنشطة التجارية في الهند. يتم إرجاع هذا الخطأ عندما يرسل النشاط التجاري رسالة منتج فردي تتضمن معلومات امتثال للتجارة الإلكترونية مفقودة وغير مكتملة. |
| متوفر فقط للأنشطة التجارية في الهند. يتم إرجاع هذا الخطأ عندما يرسل النشاط التجاري رسالة منتجات متعددة تتضمن معلومات امتثال للتجارة الإلكترونية مفقودة وغير مكتملة. |
| متوفر فقط للأنشطة التجارية في الهند. يتم إرجاع هذا الخطأ عندما يرسل نشاط تجاري رسالة منتجات متعددة حيث يوجد مزيج من المنتجات غير الصالحة والمنتجات التي تفتقد إلى معلومات الامتثال. |
| يتم الإرجاع عندما تكون بنية الكائن |
| متوفر فقط للأنشطة التجارية في الهند. يتم إرجاع هذا الخطأ عندما لا يوفر النشاط التجاري أي معلومات امتثال. راجع نقطة نهاية امتثال النشاط التجاري. |
| حالة القالب |
| حالة القالب |
| حالة القالب |
| الدفق بالمعرف المحدد غير موجود أو لا ينتمي إلى حساب واتساب للأعمال الخاص بك (WABA)، أو أنه في حالة غير صالحة. |
| الدفق في حالة محظورة. يمكن إرجاع هذا الخطأ أيضًا إذا كان الدفق يستخدم نقطة نهاية وكان الإعداد المطلوب غير مكتمل، على سبيل المثال، لم يتم تحميل المفتاح العام أو أصبح غير صالح. راجع تنفيذ نقطة نهاية التدفقات. |
| الدفق ف حالة مقيدة وتم إرسال 10 رسائل بالفعل تستخدم هذا الدفق في الساعة الماضية. |
بالنسبة إلى رموز أخطاء مدير المعاملات التجارية الخاصة بالأنشطة التجارية الهندية، راجع مركز مساعدة الأعمال.
رموز حالة HTTP
توجد رموز برمجية خاصة بحالة HTTP يمكن استخدامها من خلال عميل واجهة API واتساب للأعمال.
| رمز HTTP | الوصف |
|---|---|
| تمت العملية بنجاح |
| تمت العملية بنجاح (موافق) |
| تم الإنشاء بنجاح (لطلبات POST) |
| تم العثور عليه |
| أخطاء في العميل |
| كان الطلب غير صالح |
| غير مُصرح به |
| محظور |
| لم يتم العثور عليه |
| الطريقة غير مسموح بها. |
| فشل الشروط المسبقة |
| الرسالة بمعدل محدد |
| تجاوزت الطلبات الحد الأقصى |
| أخطاء في الخادم |
| خطأ داخلي بالخادم |
| انتهاء المهلة |