الانتقال إلى المحتوى الرئيسي
عندما تثبّت تطبيقاً من المتجر ثم لا ترى طلبات أو أحداثاً، غالباً توقفت عند مثبّت دون إكمال الربط. يوفر كرزون مساراً واضحاً: تثبيت من /marketplace ثم إعداد من الإعدادات ← التطبيقات حتى شارة متصل — والمزامنة الأولية مرة واحدة إن ظهرت. يشرح هذا الدليل الفرق بين مثبّت ومتصل، وخطوات الربط بـ OAuth أو بيانات اعتماد API، ومتى تشغّل المزامنة الأولية.

مثبّت ≠ متصل

فلاتر الإعدادات الشائعة: الكل · متصل · غير متصل · عناصر المتجر.

الخطوات

1

ثبّت من المتجر

افتح المتجر (/marketplace) → صفحة التطبيق (/marketplace/:slug) → تثبيت. يظهر إشعار يقودك غالباً إلى التطبيقات.
GIF: تثبيت تطبيق من المتجر وظهور إشعار التوجيه للإعدادات

تثبيت من بطاقة التطبيق في المتجر

2

افتح الإعدادات ← التطبيقات

/settings/applications → بطاقة التطبيق بحالة غير متصل → إعداد (/settings/applications/:ns).
GIF: فتح إعداد تطبيق غير متصل من الإعدادات

من قائمة التطبيقات إلى صفحة الإعداد

3

أكمل الربط حسب نوع المصادقة

انظر الجدول أدناه (OAuth أو بيانات اعتماد API). بعض التطبيقات بلا auth تظهر مثبت فقط ولا تحتاج ربطاً.
صفحة إعداد تطبيق: بطاقة اتصال OAuth2 بجانب نموذج بيانات اعتماد API مع شارة غير متصل

مسارا الربط بعد التثبيت

GIF: مسار ربط OAuth من زر الربط حتى شارة متصل

إكمال OAuth حتى شارة متصل

4

تأكد من شارة متصل

لا تعتبر المهمة منتهية قبل متصل.
بطاقة تطبيق في المتجر → شاشة الإعدادات بحالة متصل

من تثبيت في المتجر إلى شارة متصل في الإعدادات

5

شغّل المزامنة الأولية إن ظهرت

بعد الاتصال فقط، وإن كان التطبيق يعرّف مزامنة أولية ولم تُنفَّذ من قبل: راجع الأعداد ثم بدء المزامنة (مرة واحدة من الواجهة).
GIF: تشغيل المزامنة الأولية بعد شارة متصل

المزامنة الأولية مرة واحدة بعد الاتصال

رحلة التثبيت حتى متصل والمزامنة

OAuth مقابل بيانات اعتماد API

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

المزامنة الأولية

  • تظهر بعد متصل فقط، وعندما يدعم التطبيق المزامنة ولم تكتمل من قبل.
  • ليست تلقائية عند التثبيت أو أول ربط — راجع التفاصيل ثم اضغط بدء المزامنة.
  • بعد التشغيل تُعلَّم مكتملة في الواجهة («تمت المزامنة الأولية مسبقاً») ولا تُعاد من نفس الزر؛ العمل الفعلي قد يستمر في الخلفية.
  • لوحات البريد الوارد الاختيارية على نفس صفحة الإعداد منفصلة عن المزامنة — ثبّتها يدوياً إن احتجتها.

تطبيقات المتاجر مقابل قوائم المتجر

لتفاصيل سلة/زد بعد الاتصال: تطبيقات المتاجر.

أخطاء شائعة

| العرض | المعنى | ماذا تفعل | | --- | --- | | مثبّت وغير متصل | ناقص OAuth أو مفاتيح | أكمل إعداد حتى متصل | | تكرار تكامل / المتجر متصل | ربط مسبق لنفس المتجر | افصل القديم ثم أعد الربط | | فشل حفظ الاعتماد | اختبار الرمز فشل | راجع المفتاح والصلاحيات في المنصة الخارجية | | لا زر مزامنة أولية | التطبيق بلا sync أو اكتملت سابقاً | متوقع — لا تنتظر زراً عاماً لكل تطبيق | شرح أعمق لمسار الأتمتة: تثبيت تطبيق وربطه.

ما بعد الخطوات

إن بقيت المشكلة بعد الخطوات → الحصول على الدعم.

الخطوة التالية

أكملتَ المسار حتى متصل. بعد ذلك:

ذات صلة

آخر تعديل في ٩ أغسطس ٢٠٢٦