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

# نظرة عامة

> ابنِ تكاملات مع واجهة GraphQL العامة لكرزون — رموز التطبيقات، وWebhooks، وMCP، وSDK، وMiniApps.

مرحباً بك في توثيق **GraphQL API** لكرزون — أدلة وساحة تجربة ومخطط لمطوّري تطبيقات الشركاء، ومهندسي التكامل، والفرق التي تربط وكلاء الذكاء وتحتاج وصولاً حياً بصلاحيات إلى بيانات مساحة العمل.

المبيعات والدعم والتسويق تعمل أصلاً على مساحة عمل واحدة في كرزون. يستفيد تكاملك من هذا التوحيد: نموذج رموز واحد، وقصة صلاحيات واحدة، وسجل عميل واحد عبر القنوات.

<Info>
  تبحث عن أدلة تشغيل يومية للمنتج؟ ابدأ من [الصفحة الرئيسية](/ar) أو [مركز المساعدة](/ar/help-center) — هذا القسم للمطوّرين.
</Info>

## اختر مسارك

<Columns cols={2}>
  <Card title="البداية السريعة" icon="rocket" href="/ar/developers/getting-started/quickstart">
    أول طلب GraphQL مصادق عليه خلال دقائق.
  </Card>

  <Card title="المصادقة" icon="key" href="/ar/developers/getting-started/authentication">
    التطبيقات والرموز وكيف تُصرَّح الطلبات.
  </Card>

  <Card title="GraphQL API" icon="brackets" href="/api-reference">
    مرجع المخطط — الاستعلامات والطفرات والأنواع.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/ar/developers/guides/webhooks">
    تفاعل مع أحداث المحادثات وجهات الاتصال والتطبيقات.
  </Card>

  <Card title="MCP" icon="bot" href="/ar/mcp-server">
    وصول عبر الأدوات لـ Cursor وClaude والوكلاء.
  </Card>

  <Card title="MiniApps" icon="puzzle" href="/ar/miniapps">
    تطبيقات Marketplace بصيغة JSON — ابنِ محلياً وقدّم للمراجعة.
  </Card>
</Columns>

## متى تستخدم ماذا

| الحاجة                     | فضّل              | لماذا                                        |
| -------------------------- | ----------------- | -------------------------------------------- |
| قراءة/كتابة عند الطلب      | **GraphQL**       | مخطط كامل، ساحة تجربة، استعلامات دقيقة       |
| التفاعل عند حدوث شيء       | **Webhooks**      | دفع الأحداث لخادمك مع التوقيعات              |
| عميل ذكاء يحتاج أدوات      | **MCP**           | أدوات بصلاحيات على نفس بيانات مساحة العمل    |
| واجهة داخل الوارد          | **Dashboard SDK** | تطبيقات iframe تستدعي `executeMiniAppAction` |
| موصل قابل لإعادة الاستخدام | **MiniApps**      | تعريف JSON للسوق + مراجعة                    |

## قائمة أمان سريعة

* خزّن رموز التطبيقات على الخادم — لا في JavaScript للمتصفح أو المستودعات العامة
* تحقق من توقيعات Webhooks (`x-karzoun-signature-256`) قبل الوثوق بالمحتوى
* امنح كل تطبيق أقل صلاحيات يحتاجها التكامل
* بدّل الرموز عند مغادرة أشخاص أو إيقاف تكاملات

## جرّب

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST 'https://YOUR_SUBDOMAIN.api.karzoun.chat/graphql' \
  -H 'Content-Type: application/json' \
  -H 'x-app-token: YOUR_APP_TOKEN' \
  -d '{"query":"query { tags(page: 1, perPage: 3) { data { name } } }"}'
```

<Tip>
  تفضّل محرراً مرئياً؟ افتح [ساحة GraphQL](/ar/api-reference/playground).
</Tip>

## ما الذي يصل إليه تكاملك

| المجال                | أمثلة                                                                  |
| --------------------- | ---------------------------------------------------------------------- |
| البريد الوارد المشترك | محادثات متعددة القنوات — واتساب، البريد، الدردشة، Messenger، Instagram |
| CRM والشرائح          | العملاء، الشركات، الوسوم، الحقول المخصصة، الشرائح الديناميكية          |
| الأتمتة               | المحفّزات والشروط والإجراءات عبر الوارد والقنوات                       |
| الذكاء                | Copilot ووكلاء مبنيون على سياق CRM والمحادثة                           |
| التسويق               | الحملات والقوالب وتحليلات البث                                         |
| العمليات              | المهام، الطلبات، الاجتماعات، الملفات، دردشة الفريق                     |

<Note>
  تفاصيل الحقول في [مرجع GraphQL](/api-reference). أدلة المنتج لغير التقنيين في [مركز المساعدة](/ar/help-center).
</Note>


## Related topics

- [نظرة عامة](/ar/developers/index.md)
- [ملف جهة الاتصال](/ar/help-center/guides/contacts/profile.md)
- [اهلا بك](/ar/help-center/guides/getting-started/doc-1861353.md)
- [إعداد الشريك](/ar/partners/onboarding.md)