> 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/agentless-dialer-with-custom-fields.md).

# طالب اتصال آلي بدون وكيل مع حقول مخصصة

من تأليف جاستن شتاينبرغ

## نظرة عامة

### ما هو برنامج الاتصال دون وكيل؟

مركز الاتصال من Zoom **برنامج الاتصال دون وكيل** هو نوع من برامج الاتصال يجري مكالمات صادرة من دون اشتراط تسجيل دخول الوكلاء أو توفرهم. بخلاف برامج الاتصال **المعاينة** و **التدريجي** التي يقودها الوكلاء، فإن **برنامج الاتصال دون وكيل** يعمل بصورة مستقلة، وينفذ الحملات عبر طلب أرقام جهات الاتصال من قائمة وتقديم تجارب آلية من خلال **تدفق** أو رسالة مسجلة. **برنامج الاتصال دون وكيل** يفيد في الاتصالات الصادرة التي لا تتطلب وكيلاً مباشراً لكل مكالمة. تشمل حالات الاستخدام الشائعة:

* رسائل التذكير بالمواعيد
* إشعارات استحقاق السداد/دفع
* تحديثات المجتمع
* دعوات الفعاليات
* رسائل التذكير بالفحوصات الصحية

مع **الحقول المخصصة** الدعم، يمكن تخصيص هذه الرسائل لكل جهة اتصال.

{% hint style="success" %}
**مثال**

بدلاً من عبارة عامة مثل "لديك موعد قادم"، يمكن لبرنامج الاتصال أن يقول: "موعدك مجدول يوم الجمعة الساعة 3:00 مساءً في الموقع الخاص بنا في الشارع الرئيسي."
{% endhint %}

{% hint style="info" %}
يمكن أيضاً منح جهات الاتصال خيار التواصل مع وكيل مباشر أثناء المكالمة عند الحاجة.
{% endhint %}

### الترخيص

الـ **برنامج الاتصال دون وكيل** يتطلب ترخيص مكون إضافي في مركز الاتصال من Zoom. يلزم ترخيص مستخدم واحد على الأقل لمركز الاتصال من Zoom (Essentials أو أعلى) للمسؤول الذي يقوم بتهيئة إدارة مركز الاتصال. يترتب على برنامج الاتصال دون وكيل نفسه رسم استخدام لكل دقيقة. يرجى الاتصال بفريق المبيعات في Zoom للحصول على معلومات إضافية عن الأسعار.

عندما تُصعَّد مكالمة لبرنامج الاتصال دون وكيل إلى وكيل بشري من خلال التدفق، يمكن للوكيل المستلم الحصول على أي نوع من تراخيص مركز الاتصال من Zoom (Essentials أو Premium أو Elite). لا يُشترط أن يكون لدى الوكيل ترخيص Premium+ لمعالجة مكالمات برنامج الاتصال دون وكيل المُصعَّدة.

### المفاهيم الأساسية

يتضمن نشر برنامج اتصال دون وكيل مخصص أربعة مكونات رئيسية:

الـ **الحمل**ة هي الكائن الأعلى مستوى الذي يحدد سلوك برنامج الاتصال. وهي تحدد نوع برنامج الاتصال (دون وكيل)، وقائمة جهات الاتصال المطلوب طلب أرقامها، ومعرّف المتصل، وساعات العمل، وحدود المكالمات المتزامنة، **اكتشاف جهاز الرد الآلي** (AMD)، وما يحدث عند اكتشاف جهة اتصال مباشرة (تشغيل رسالة أو التوجيه إلى تدفق). تحتوي الحملة أيضاً على إعداد "قيد التشغيل دائماً" الذي يتحكم في ما إذا كانت الحملة تعمل باستمرار أو تُنفذ مرة واحدة.

الـ **قائمة جهات الاتصال** تحتوي على أرقام الهاتف والبيانات المرتبطة بالأشخاص الذين ستطلب الحملة أرقامهم. يتضمن كل إدخال في القائمة حقولاً معيارية (الاسم الأول واسم العائلة ورقم الهاتف وما إلى ذلك)، ويمكن أن يتضمن حقولاً مخصصة ببيانات إضافية. يمكن إقران قائمة جهات اتصال واحدة بحملة واحدة أو أكثر.

**الحقول المخصصة** توسّع سجل قائمة جهات الاتصال المعياري بأعمدة بيانات يحددها مستخدم. لكل حقل مخصص اسم ونوع بيانات (مثل النص أو التاريخ/الوقت) وخيار للتحكم في ما إذا كانت القيمة مرئية للوكلاء. تسمح الحقول المخصصة للبيانات الخاصة بالحملة — مثل تواريخ المواعيد أو أرقام الحساب أو تفاصيل الموقع — بالانتقال مع كل جهة اتصال والإشارة إليها ديناميكياً في التدفق. يمكن ملء القيم يدوياً أو عبر استيراد/تصدير CSV أو عبر واجهة برمجة التطبيقات لمركز الاتصال من Zoom.

الـ **تدفق** هو منطق معالجة المكالمات الذي يُنفَّذ عندما ترد جهة اتصال تم طلب رقمها (أو عندما يكتشف AMD جهة اتصال مباشرة). تستخدم التدفقات الخاصة ببرنامج الاتصال دون وكيل منشئ التدفق ومجموعة عناصر واجهة المستخدم نفسها المستخدمة في تدفقات الصوت الواردة المعيارية. ضمن تدفق، يمكنك تشغيل رسائل مخصصة باستخدام حقول قائمة جهات الاتصال، وجمع إدخال DTMF، وإجراء استدعاءات واجهة برمجة التطبيقات، والتوجيه إلى وكيل صوت ZVA، أو التصعيد إلى قائمة انتظار وكيل بشري. يُعد التصعيد إلى وكيل مباشر قدرة معيارية لتدفق مركز الاتصال من Zoom ويمكن تضمينه في أي تدفق لبرنامج الاتصال دون وكيل.

{% hint style="info" %}
للاطلاع على مقدمة عن التدفقات، راجع [الورقة الزرقاء لتجربة العملاء في Zoom](/technical-library/technical-library-ar/khdmat-alaamal/zoom-contact-center/zoom-customer-experience/zoom-contact-center-components/flows.md).
{% endhint %}

## التدفقات مع دعم الحقول المخصصة

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

يوفر منشئ التدفق واجهة مستخدم لإدراج متغير تتيح لك استعراض صيغة المتغير الصحيحة وإدراجها. تتوفر مساحتا أسماء للمتغيرات في التدفقات:

* **حقول قائمة جهات الاتصال**: البيانات من قائمة جهات اتصال الحملة، بما في ذلك الحقول المعيارية (مثل، `contactList.standardField.firstName`) والحقول المخصصة (مثل، `contactList.customField.appointmentTime`). هذه هي المصادر الأكثر موثوقية للبيانات الخاصة بالحملة.
* **حقول دفتر العناوين**: البيانات من دفتر عناوين مركز الاتصال من Zoom، بما في ذلك الحقول المعيارية والمخصصة. لاحظ أنه لا يوجد ضمان بأن الرقم المطلوب موجود في دفتر العناوين، لذا تُفضَّل حقول قائمة جهات الاتصال لبيانات الحملة.

{% hint style="success" %}
**مثال**

"مرحباً {{contactList.standardField.firstName}} {{contactList.standardField.lastName}}، تتصل بك شركة Example Corp لتذكيرك بموعد. موعدك مجدول في {{contactList.customField.appointmentTime}} في موقعنا بـ {{contactList.customField.appointmentLocation}}. للتأكيد، اضغط 1. للإلغاء، اضغط 2. للتحدث مع وكيل، اضغط 3."
{% endhint %}

### الحقول المخصصة واكتشاف جهاز الرد الآلي (AMD)

تتوفر الحقول المخصصة في التدفق بغض النظر عما إذا كان AMD ممكّناً. عند إيقاف AMD، تُوجَّه جميع المكالمات المتصلة إلى التدفق. عند تشغيل AMD، تُوجَّه المكالمات التي يتم فيها اكتشاف جهة اتصال مباشرة إلى التدفق. في كلتا الحالتين، يمكن الوصول بالكامل إلى الحقول المخصصة داخل التدفق.

{% hint style="info" %}
عندما يكتشف AMD ‏(اكتشاف جهاز الرد الآلي) بريداً صوتياً، يشغّل النظام تلقائياً رسالة مسجلة مسبقاً من مكتبة الأصول بدلاً من توجيه المكالمة إلى تدفق. بسبب هذا القيد، لا يمكن استخدام الحقول المخصصة في رسائل البريد الصوتي. سيضيف إصدار مستقبلي دعماً لتوجيه مكالمات البريد الصوتي التي يكتشفها AMD إلى تدفقات مركز الاتصال من Zoom، ما سيتيح رسائل بريد صوتي مخصصة بمحتوى ديناميكي لحملات برنامج الاتصال دون وكيل.
{% endhint %}

## الإعداد والتهيئة الأوليان

يوضح هذا القسم خطوات تهيئة حملة مخصصة لبرنامج الاتصال دون وكيل.

### الخطوة 1: إنشاء حقول مخصصة

1. في [**مركز المسؤول**](https://zoom.com/account)، انتقل إلى **إدارة تجربة العملاء** → **مركز الاتصال** → [**إدارة الحملات**](https://zoom.com/cci/index/admin#/admin-campaign-management).
2. انتقل إلى **قائمة جهات الاتصال** القسم.
3. يحدد **الحقول المخصصة**.
4. انقر **إضافة حقل مخصص**.
5. أدخل اسماً للحقل المخصص (مثل، `appointmentTime`, `appointmentLocation`).
6. يحدد نوع البيانات (مثل النص أو التاريخ/الوقت).
7. اختيارياً، كوَّن ما إذا كان ينبغي عرض قيمة الحقل لوكلاء مركز الاتصال من Zoom.
8. كرّر ذلك لكل حقل مخصص مطلوب.

<div align="center" data-with-frame="true"><figure><img src="https://3637835738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FxVAAK2ILQ3Zw2xFVa9me%2Fimage.png?alt=media&amp;token=da975e5c-8013-4c56-9d20-82417ce993dd" alt=""><figcaption></figcaption></figure></div>

### الخطوة 2: إنشاء تدفق مع مراجع حقول قائمة جهات الاتصال

1. في [**مركز المسؤول**](https://zoom.com/account)، انتقل إلى **إدارة تجربة العملاء** → **مركز الاتصال** → [**التدفقات**](https://zoom.com/cci/index/admin#/admin-studios).
2. أنشئ تدفقاً صوتياً جديداً لـ **برنامج الاتصال دون وكيل** الحملة.
3. إضافة عناصر واجهة المستخدم حسب الحاجة (إرسال الوسائط، جمع الإدخال، الشرط، البرنامج النصي، التوجيه إلى، وما إلى ذلك).
4. في أي عنصر واجهة مستخدم يدعم إدراج النص أو المتغيرات، استخدم **إدراج متغير** الزر لاستعراض وإدراج الحقول المعيارية والحقول المخصصة لقائمة جهات الاتصال.
   * تتبع الحقول المعيارية لقائمة جهات الاتصال التنسيق التالي: `{{contactList.standardField.fieldName}}`
   * تتبع الحقول المخصصة لقائمة جهات الاتصال التنسيق التالي: `{{contactList.customField.fieldName}}`

<div align="center" data-with-frame="true"><figure><img src="https://3637835738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FPfTu9FDENLugjdbiMmLz%2Fimage.png?alt=media&amp;token=25749908-c6a0-4caf-bc82-f8c25103278d" alt=""><figcaption></figcaption></figure></div>

#### نمط تصميم التدفق: التصعيد إلى وكيل بشري

لمنح جهة الاتصال التي تم طلب رقمها خيار التحدث مع وكيل مباشر، استخدم **جمع الإدخال** عنصر واجهة مستخدم لالتقاط ضغط مفتاح DTMF (مثل "اضغط 3 للتحدث مع وكيل") وتوجيه المكالمة إلى قائمة انتظار عبر **التوجيه إلى** الأداة.

يوصى بتعيين متغير قبل وصول المكالمة إلى قائمة الانتظار لكي يتمكن الوكيل من تحديد أن المكالمة نشأت من حملة برنامج اتصال دون وكيل. هذا مهم لأن قائمة الانتظار قد تكون مختلطة — فقد يتلقى الوكلاء في قائمة الانتظار تلك أيضاً مكالمات واردة معيارية، ولن تكون لديهم طريقة أخرى لتمييز مصدر المكالمة.

للقيام بذلك، استخدم **تعيين متغير** عنصر واجهة مستخدم لتخزين قيمة وصفية (مثلاً، عيّن متغيراً مخصصاً `agentlessCampaign` إلى `"برنامج اتصال لتذكير المواعيد"`) قبل **التوجيه إلى** عنصر واجهة المستخدم. بعد ذلك، في [**مركز المسؤول**](https://zoom.com/account) → **إدارة تجربة العملاء** → **مركز الاتصال** → [**التفضيلات**](https://zoom.com/cci/index/admin#/admin-preferences)، كوَّن عرض ذلك المتغير للوكلاء. عندما يتلقى الوكيل المكالمة، سيرى قيمة المتغير على شاشة الإشعار الوارد، مما يوفر سياقاً حول سبب إجراء المكالمة. يمكن إضافة متغيرات عامة إضافية لعرض معلومات إضافية للوكيل عند التصعيد.

يمكن للوكلاء الذين يتلقون مكالمات برنامج الاتصال دون وكيل المُصعَّدة الحصول على أي فئة ترخيص لمركز الاتصال من Zoom ‏(Essentials أو Premium أو Elite).

### الخطوة 3: إنشاء قائمة جهات اتصال

1. في [**مركز المسؤول**](https://zoom.com/account)، انتقل إلى **إدارة تجربة العملاء** → **مركز الاتصال** → **إدارة الحملات** → [**قوائم جهات الاتصال**](https://zoom.com/cci/index/admin#/admin-campaign-management/contacts).
2. أنشئ قائمة جهات اتصال جديدة أو يحدد قائمة موجودة.
3. إضافة جهات الاتصال يدوياً أو عبر استيراد CSV أو عبر واجهة برمجة التطبيقات لمركز الاتصال من Zoom.
4. عند إضافة جهات الاتصال، املأ الحقول المعيارية (الاسم الأول واسم العائلة ورقم الهاتف) وأي حقول مخصصة حددتها.

<div data-with-frame="true"><figure><img src="https://3637835738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2F7ANzeY2NUs5wgYfdvnmV%2Fimage.png?alt=media&amp;token=cb96a122-38f3-463f-a8a7-93481ec39ec2" alt="" width="458"><figcaption></figcaption></figure></div>

### الخطوة 4: إنشاء الحملة وتهيئتها

1. في [**مركز المسؤول**](https://zoom.com/account)، انتقل إلى **إدارة تجربة العملاء** → **مركز الاتصال** → [**إدارة الحملات**](https://zoom.com/cci/index/admin#/admin-campaign-management).
2. انقر **إضافة حملة** وحدد **برنامج الاتصال دون وكيل.**

<div data-with-frame="true"><figure><img src="https://3637835738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FFpmz6warP27GyrGizJx4%2Fimage.png?alt=media&amp;token=932efa05-9a48-4aba-a10d-afda68c24411" alt=""><figcaption></figcaption></figure></div>

3. سمِّ الحملة وكوَّن الإعدادات التالية:
   * **قائمة جهات الاتصال**: حدد قائمة جهات الاتصال التي أُنشئت في [الخطوة 3](#step-3-create-a-contact-list).
   * **معرّف المتصل**: حدد رقم معرّف المتصل الصادرة.
   * **الحد الأقصى للمكالمات المتزامنة**: عيّن قيمة بين 1 و15.
   * **ساعات العمل**: كوَّن نافذة الطلب المسموح بها.
   * **قيد التشغيل دائماً**: عيّنه إلى صحيح إذا كانت جهات الاتصال ستُضاف باستمرار، أو خطأ لتشغيل الحملة لمرة واحدة.
   * **اكتشاف جهاز الرد الآلي (AMD)**: تمكين أو تعطيل حسب الحاجة. إذا كان ممكّناً، كوَّن إجراء البريد الصوتي (قطع الاتصال أو تشغيل رسالة من مكتبة الأصول).
   * **تم اكتشاف جهة اتصال مباشرة**: حدد **الاتصال بالتدفق** واختر التدفق الذي أُنشئ في [الخطوة 2](#step-2-create-a-flow-with-contact-list-field-references).

<div data-with-frame="true"><figure><img src="https://3637835738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2F2aa0uhZbDXOB7EybcqpG%2Fimage.png?alt=media&amp;token=09e41bc1-3966-4d75-a6e8-e6cc6204d572" alt=""><figcaption></figcaption></figure></div>

## إدارة قائمة جهات الاتصال

يمكن إضافة جهات الاتصال إلى قائمة جهات الاتصال عبر الإدخال اليدوي في بوابة المسؤول، أو استيراد CSV، أو واجهة برمجة التطبيقات لمركز الاتصال من Zoom. تدعم الطرق الثلاث جميعها الحقول المعيارية والمخصصة.

### إضافة جهات الاتصال عبر استيراد/تصدير CSV

لاستيراد جهات اتصال تحتوي على حقول مخصصة عبر CSV، من المفيد أولاً إضافة جهة اتصال واحدة يدوياً مع ملء جميع الحقول المخصصة المطلوبة، ثم تصدير القائمة. سيحتوي ملف CSV المُصدَّر على رؤوس الأعمدة الصحيحة للحقول المعيارية والمخصصة على السواء، والتي يمكنك استخدامها قالباً لعمليات الاستيراد المجمعة.

### إضافة جهات الاتصال عبر واجهة برمجة التطبيقات

تدعم واجهة برمجة التطبيقات لمركز الاتصال من Zoom إضافة إدخالات قائمة جهات الاتصال مع قيم الحقول المخصصة برمجياً. يفيد ذلك في عمليات التكامل التي تُدار فيها بيانات جهة الاتصال في نظام خارجي (مثل نظام CRM أو منصة جدولة أو EHR) ويجب دفعها تلقائياً إلى قائمة جهات الاتصال.

لمزيد من المعلومات، يرجى الاطلاع على [وثائق مرجع واجهة برمجة التطبيقات](https://developers.zoom.us/docs/api/contact-center/#tag/campaigns/post/contact_center/outbound_campaign/contact_lists/{contactListId}/contacts).

### التوقيت: متى تُضاف جهات الاتصال

يعتمد توقيت إضافة جهات الاتصال على إعداد "قيد التشغيل دائماً" للحملة:

* **قيد التشغيل دائماً** = **صحيح**: يمكن إضافة جهات الاتصال إلى قائمة جهات الاتصال في أي وقت — قبل بدء الحملة أو أثنائه أو بعده. تعمل الحملة باستمرار وستلتقط جهات الاتصال المضافة حديثاً عند تحميلها. يُعد هذا الوضع مثالياً لحالات الاستخدام المستمرة، مثل رسائل التذكير بالمواعيد المتجددة، حيث تُنشأ جهات اتصال جديدة على مدار اليوم.
* **قيد التشغيل دائماً** = **خطأ**: ينبغي تحميل جهات الاتصال في قائمة جهات الاتصال قبل بدء الحملة. بمجرد انتهاء الحملة من طلب أرقام جميع جهات الاتصال في القائمة، تنتقل إلى حالة "منتهية". لن يتم طلب أرقام جهات الاتصال التي تُضاف بعد انتهاء الحملة ما لم تتم إعادة تشغيل الحملة. يناسب هذا الوضع الحملات بأسلوب الدفعات، مثل إشعارات الفعاليات لمرة واحدة أو رسائل التذكير بالسداد/دفع.

### إزالة جهات الاتصال من الحملة

قد تحتاج إلى إزالة جهة اتصال من الحملة لأسباب مختلفة. على سبيل المثال، قد يتواصل معك عميل قبل أن تتمكن من الاتصال به. لإزالة جهة اتصال، استخدم [واجهة برمجة التطبيقات لإزالة جهة اتصال من قائمة جهات الاتصال الخاصة بالحملة](https://developers.zoom.us/docs/api/contact-center/#tag/campaigns/delete/contact_center/outbound_campaign/contact_lists/{contactListId}/contacts/{contactId}).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/technical-library-ar/khdmat-alaamal/zoom-contact-center/expert-insights/agentless-dialer-with-custom-fields.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.