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

# دليل البدء السريع لـ Integrations

> قم بتوصيل أول تكامل لك، وصادق على المصدر، واختر البيانات المراد مزامنتها، وتحقق من نجاح أول عملية تشغيل في Integrations في أقل من 10 دقائق.

يرشدك هذا الدليل خلال توصيل تكامل مُسبق الإعداد من كتالوج الموصلات. الخطوات هي نفسها لمعظم أنواع الموصلات — فقط طريقة المصادقة هي التي تختلف.

## قبل أن تبدأ

* دور المشرف أو العضو في مساحة العمل الخاصة بك
* بيانات اعتماد الأداة التي تريد توصيلها (مفتاح API، أو معرف العميل وسر تطبيق OAuth، أو حساب الخدمة)

## الخطوات

<Steps>
  <Step title="ابحث عن التكامل الخاص بك">
    انتقل إلى **Integrations → Catalog** وابحث أو تصفح إلى الأداة التي تريد توصيلها. تعرض كل بطاقة موصل طريقة المصادقة وقدرات المزامنة.
  </Step>

  <Step title="المصادقة">
    انقر على **Connect** على الموصل. اعتمادًا على طريقة المصادقة:

    * **API key** — الصق المفتاح في الحقل المتوفر.
    * **OAuth 2.0** — انقر على **Authorize** ليتم إعادة توجيهك إلى صفحة تفويض الأداة. قم بتسجيل الدخول ومنح الوصول، ثم ستتم إعادتك تلقائيًا.
    * **Service account** — قم بتحميل ملف بيانات الاعتماد (عادةً ملف مفتاح JSON) وأدخل أي حقول مطلوبة.

    راجع [طرق المصادقة](/integrations/authentication) للحصول على تفاصيل حول كل نهج.
  </Step>

  <Step title="تكوين تعيين الحقول">
    قم بتعيين الحقول من الأداة المتصلة إلى نموذج بيانات مساحة العمل الخاصة بك. التعيينات الافتراضية معبأة مسبقًا للحقول الشائعة — راجعها واضبطها حسب الحاجة. يتم تمييز الحقول المطلوبة بعلامة النجمة.
  </Step>

  <Step title="اختبار الاتصال">
    انقر على **Test connection** لتشغيل مزامنة عينة. يسحب الاختبار عددًا صغيرًا من السجلات ويعرضها للمراجعة. إذا فشل الاختبار، فإن رسالة الخطأ تشرح السبب.
  </Step>
</Steps>

<Note>
  تتطلب بعض الموصلات إدراج عناوين IP الصادرة للمنصة في القائمة المسموح بها من جانبك. تحقق من ملاحظات إعداد الموصل لمتطلبات IP قبل الاختبار.
</Note>

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

* راجع [طرق المصادقة](/integrations/authentication) لفهم متى يجب تدوير بيانات الاعتماد.
* استكشف [الموصلات](/integrations/connectors) للحصول على تفاصيل الإعداد الخاصة بكل فئة.
* قم بإعداد [الـ webhooks](/integrations/webhooks/configure) إذا كنت بحاجة إلى أتمتة قائمة على الأحداث.