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

# إمكانات القراءة والكتابة

> اكتشف موصلات Conare التي تسحب البيانات إلى الذاكرة، وتلك التي تدعم إعادة الكتابة المنظمة، وما تسمح به كل إمكانية في بيئة الإنتاج الفعلية.

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

| الحقل               | المعنى                                                                                                     |
| ------------------- | ---------------------------------------------------------------------------------------------------------- |
| `capabilities.pull` | يستطيع الموصل مزامنة بيانات المصدر إلى ذاكرة Conare. تكون هذه القيمة `true` لكل موصل يعيده الفهرس.         |
| `capabilities.push` | يدعم نوع الموصل العمل كوجهة منظمة لإعادة الكتابة. تعتمد الكائنات وأنماط التعديل المتاحة على الحساب المتصل. |

<Warning>
  تعني `push: true` اكتشاف الإمكانية، وليست عملية كتابة أو منحًا للصلاحية. لا تعرض واجهة Conare العامة حاليًا نقطة نهاية عامة لتعديلات الموصلات. تقوم `POST /api/v1/connectors/sync` دائمًا بسحب البيانات إلى Conare.
</Warning>

## اكتشاف الموصلات القابلة للكتابة

استعلم عن الفهرس بدلًا من الاحتفاظ بقائمة ثابتة:

```bash theme={null}
curl https://api.conare.ai/api/v1/connectors/catalog \
  -H "Authorization: Bearer $CONARE_KEY" \
  | jq '.connectors[]
      | select(.capabilities.push)
      | { type, name, connect, capabilities }'
```

يعيد Attio حاليًا:

```json theme={null}
{
  "type": "attio",
  "name": "Attio",
  "connect": "link",
  "capabilities": {
    "pull": true,
    "push": true
  }
}
```

اعتبارًا من **3 أغسطس 2026**، يعلن 76 من أصل 205 موصلات يعيدها الفهرس العام عن دعم إعادة الكتابة أيضًا. تبقى استجابة API هي مصدر الحقيقة.

<Accordion title="76 موصلًا بقدرتي السحب والكتابة (لقطة 2026-08-03)">
  Affinity, Airtable, Amplemarket, Amplitude, Apollo.io, Attio, AWS Athena, Azure Blob Storage, Azure SQL, ClickHouse, Cloudflare R2, Databricks, DealCloud, Dialpad, Facebook Ads, Freshdesk, Front, Gainsight CS, Gong, Google Ads, Google BigQuery, Google Cloud MySQL, Google Cloud PostgreSQL, Google Cloud Storage, Google Sheets, Harmonic, HeyReach, HubSpot, Instantly, Intercom, Iterable, Klaviyo, Kustomer, LinkedIn Ads, Marketo, Microsoft Ads, Microsoft SharePoint Excel, Microsoft SQL Server, MongoDB, MotherDuck, MySQL, Neon, NetSuite, Northbeam, Outreach, Pardot, Pipedrive, Plain, PlanetScale Vitess, Podscribe, PostgreSQL, PredictLeads, Productboard, Pylon, QuickBooks, Reddit Ads, Redshift, Redshift Serverless, Reply, S3, Salesbricks, Salesforce, Salesloft, ScyllaDB, Smartlead.ai, Smartsheet, Snowflake, Sprig, Stripe, Supabase, Tigris, TikTok Ads, UserVoice, Wavelength, Zendesk Support, monday.com
</Accordion>

## ماذا يعني ذلك عمليًا

| الموصل                               | الإمكانية   | ما يمكن استنتاجه                                                                                                 |
| ------------------------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------- |
| **Attio**                            | سحب + كتابة | يمكن أن يكون Attio مصدرًا للذاكرة ووجهة منظمة للكتابة. يحدد مخطط الحساب المتصل الكائنات والحقول القابلة للكتابة. |
| **HubSpot / Salesforce / Pipedrive** | سحب + كتابة | يمكن لسجلات CRM المشاركة في سير عمل كتابة مُعدّ بصورة منفصلة، وفقًا للمخطط والصلاحيات.                           |
| **Google Sheets / Airtable**         | سحب + كتابة | يمكن استخدام تعديلات الجداول أو الصفوف المدعومة في سير عمل كتابة مُعدّ بصورة منفصلة.                             |
| **Gmail**                            | سحب فقط     | يستطيع Conare مزامنة البريد المسموح، لكنه لا يعرض حاليًا إنشاء مسودات Gmail أو إرسالها.                          |
| **Slack**                            | سحب فقط     | يستطيع Conare مزامنة القنوات المحددة، لكنه لا يعرض حاليًا نشر الرسائل.                                           |
| **Notion / GitHub / Twenty CRM**     | سحب فقط     | تستورد موصلات Conare هذه البيانات إلى الذاكرة فقط حاليًا.                                                        |

لا تعني `push: true` أن كل إجراء لدى المزوّد متاح. فهي لا تتجاوز الصلاحيات، ولا تحدد الكائنات القابلة للكتابة، ولا تختار بين المسودة والإرسال، ولا تنفذ إجراءً بذاتها.

## بناء طبقة إجراءات

يجب أن يتحقق سير العمل الآمن من `capabilities.push`، ويحل مخطط الكتابة للحساب المتصل، وينتج خطة أو تجربة جافة، ويطلب موافقة صريحة للكتابات المؤثرة، ثم ينفذ باستخدام مفتاح لمنع التكرار مع الاحتفاظ بسجل تدقيق.

إلى أن تنشر Conare نقطة نهاية للتعديلات، استخدم الفهرس في الواجهات والتخطيط المدرك للإمكانات؛ ولا تعرض `push: true` كإجراء قابل للتنفيذ عبر API Conare.