> ## 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.

# تثبيت تطبيق وربطه

> من المتجر إلى شارة «متصل»: التثبيت، طريقتا الربط (OAuth وبيانات الاعتماد)، اختبار الاتصال، شارات الحالة، وإعادة الربط.

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

## المسار الكامل

<Steps>
  <Step title="تصفّح المتجر">
    افتح **المتجر** (`/marketplace`) وابحث عن التطبيق أو تصفّح الفئات.
  </Step>

  <Step title="افتح صفحة التطبيق">
    انقر التطبيق لقراءة وصفه وما يتيحه من إجراءات وأحداث قبل أن تثبّته.
  </Step>

  <Step title="ثبّت">
    اضغط **تثبيت**. يُضاف التطبيق إلى مساحة عملك بحالة **غير متصل**، ويظهر إشعار يقودك إلى صفحة التطبيقات.
  </Step>

  <Step title="افتح الإعدادات ← التطبيقات">
    `/settings/applications` تعرض تطبيقاتك المثبتة مع حالة كل واحد.
  </Step>

  <Step title="اضغط إعداد">
    تفتح صفحة إعداد التطبيق، وفيها طريقة الربط المناسبة له.
  </Step>

  <Step title="اربط">
    عبر **OAuth** أو **بيانات اعتماد API** حسب التطبيق (مشروحان أدناه).
  </Step>

  <Step title="تأكد من شارة «متصل»">
    لا تعتبر المهمة منتهية قبل ظهور الشارة.
  </Step>
</Steps>

<Info>
  **وسائط مطلوبة:** ثلاث لقطات متتابعة: صفحة التطبيق في المتجر مع زر «تثبيت» ← بطاقة التطبيق في الإعدادات بحالة «غير متصل» ← نفس البطاقة بحالة «متصل».\
  المسار المقترح: `/images/help/automations/apps-install-to-connected.webp`\
  **فيديو (مستحسن):** 40 ثانية: رحلة كاملة من المتجر إلى «متصل».\
  **عرض تفاعلي (مستحسن):** المقارنة بين «مثبت» و«متصل» وأثر كل منهما على الأتمتة.
</Info>

## طريقة الربط ١: OAuth

تستخدمها التطبيقات التي تتيح تسجيل دخول مباشراً — مثل **سلة** و**زد** و**Google Sheets** و**Calendly**.

1. اضغط زر الربط في صفحة إعداد التطبيق.
2. تفتح نافذة منبثقة على موقع المزوّد.
3. سجّل الدخول بحساب **يملك صلاحية** على المتجر أو الحساب المطلوب.
4. وافق على الأذونات المطلوبة.
5. تُغلق النافذة تلقائياً وتتحول الحالة إلى **متصل**.

مزايا هذه الطريقة: لا تنسخ مفاتيح، والأذونات محددة وواضحة، والربط قابل للسحب من طرف المزوّد.

| ما قد يمنع النجاح                 | المعالجة                                                                                                            |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| مانع النوافذ المنبثقة في المتصفح  | اسمح بالنوافذ لموقع كرزون ثم أعد المحاولة                                                                           |
| تسجيل الدخول بحساب لا يملك صلاحية | سجّل الخروج ثم ادخل بالحساب المالك                                                                                  |
| رسالة **تكامل مكرر**              | الحساب نفسه مربوط بمؤسسة أخرى — راجع [استكشاف أخطاء الربط](/ar/help-center/guides/automations/apps/troubleshooting) |
| إغلاق النافذة قبل الانتهاء        | أعد المحاولة وأكمل حتى الإغلاق التلقائي                                                                             |

بعد الربط يظهر عادةً زر **تحديث الرمز** لتجديد صلاحية الاتصال، و**إعادة ربط** إن احتجت تغيير الحساب.

## طريقة الربط ٢: بيانات اعتماد API

تستخدمها التطبيقات التي تتطلب مفتاحاً أو رمزاً من لوحة تحكم المزوّد — مثل **شوبيفاي** و**Slack** و**بوابات الدفع** ومنصات القياس.

1. ادخل لوحة تحكم المزوّد وأنشئ المفتاح المطلوب.
2. أعطه **أقل الصلاحيات** الكافية لعملك.
3. انسخه إلى الحقول في صفحة إعداد التطبيق.
4. اضغط **حفظ بيانات الاعتماد**.

عند الحفظ يختبر كرزون البيانات فعلياً قبل اعتماد الاتصال:

* **نجح الاختبار** ← الحالة **متصل**.
* **فشل الاختبار** ← لا تُحفظ البيانات ويبقى التطبيق **غير متصل**. هذا مقصود: أفضل من تطبيق يبدو مربوطاً ويفشل لاحقاً داخل مسار حي.

<Warning>
  مفاتيح API أسرار حقيقية. لا ترسلها في محادثات الفريق ولا تخزنها في ملفات مشتركة. وإن تسرّب مفتاح، ألغِه من لوحة المزوّد فوراً ثم أنشئ بديلاً وأعد الربط.
</Warning>

بعض التطبيقات لا تحتاج ربطاً أصلاً، فتظهر ملاحظة بأن لا حاجة للإعداد.

## شارات الحالة

| الشارة                     | معناها                     | ماذا تفعل                      |
| -------------------------- | -------------------------- | ------------------------------ |
| **متصل**                   | جاهز للاستخدام في الأتمتات | ابدأ البناء                    |
| **غير متصل**               | مثبّت لكنه غير مربوط       | افتح **إعداد** واربطه          |
| **مثبت**                   | موجود في مساحة عملك        | أكمل الربط إن كان يتطلبه       |
| **بيانات الاعتماد مطلوبة** | ينتظر مفاتيح               | أدخلها واحفظ                   |
| **تكامل مكرر**             | الحساب مربوط بمؤسسة أخرى   | اربط حساباً آخر أو افصل السابق |
| **به خطأ** / **معلّق**     | مشكلة في الاتصال           | راجع صفحة استكشاف الأخطاء      |

<Tip>
  اجعل التحقق من شارات الحالة جزءاً من روتينك الشهري. تطبيق انقطع اتصاله بصمت يكسر المسارات المعتمدة عليه دون أن ينبّهك أحد.
</Tip>

## بعد الربط: المزامنة الأولية

تطبيقات المتاجر تعرض بعد الربط خيار **مزامنة البيانات الأولية** لسحب عملائك ومنتجاتك وطلباتك الحالية إلى كرزون. مشروحة في [تطبيقات المتاجر](/ar/help-center/guides/automations/apps/ecommerce) — واقرأها قبل تشغيلها، فلها آثار على أتمتاتك القائمة.

## الصلاحيات

ربط التطبيقات وإدارتها يتطلب صلاحيات إدارية على الإعدادات. إن لم تظهر لك صفحة **الإعدادات ← التطبيقات** أو ظهرت للقراءة فقط، فالمطلوب صلاحية من مدير مساحة العمل لا حل تقني.

## أخطاء شائعة

| الخطأ                             | النتيجة                            | الصواب                       |
| --------------------------------- | ---------------------------------- | ---------------------------- |
| التثبيت والاعتقاد بأن العمل انتهى | التطبيق **غير متصل** والأتمتة تفشل | أكمل الربط حتى شارة **متصل** |
| الربط بحساب موظف شخصي             | ينقطع الاتصال عند مغادرته          | استخدم حساباً مؤسسياً        |
| مفتاح بصلاحيات كاملة بلا داعٍ     | مخاطرة أمنية غير مبررة             | أقل صلاحية كافية             |
| تجاهل فشل اختبار الاتصال          | تظن أنه مربوط وليس كذلك            | صحّح المفاتيح وأعد الحفظ     |
| بناء أتمتة قبل الربط              | الإجراء لا يظهر أو يفشل            | اربط أولاً ثم ابنِ           |
| إهمال **تحديث الرمز**             | انقطاع مفاجئ بعد فترة              | جدّد عند ظهور تنبيه          |

## ذات صلة

* [نظرة عامة على التطبيقات](/ar/help-center/guides/automations/apps/overview)
* [تطبيقات المتاجر](/ar/help-center/guides/automations/apps/ecommerce)
* [استخدام التطبيقات في الأتمتات](/ar/help-center/guides/automations/apps/use-in-automations)
* [استكشاف أخطاء الربط](/ar/help-center/guides/automations/apps/troubleshooting)


## Related topics

- [تثبيت التطبيقات](/ar/help-center/guides/store/install-apps.md)
- [تطبيقاتي](/ar/help-center/guides/store/my-apps.md)
- [تطبيقات المتاجر](/ar/help-center/guides/automations/apps/ecommerce.md)
- [نظرة عامة](/ar/help-center/guides/store/overview.md)
- [استكشاف أخطاء الربط](/ar/help-center/guides/automations/apps/troubleshooting.md)