بناء تطبيق مركز الاتصال Zoom

# /build-zoom-contact-center-app

مرجع خلفي للتكاملات في Zoom Contact Center عبر تطبيقات سطح المكتب والويب والهاتف المحمول الأصلي.

إرشادات التنفيذ لـ Zoom Contact Center عبر: - تطبيقات Contact Center في عميل Zoom (مسار Zoom Apps SDK) - قنوات الويب المدمجة (الدردشة/الفيديو/الحملات) - أجهزة SDK للهاتف المحمول الأصلي (Android/iOS)

المستندات الرسمية: - https://developers.zoom.us/docs/contact-center/ - https://developers.zoom.us/docs/contact-center/web/sdk-reference/ - https://marketplacefront.zoom.us/sdk/contact/android/index.html - https://marketplacefront.zoom.us/sdk/contact/ios/index.html

## حاجز التوجيه

- إذا كان المستخدم ينشئ تطبيقا داخل عميل Zoom Contact Center على سطح المكتب، ابق على مسار Zoom Apps SDK واستخدم هذه المهارة بالإضافة إلى `zoom-apps-sdk`. - إذا كان المستخدم يدمج أدوات الدردشة/الفيديو على موقع ويب، وجه إلى [web/SKILL.md](web/SKILL.md). - إذا كان المستخدم يدمج ملفات SDK الأصلية لـ Android أو iOS، وجه إلى [android/SKILL.md](android/SKILL.md) أو [ios/SKILL.md](ios/SKILL.md). - إذا كان المستخدم يحتاج إلى واجهات برمجية للتحكم في المكالمات أو إدارة الطوابير في Contact Center، اربط مع [../rest-api/SKILL.md](../rest-api/SKILL.md).

## الروابط السريعة

ابدأ من هنا: 1. [concepts/architecture-and-lifecycle.md](concepts/architecture-and-lifecycle.md) 2. [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md) 3. [references/forum-top-questions.md](references/forum-top-questions.md) 4. [references/versioning-and-compatibility.md](references/versioning-and-compatibility.md) 5. [references/samples-validation.md](references/samples-validation.md) 6. [references/environment-variables.md](references/environment-variables.md) 7. [troubleshooting/common-drift-and-breaks.md](troubleshooting/common-drift-and-breaks.md) 8. [RUNBOOK.md](RUNBOOK.md)

مهارات المنصة: - [android/SKILL.md](android/SKILL.md) - [ios/SKILL.md](ios/SKILL.md) - [web/SKILL.md](web/SKILL.md)

## هيكل التوثيق

``` contact-center/ ├── SKILL.md ├── RUNBOOK.md ├── concepts/ │ └── architecture-and-lifecycle.md ├── scenarios/ │ └── high-level-scenarios.md ├── references/ │ ├── versioning-and-compatibility.md │ ├── samples-validation.md │ └── environment-variables.md ├── troubleshooting/ │ └── common-drift-and-breaks.md ├── android/ │ ├── SKILL.md │ ├── concepts/sdk-lifecycle.md │ ├── examples/service-patterns.md │ ├── references/android-reference-map.md │ └── troubleshooting/common-issues.md ├── ios/ │ ├── SKILL.md │ ├── concepts/sdk-lifecycle.md │ ├── examples/service-patterns.md │ ├── references/ios-reference-map.md │ └── troubleshooting/common-issues.md └── web/ ├── SKILL.md ├── concepts/lifecycle-and-events.md ├── examples/app-context-and-state.md ├── references/web-reference-map.md └── troubleshooting/common-issues.md ```

## نمط دورة الحياة الشائع

1. هيئ سياق المنصة في وقت مبكر. 2. بناء عنصر قناة (`entryId` للدردشة/الفيديو/ZVA، `apiKey` لتدفقات رد الاتصال المجدول والحملات). 3. الحصول على مثيل الخدمة/العميل. 4. تسجيل المستمعين/الوكلاء قبل تفاعل المستخدم. 5. بدء التدفق (`fetchUI`، `startVideo`، أو مسار فتح/عرض web SDK). 6. التعامل مع تغييرات حالة المشاركة (`start`، `hold`، `resume`، `end`) وتبديل السياق. 7. إنهاء التدفق وتحرير الموارد (`endChat`/`endVideo`، `logout/logoff`، uninitialize/release).

## السيناريوهات عالية المستوى

- تطبيق لوحة جانبية للوكيل يخزن الملاحظات لكل `engagementId` ويبقى سليما عند تبديل السياق. - حملات الدردشة/الفيديو المطلقة على الويب من خلال علامات الويب. - تطبيق هاتف محمول أصلي للعميل للدردشة/الفيديو/رد الاتصال المجدول. - اختيار القنة من خلال الحملة (دردشة، ZVA، فيديو، رد اتصال مجدول). - تدفق إعادة الاتصال للمكالمات المرئية المفقودة على الهاتف المحمول. - قفل Smart Embed CRM softphone مع عقود حدث postMessage.

انظر [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md) للتفاصيل.

## الربط

- المصادقة وهوية التطبيق داخل العميل: [../zoom-apps-sdk/SKILL.md](../zoom-apps-sdk/SKILL.md) و [../oauth/SKILL.md](../oauth/SKILL.md) - سير عمل Zoom Contact Center REST: [../rest-api/SKILL.md](../rest-api/SKILL.md) - Cobrowse على قنوات الصوت/الدردشة على الويب: [../cobrowse-sdk/SKILL.md](../cobrowse-sdk/SKILL.md)

## متغيرات البيئة

- انظر [references/environment-variables.md](references/environment-variables.md) للحصول على مفاتيح `.env` الموحدة وأين يمكن العثور على كل قيمة.