> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karzoun.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# استكشاف الأخطاء

> مشاكل شائعة أثناء بناء واختبار تعريف ميني أب.

مشاكل قد تواجهها **أثناء بناء** تعريف ميني أب قبل أو أثناء مراجعة كرزون.

## السوق والتقديم

**ميني أب غير ظاهر بعد الموافقة**

* كرزون وحدها تستطيع تعيين `status: 'public'` — أبقِ `status: 'private'` في مسودتك
* أكّد بريد الموافقة و`ns` الصحيح في بحث السوق
* قد تكون تطبيقات الشركاء فقط مقيّدة بمستأجرين محددين

**رفض التقديم بسبب أخطاء المخطط**

* تحقّق من الحقول المطلوبة في [مخطط المستند](/ar/miniapps/reference/document-schema)
* تأكد أن `ns` فريد وبحروف صغيرة وبصيغة kebab-case
* أدرج كل حقل سر في `auth.sensitiveKeys`

## المصادقة

**نافذة OAuth المنبثقة لا تُغلق**

* يجب أن يكون Redirect URI بالضبط `{SAAS_API_URL}/miniapps/{ns}/oauth2`
* افحص وحدة تحكم المتصفح لأخطاء `postMessage` من نافذة OAuth

**الإجراءات تُرجع 401 / يفشل `test_token` بـ 401**

* تحقّق من ربط `[[accessToken]]` في `get_token.mapping`
* لـ OAuth، أكّد إعداد `refresh_token` و`auto_refresh: true`
* لـ **HTTP Basic** (`Authorization: 'Basic [[user]]:[[pass]]'`)، أكّد أن وقت التشغيل يتضمن الترميز التلقائي لـ Basic — بدونه يُرسل `user:pass` خاماً ويرفض المزوّدون الطلب
* أكّد أن بيانات الاعتماد غير مبدّلة (مثلاً WooCommerce Consumer Key كاسم مستخدم وSecret ككلمة مرور)
* اختبر نفس الطلب بـ curl ببيانات اعتماد بيئة الاختبار:
  `curl -u 'ck_…:cs_…' 'https://store.example/wp-json/wc/v3/orders?per_page=1'`

## الويب هوك والمشغّلات

**الأتمتة لا تُفعَّل أبداً**

* يجب أن يطابق `triggers[].event` السلسلة التي ينتجها `webhook.eventExtraction` تماماً
* سجّل رابط الويب هوك لدى المزوّد: `{SAAS_API_URL}/miniapps/{ns}/webhooks`
* فعّل التحقق من التوقيع فقط بعد تأكيد مسار حل السر

**فشل التحقق من التوقيع**

* أكّد أن `secretKey` يُحل من بيانات الاعتماد مقابل `auth.config` (عام مقابل لكل مستأجر)
* قارن بايتات الجسم الخام — JSON المُعاد تسلسله لن يطابق HMAC

## مصادر RPC

**القوائم المنسدلة فارغة**

* اختبر رابط `source.rpc_*` يدوياً برمز صالح
* افحص `dataPath` و`valueField` و`labelField` مقابل JSON الحي
* وفّر `x-fallback: 'input'` حتى يتمكن المستخدمون من لصق المعرّفات عند فشل RPC

## مزامنة التجارة الإلكترونية

**الطلبات لا تظهر**

* فضّل `sync.webhooks.handlers` على `webhook.ecommerce` القديمة
* يجب أن يكون `recordType` للمعالج `order` أو `abandonedCart`
* يجب أن يستخرج `mapping.code` معرّفاً خارجياً مستقراً
* تضمين حمولات ويب هوك عيّنة في [تقديمك](/ar/miniapps/guides/submission)

## الحصول على المساعدة

ضمّن في طلبات الدعم:

1. `ns` و`version` لميني أب
2. تعريف JSON مُنقَّح
3. حمولة ويب هوك عيّنة واسم الحدث المتوقع
4. حساب بيئة اختبار المزوّد (إن وُجد)

التواصل: `developers@karzoun.chat` أو مدير شريك كرزون.


## Related topics

- [استكشاف الأخطاء](/ar/mcp-server/guides/troubleshooting.md)
- [إعداد Claude Desktop (stdio)](/ar/mcp-server/setup/claude-desktop.md)
- [مكالمات واتساب](/ar/help-center/guides/whatsapp/whatsapp-calling.md)
- [الأخطاء](/ar/developers/guides/errors.md)
- [MCP المستضاف (/mcp)](/ar/mcp-server/setup/hosted.md)