> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/technical-library-ar/khdmat-alaamal/zoom-contact-center/expert-insights/integrate-engagement-data.md).
# دمج بيانات التفاعل
### نظرة عامة
يُنشئ Zoom مركز الاتصال بيانات تفاعل قيّمة خلال كل تفاعل مع العميل، بما في ذلك تسجيلات المكالمات، والنصوص التفريغية، وملاحظات الوكلاء، والتصنيفات. واصل القراءة لتتعلم كيفية تخزين بيانات التفاعل في أنظمة خارجية (على سبيل المثال، CRM وأنظمة التسجيل الأخرى) لإنشاء رؤية موحدة للعميل، وتمكين تدريب فعّال للوكلاء، أو تلبية متطلبات الامتثال عند استخدام Zoom مركز الاتصال.
سنشرح طرق التكامل المختلفة لمساعدتك: اختر النهج الأفضل بناءً على كيفية عمل وكلائك بكفاءة أكبر.
تعتمد الطريقة الأفضل أساسًا على عامل رئيسي واحد: **التطبيق الذي يتعامل فيه الوكلاء مع تفاعلاتهم**. والخياران اللذان سنناقشهما هما:
1. الوكلاء الذين يستخدمون موصل ZCC CRM CTI الجاهز للاستخدام داخل CRM.
2. الوكلاء الذين يعملون في تطبيق Zoom Workplace، والذي يتطلب حلاً مخصصًا باستخدام واجهات برمجة التطبيقات ZCC وWebhooks.
***
### تكامل موصل CRM CTI الجاهز للاستخدام
هذه هي الطريقة الأكثر مباشرة. إذا كان وكلاؤك يستخدمون موصل ZCC CRM CTI، فيمكن مزامنة معظم بيانات التفاعل تلقائيًا بين منصة Zoom وCRM المناسب.
#### كيف يعمل
يُضمِّن موصل CTI واجهة وكيل ZCC مباشرةً داخل CRM. عند انتهاء التفاعل، تُحفَظ بيانات مثل التسجيلات والنصوص والملاحظات والتصنيفات تلقائيًا داخل Zoom وتُربط بالتسجيل ذي الصلة (على سبيل المثال، تذكرة أو جهة الاتصال) داخل CRM الخاص بك.
#### متطلبات الإعداد
الوظائف التي تتيح السماح بمزامنة البيانات بين Zoom وCRM تأتي «مضمنة»، لكنها تتطلب التمكين داخل بوابة المسؤول لـ ZCC.
أكمل الخطوات التالية:
{% stepper %}
{% step %}
**تمكين في بوابة المسؤول لـ ZCC**
سجّل الدخول إلى بوابة المسؤول الخاصة بـ Zoom بوصفك مسؤولًا وانتقل إلى إدارة مركز الاتصال > التكامل > التطبيقات.
اعثر على تكامل CRM المناسب وقم بتمكين الإعدادات المناسبة للسماح بتخزين البيانات في CRM الخاص بك.
{% endstep %}
{% step %}
**أذونات CRM**
راجع واتبع الـ [أدلة إعداد تكامل CRM](https://support.zoom.com/) للتحقق من أن مستخدم تكامل CRM لديك لديه أذونات الكتابة اللازمة لجميع الكائنات ذات الصلة.
{% endstep %}
{% endstepper %}
#### منصات CRM المدعومة
تتوفر هذه الوظيفة عبر موصل ZCC CRM CTI عندما يستخدم الوكلاء أنظمة CRM التالية:
* Salesforce
* Zendesk
* ServiceNow
* Microsoft دايناميكس
* HubSpot
مع موصلات CRM CTI، لا يلزم أي إعداد خاص، وسيحفظ التكامل بيانات التفاعل في CRM بشكل افتراضي.
***
### التكامل المخصص عبر واجهات برمجة التطبيقات
إذا كان وكلاؤك يستخدمون تطبيق Zoom Workplace الأصلي أو ZCC Smart Embed، فستحتاج إلى حل مخصص لنقل بيانات التفاعل. والطريقة الأساسية للقيام بذلك هي باستخدام واجهات برمجة تطبيقات Zoom لمركز الاتصال.
هناك نهجان رئيسيان للوصول إلى بيانات التفاعل عبر واجهة برمجة التطبيقات:
* **استطلاع:** استعلام بشكل دوري عن Zoom API لمعرفة ما إذا كانت بيانات مشاركة جديدة متاح.
* **خطافات الويب:** تلقَّ إشعارًا في الوقت الحقيقي من Zoom بمجرد أن يصبح النسخ جاهزًا.
هناك أيضًا نهج ثالث، **تكامل Flow Events**، والذي يعمل مع أنواع بيانات معينة.
#### استطلاع واجهة برمجة التطبيقات الخاصة بـ Zoom لمركز الاتصال
للاستعلام عن بيانات التفاعل، يجب عليك الاستعلام عن نقاط نهاية واجهة برمجة التطبيقات المناسبة في ZCC. من المهم ملاحظة أن أنواعًا مختلفة من البيانات تأتي من واجهات برمجة التطبيقات مختلفة، لذا ستحتاج على الأرجح إلى بناء منطق استطلاع لكل نقطة نهاية ذات صلة.
العديد من واجهات برمجة التطبيقات المتعلقة بالتفاعل ضمن Reports V2 (تحليلات CX) تدعم الآن التصفية بحسب وقت الانتهاء باستخدام `end_time_from` و `end_time_to`. فضّل هذه المعلمات عندما تكون متاحة حتى تسترجع مهام الاستطلاع التفاعلات بناءً على وقت انتهائها الفعلي. يساعد هذا على تقليل السجلات المفقودة لأن بيانات التفاعل الكاملة (بما في ذلك بيانات التقرير V2) يتم اعتمادها نهائيًا عند انتهاء التفاعل.
| للحصول على هذه البيانات... | استطلاع واجهة برمجة التطبيقات هذه... | استخدام هذا الحقل... | ملاحظات: |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --------------------------------------------------------- |
|
| `النسخ_url` | يتطلب تمكين النسخ لصندوق الوارد. |
{% hint style="danger" %}
**تحذير**
عناوين URL للتنزيل (`download_url`, `النسخ_url`, `playback_url`، وما إلى ذلك) التي توفرها واجهة برمجة التطبيقات الخاصة بـ Zoom هي **ليست** روابط عامة. وهي مصممة للوصول البرمجي وتتطلب المصادقة عبر واجهة برمجة التطبيقات (على سبيل المثال، الرمز المميز للوصول في ترويسة Authorization) لتنزيل الملف المرتبط.
وهذا يعني:
* لا يمكنك حفظ هذه الروابط مباشرةً في CRM لكي ينقر عليها مستخدم. عند نقر مستخدم على الرابط في متصفحه، لن تتم المصادقة عليه، وسيفشل التنزيل.
* الطريقة الصحيحة هي أن تستخدم خدمة الواجهة الخلفية لديك عنوان URL لجلب الملف. ثم يمكن لخدمتك تخزين الملف في نظامك الخاص (مثل Amazon S3 أو Azure Blob Storage أو تخزين الملفات في نظام CRM الخاص بك) وتوفير رابط آمن لمستخدميك من هناك.
{% endhint %}
{% hint style="warning" %}
**انتبه**
**تأخيرات المعالجة - تسجيلات الصوت والفيديو:**
هذه البيانات ليست متاحة فور انتهاء المكالمة. يجب معالجة الصوت ورفعه أولًا، وقد يستغرق ذلك عدة دقائق في المكالمات الطويلة. ولضمان عدم تفويت التسجيلات، عيّن `query_date_type` المعلمة إلى `recording_end_time` عند الاستطلاع الدوري لواجهة برمجة التطبيقات List recordings. يسترجع هذا البيانات استنادًا إلى وقت انتهاء المعالجة، وليس إلى وقت انتهاء المكالمة.
بالنسبة إلى مهام المطابقة المرتكزة على التفاعل في Reports V2 (تحليلات CX)، استخدم نوافذ زمنية متداخلة مع `end_time_from` و `end_time_to` لتوفير هامش أمان للمعالجة المتأخرة ومشكلات التسليم المؤقتة.
{% endhint %}
لمزيد من المعلومات حول واجهات برمجة التطبيقات الخاصة بـ Zoom مركز الاتصال، راجع [واجهات برمجة التطبيقات الخاصة بـ مركز الاتصال](https://developers.zoom.us/docs/api/contact-center/) الوثائق.
#### استخدم خطاف الويب للفعاليات في الوقت الفعلي
لنهج أكثر فورية قائم على فعالية، يمكنك الاشتراك في خطاف الويب الخاصة بـ ZCC. هذه هي الطريقة الأكثر كفاءة من أجل التكامل شبه الفوري.
**كيف يعمل**
1. اشترك في الأحداث المناسبة في سوق التطبيق لـ Zoom.
2. عندما تحدث فعالية، يرسل Zoom إشعار إلى عنوان URL الخاص بـ خطاف الويب لديك (أو إلى اتصال Websocket الخاص بك).
3. تحتوي حمولة فعالية على البيانات التي تحتاج إليها، إما مباشرةً أو كعنوان URL/معرّف من أجل مكالمة متابعة إلى واجهة برمجة التطبيقات.
**أحداث خطاف الويب الشائعة لبيانات التفاعل**
* **بيانات نهاية التفاعل جاهزة:** جهة الاتصال\_center.cx\_engagement\_end\_data\_ready (يشير إلى أن بيانات تقرير نهاية التفاعل V2 جاهزة للاسترجاع)
* **تسجيل الصوت/الفيديو:** مركز جهة الاتصال.التسجيل\_مكتمل (يوفر `download_url`)
* **نسخ الصوت/الفيديو:** مركز جهة الاتصال.التسجيل\_النسخ\_مكتمل (يوفر `النسخ_url`)
* **نسخ إرسال الرسائل:** مركز جهة الاتصال.التفاعل\_إرسال الرسائل\_النسخ\_مكتمل (يوفر `النسخ_url`)
* **ملاحظات:** مركز جهة الاتصال.التفاعل\_ملاحظة\_مضافة (يوفر `ملاحظة` الحقل مع بيانات الملاحظة)
* **التصرف:** مركز جهة الاتصال.التفاعل\_التصرف\_مضاف (يوفر `اسم التصرف` حقل يحتوي على بيانات التصرف)
**النمط الموصى به: بدء الاسترجاع عندما تصبح بيانات التفاعل جاهزة**
عندما تتلقى `جهة الاتصال_center.cx_engagement_end_data_ready`، اعتبره إشارة لك بأن بيانات تقرير نهاية التفاعل الإصدار V2 مكتملة لذلك التفاعل. عند تلك النقطة، استدعِ واجهة برمجة التطبيقات لسجل بيانات التفاعل التاريخي وأي واجهات برمجة تطبيقات أخرى ذات صلة لجمع مجموعة البيانات النهائية. في هذه الفعالية، استخدم `معرّف التفاعل` كمفتاح بحث، ثم استرجع جميع مواد التفاعل الكاملة من نقاط النهاية المطلوبة.
{% hint style="warning" %}
**انتبه**
* **انتبه إلى وجود فعاليات متعددة:** الـ `ملاحظة_مضافة` و `التصرف_مضاف` يمكن أن تنطلق الفعالية عدة مرات لتفاعل واحد (على سبيل المثال، إذا قام الموظف بحفظ عدة ملاحظات أو تمت إحالة مكالمة). ويجب أن يكون منطق تطبيقك قادرًا على التعامل مع ذلك.
* **أدرج التكرار الاحتياطي:** لا يكون تسليم الفعالية مضمونًا بنسبة 100% دائمًا (على سبيل المثال، قد تكون نقطة النهاية أو اتصال websocket لديك متوقفًا مؤقتًا).
* **استراتيجية النسخ الاحتياطي:** نوصي بتشغيل نص برمجي للمطابقة باستخدام واجهات برمجة التطبيقات الخاصة بالاستطلاع مع `end_time_from` و `end_time_to` نوافذ زمنية لالتقاط الفعاليات الفائتة وسد فجوات البيانات.
{% endhint %}
لمزيد من المعلومات حول فعاليات خطاف الويب/ويب سوكيت الخاصة بـ Zoom لمركز الاتصال، انظر [خطافات الويب الخاصة بمركز الاتصال](https://developers.zoom.us/docs/api/contact-center/events/) الوثائق.
#### تكامل فعاليات التدفق
بالنسبة إلى بعض أنواع البيانات، يمكنك دفع البيانات مباشرةً إلى نظام خارجي من محرر ZCC Flow باستخدام برنامج فعالية JavaScript.
**البيانات المدعومة والقيود:**
* **التصرف:** يمكن الوصول إليه على جميع أنواع قنوات التفاعل الواردة باستخدام `global_system.Engagement.التصرف` متغير.
* **النسخ:** متاح فقط لتفاعلات إرسال الرسائل الواردة (على سبيل المثال، دردشة الويب) باستخدام `global_system.Engagement.النسخ` متغير.
* **تدفقات متعددة:** عند العمل مع عدة تدفقات في تكوينك، خاصةً عندما يستخدم أحد التدفقات الـ `RouteTo` أداة للاتصال بتدفق آخر، من الضروري التأكد من أن نصوص الفعالية والمشغلات متطابقة وتم كوَّنها بشكل صحيح عبر جميع التدفقات.
هذه الطريقة هي الأقوى في تدفق إرسال الرسائل، حيث يمكنك دمج كلٍ من النسخ والتصرف في فعالية واحدة.
**خطوات التكوين**
اتبع هذه الخطوات لكي كوَّن تدفقك:
{% stepper %}
{% step %}
**إضافة نص برمجي للفعالية**
في تدفق ZCC الخاص بك (على سبيل المثال، تدفق دردشة ويب)، انقر على أداة البدء.
اعثر على نصوص الفعالية وقم بإضافة نص فعالية للفعاليات، مثل إغلاق التفاعل و/أو حفظ التصرف.
{% endstep %}
{% step %}
**إضافة JavaScript المخصص**
يسترجع المثال أدناه كلاً من التصرف والنسخ، ثم يرسلهما معًا إلى واجهة برمجة التطبيقات تابعة لجهة خارجية.
```javascript
async function main () {
try {
// احصل على كائن التصرف من متغيره
const التصرف_data = var_get()['global_system.Engagement.التصرف'];
// احصل على كائن النسخ الكامل
const النسخ_data = await req.get(var_get()['global_system.Engagement.النسخ']);
// جهّز حمولة بكل البيانات التي تريد إرسالها
const payload_to_send = {
التصرف: التصرف_data.data.result,
النسخ: النسخ_data.data.result.النسخ
};
// حدّد وجهة بياناتك
const external_api_url = '';
// أرسل البيانات المجمعة إلى نظامك الخارجي
const response = await req.post(واجهة برمجة التطبيقاتexternal_api_url, payload_to_send);
// سجّل الاستجابة من النظام الخارجي لاستكشاف الأخطاء وإصلاحها
log.debug("استجابة واجهة برمجة التطبيقات الخارجية: " + JSON.stringify(response.data));
} catch (error) {
log.debug("حدث خطأ في برنامج نصي لفعالية النسخ: " + error);
}
}
```
{% endstep %}
{% endstepper %}
***
### الملخص والتوصيات
اختر طريقة التكامل التي تتماشى بشكل أفضل مع سير عمل وكلائك ومواردك التقنية.
| إذا كان وكلاؤك يستخدمون... | فإن أفضل خيار لك هو... | اعتبارات رئيسية: |
| --------------------------------------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| الموصل ZCC CTI في CRM مدعوم | التكامل المدمج |
أسهل مسار
لا يتطلب أي كود
المزامنة لبيانات التفاعل مدمجة
|
| تطبيق Zoom Workplace أو Smart Embed | واجهة برمجة التطبيقات Webhooks بالإضافة إلى تسوية الاستطلاع المفلتر حسب وقت الانتهاء |
استخدم جهة الاتصال\_center.cx\_engagement\_end\_data\_ready كـمشغّل الاسترجاع الخاص بك
ثم سوِّه مع end\_time\_from/end\_time\_to نوافذ
يُحسّن الكفاءة مع تقليل حالات التفاعل المفقودة
|
| تدفق واردة لإرسال الرسائل (وتحتاج إلى دفع البيانات) | نصوص الفعالية في التدفق |
متخصص، لكنه قوي
يتطلب JavaScript
يعمل بأفضل شكل لإرسال محاضر إرسال الرسائل والتصنيفات
|
من خلال فهم هذه المسارات المختلفة، يمكنك بناء تكامل قوي وموثوق يمنحك رؤية كاملة لتفاعلات العملاء. ويساعدك الجمع بين الاسترجاع المُشغَّل بواسطة فعالية والمطابقة المفلترة حسب وقت الانتهاء على تقليل استدعاءات واجهة برمجة التطبيقات غير الضرورية مع تحسين الاكتمال.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://library.zoom.com/technical-library/technical-library-ar/khdmat-alaamal/zoom-contact-center/expert-insights/integrate-engagement-data.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.