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

# سياسة بيانات الموصلات

> ما يقوم كل موصل بمزامنته واستثنائه: سقف تعبئة رجعية 24 شهراً، واستثناء حقول الاعتماد والهويات الحكومية لـ Gmail وSlack وAffinity وSalesforce وHubSpot وAttio.

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

تُدار ستة موصلات وفق سياسة الإطلاق اليوم: **Gmail وSlack وAffinity وSalesforce وHubSpot وAttio**.

## الضمانات العامة

تنطبق هذه على كل موصل خاضع للسياسة:

* **سقف تعبئة رجعية 24 شهراً.** لا تُزامَن الأنشطة الأقدم من 24 شهراً (رسائل البريد، والرسائل، وأنشطة إدارة علاقات العملاء، والمهام، والملاحظات، والتفاعلات).
* **كيانات إدارة علاقات العملاء الدائمة مُضمَّنة دائماً.** سجلات الحالة الحالية في إدارة علاقات العملاء — `accounts` و`contacts` و`companies` و`organizations` و`persons`/`people` و`opportunities` و`deals` و`leads` و`lists` و`list_entries` و`field_values` و`pipelines` و`products` — تُزامَن بالكامل بغض النظر عن العمر. حساب عمره 5 سنوات لا يزال يصل. تدفقات نشاطها فقط هي التي يُطبَّق عليها السقف.
* **بيانات الاعتماد والهويات الحكومية/المالية تُجرَّد من المصدر.** الحقول التي تطابق أنماط بيانات الاعتماد/الأسرار (`password` و`secret` و`api_key` و`token` و`client_secret` و`private_key` و`access_key`) وأنماط الهويات الحكومية/المالية (`ssn` و`social_security` و`tax_id` و`ein` و`vat` و`iban` و`swift`/`bic` و`routing_number` و`credit_card` و`cvv`/`cvc` و`passport` و`national_id` و`drivers_license` و`aadhaar` و`bank_account` و`bank_number`) تُعطَّل قبل مغادرة الصفوف نظام المصدر.
* **مبالغ الصفقات والإيرادات محفوظة.** الحقول الرقمية الحرجة للأعمال (`amount` و`annual_revenue` و`account_number` كمُعرِّف في إدارة علاقات العملاء) محفوظة صراحةً — قائمة الاستثناء تستهدف الأسرار والهويات المالية الشخصية، لا البيانات التجارية.

## سياسة كل موصل

### Gmail

|                    |                                                                    |
| ------------------ | ------------------------------------------------------------------ |
| التعبئة الرجعية    | آخر 24 شهراً من البريد                                             |
| التسميات المستثناة | `SPAM` و`TRASH` و`DRAFT` و`CATEGORY_PROMOTIONS` و`CATEGORY_SOCIAL` |
| ما يصل             | الموضوع، والمُرسِل، والمُستقبِل، ونص الرسالة                       |
| ما لا يصل أبداً    | المرفقات، وMIME الخام، وترويسات النقل                              |

تُصفَّى التسميات المستثناة من المصدر عبر مرشح صف `ArrayDoesNotContain` على `labelIds`، بحيث لا يصل البريد الترويجي والاجتماعي إلى المخزن أصلاً. يُعاد تطبيق سقف الـ 24 شهراً في مُخطِّط الاستيعاب لأن نقطة القطع من جانب مصدر Gmail هي محاولة قصوى فقط.

### Slack

|                 |                                                                      |
| --------------- | -------------------------------------------------------------------- |
| التعبئة الرجعية | آخر 24 شهراً من الرسائل                                              |
| نطاق القنوات    | اختيار القنوات من قِبَل المستخدم النهائي (من رابط الموافقة المستضاف) |
| ما يصل          | القناة، والمتحدث، والنص                                              |
| ما لا يصل أبداً | أحداث الروبوتات/النظام، وثنائيات الملفات                             |

يحترم Slack قائمة السماح بالقنوات لكل إدخال التي يختارها المستخدم النهائي أثناء تدفق الموافقة. القنوات غير المُدرَجة في قائمة السماح مستثناة من المزامنة — مرِّر مُعرِّفات القنوات المطلوبة عبر `collections` في رابط الاتصال أو في `POST /api/v1/connectors/sync`.

### Affinity وSalesforce وHubSpot وAttio (إدارة علاقات العملاء)

|                    |                                                                                                                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| التعبئة الرجعية    | آخر 24 شهراً من النشاط؛ الكيانات الدائمة مُضمَّنة دائماً                                                                                                                                               |
| المخططات المستثناة | مجموعات المرفقات وثنائيات الملفات (`attachment` و`content_document` و`content_version` و`files` و`documents`)؛ ومسارات التدقيق والتاريخ (`audit` و`history` و`login_history` و`event_log` و`apex_log`) |
| الحقول المستثناة   | حقول بيانات الاعتماد/الأسرار والحقول البنكية/الضريبية/الهويات الحكومية (انظر القائمة العامة أعلاه)                                                                                                     |
| المحفوظة           | مبالغ الصفقات، والإيرادات، وأرقام الحسابات، وجميع الحقول التجارية الأخرى                                                                                                                               |

طلب مجموعة مستثناة صراحةً (مثل `"collections": ["attachments"]`) يفشل بصوت عالٍ بـ `400` — المرفقات ومسارات التدقيق مرفوضة، لا مُسقَطة بصمت. المخططات غير المعروفة تُعامَل افتراضياً بالسقف، لا بلا سقف، بحيث لا يقوم كائن شبيه بالنشاط أضافه بائع إدارة علاقات العملاء بتعبئة رجعية دون حدود.

## التعبئة الرجعية: مسار الشريك مقابل لوحة التحكم

يُطبَّق سقف الـ 24 شهراً على **مسار الشريك** — المستخدمون النهائيون الذين يوصلهم تكاملك عبر رابط OAuth المستضاف (`POST /api/v1/connectors/link`). الحسابات الشخصية الموصولة مباشرة في لوحة تحكم Conare تُزامِن تاريخها الكامل؛ السقف ينطبق فقط على الاتصالات المسكوكة من قِبَل الشريك.

## العمل مع السياسة

**على نقطة نهاية المجموعات.** `GET /api/v1/connectors/{type}/collections` لا يسرد أبداً المجموعات المستثناة بالسياسة — المُعرِّفات التي تحصل عليها هي المُعرِّفات التي يُسمح لك بطلبها.

```bash theme={null}
curl https://api.conare.ai/api/v1/connectors/salesforce/collections \
  -H "Authorization: Bearer $CONARE_KEY"
# → { "collections": [{ "id": "account", "name": "Account" }, ...] }
# مخططات المرفقات والتاريخ غائبة بحكم التصميم.
```

**على رابط الاتصال.** مرِّر `collections` لتضييق النطاق أكثر. بالنسبة لـ Slack يُحدِّد هذا نطاق القنوات؛ وبالنسبة لمصادر إدارة علاقات العملاء يُحدِّد نطاق مخططات الكيانات. احذفه لمزامنة كل مجموعة غير مستثناة.

```bash theme={null}
curl https://api.conare.ai/api/v1/connectors/link \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endUserId": "u_123",
    "type": "salesforce",
    "collections": ["account", "contact", "opportunity"]
  }'
```

طلب مُعرِّف مستثنى بالسياسة يُعيد `400`:

```json theme={null}
{
  "statusCode": 400,
  "code": "invalid_request",
  "message": "collections excluded by data policy for salesforce: attachment (attachments and audit trails are never synced)",
  "requestId": "req_..."
}
```

**على الاستثناءات على مستوى الحقل.** حقول بيانات الاعتماد والهويات الحكومية/المالية تُطابَق بأنماط أسماء محدودة بالمقاطع مقابل مُعرِّفات حقول المصدر وأسماء إخراجها المُطبَّعة بصيغة snake\_case — السياسة اتفاقية عبر مخططات إدارة علاقات العملاء، لا قائمة لكل نظام، بحيث يُستثنى تلقائياً حقل مخصص جديد اسمه `passport_number__c` على Salesforce.

## ذات صلة

* [نظرة عامة على التكاملات](/integrations/overview) — فهرس الموصلات ووتيرة المزامنة
* [مرجع واجهة الموصلات](/api-reference) — أشكال الطلب والاستجابة الكاملة