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

# التكاملات

> ستة موصلات من الدرجة الأولى — Notion وGranola وGitHub وSlack وGmail وTwenty CRM — إلى جانب فهرس حي بنحو 200 مصدر يستطيع المستخدمون النهائيون وصلها.

يوصل المستخدمون النهائيون الأدوات التي يستخدمونها بالفعل، وتملأ ذاكرتهم نفسها. تُزامن كل مصدر موصول في [حاويته](/platform/concepts#containers) الخاصة، بحيث يمكن فصل مصدر واحد — وحذف ذكرياته — دون المساس بالباقي.

## الموصلات من الدرجة الأولى

ستة موصلات بخطوط أنابيب موَلَّفة ومبنية لغرض محدد:

| الموصل         | مسار الاتصال                     | المزامنة                                        |
| -------------- | -------------------------------- | ----------------------------------------------- |
| **Notion**     | OAuth                            | تزايدية، \~15 دقيقة                             |
| **Granola**    | OAuth                            | تزايدية، \~15 دقيقة                             |
| **GitHub**     | مُنتقي مستودعات داخل لوحة التحكم | تزايدية، \~15 دقيقة                             |
| **Slack**      | رابط موافقة مستضاف               | مجدولة + عند الطلب                              |
| **Gmail**      | رابط موافقة مستضاف               | مجدولة + عند الطلب (نافذة تعبئة رجعية 24 شهراً) |
| **Twenty CRM** | عنوان الحالة + مفتاح API         | في الوقت الفعلي عبر webhooks + تزايدية          |

## الفهرس: نحو 200 مصدر إضافي

بالإضافة إلى الستة من الدرجة الأولى، يسرد `GET /api/v1/connectors/catalog` كل نوع مصدر قابل للاتصال — HubSpot، وLinear، وSalesforce، وPostgres، والبقية — مجلوباً مباشرة، لا قائمة ثابتة قديمة أبداً.

## توصيل المستخدمين عبر واجهة API

```bash theme={null}
# 1. سك رابط اتصال OAuth مستضاف لمستخدمك النهائي
curl https://api.conare.ai/api/v1/connectors/link \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "endUserId": "u_123", "type": "slack" }'

# 2. (مصادر بتدفق بيانات اعتماد) اتصل مباشرة
curl https://api.conare.ai/api/v1/connectors/twenty \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "endUserId": "u_123", "instanceUrl": "...", "apiKey": "..." }'

# 3. شغّل مزامنة الآن
curl https://api.conare.ai/api/v1/connectors/sync \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "endUserId": "u_123", "type": "slack" }'
```

## تحديد النطاق

مرِّر `objects` عند الاتصال و`collections` عند المزامنة للتحكم بدقة فيما يتدفق. يستمر النطاق على الاتصال ويمكن قراءته عبر `GET /api/v1/connectors/{type}/collections`؛ مُعرّف غير معروف يُعيد `400` يسرد المُعرّفات الصالحة.

## قطع الاتصال

`DELETE /api/v1/connectors/{type}` يُلغي الوصول **و**يحذف ذكريات ذلك المصدر المفهرسة للمستخدم.

أشكال الطلب/الاستجابة الكاملة: [مرجع واجهة الموصلات](/api-reference).