إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يمكنك استخدام واجهة CCaaS_CreateProactiveDelivery برمجة التطبيقات لبدء مكالمات صوتية صادرة استباقية للعملاء من خلال خدمة التفاعل الاستباقي.
مهم
- إذا كانت المنظمة تستخدم واجهة
CCaaS_CreateProactiveDeliveryبرمجة التطبيقات لبدء مكالمة صوتية صادرة، فهي مسؤولة عن إدارة الموافقة، بما في ذلك التحديث اليدوي لقوائم "عدم الاتصال" لتحديد ساعات هادئة للتواصل مع العملاء. تأكد من استيفاء الشروط التالية:- يتم الحصول على الموافقة قبل التواصل مع العملاء.
- يتم التواصل مع العملاء خلال الساعات المسموح بها فقط.
المتطلبات المسبقه
- يجب أن يكون لديك وكيل القناة المتعددة أو دور مشرف القناة المتعددة لاستدعاء هذه الواجهة.
- يتم تكوين المشاركة الاستباقية. تعرف على المزيد في قسم تكوين المشاركة الاستباقية.
تفاصيل الطلب
-
الموقع:
https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveDelivery - الطريقة: POST
- الإصدار: 1.0
- عملية OData: العمل
- نوع OData: غير محدود
- طلب تفويض: مطلوب. يجب أن يحتوي على رمز حامل Microsoft Entra ID صالح للمستخدم الذي يقوم باستدعاء واجهة برمجة التطبيقات. يجب أن يتم إصدار هذا الرمز من نفس مستأجر Microsoft Entra ID الذي يصدر كنسخة خدمة العملاء.
رؤوس الطلبات
| رئيسي | النوع | الوصف |
|---|---|---|
| إصدار واجهة برمجة التطبيقات | السلسلة | إصدار واجهة برمجة تطبيقات CCaaS. |
| ProactiveEngagementConfigId | السلسلة | معرف تكوين التفاعل الاستباقي للاستخدام. كما يحدد نوع وضع الاتصال، ومسار العمل، والملف الخارجي للاستخدام. للحصول على هذا المعرف، قم بالخطوات التالية:
|
| RequestId | السلسلة | اختياري. النسبة إلى التمرير لتتبع الطلب من النظام المصدر. |
| الأولوية | السلسلة | اختياري. يحدد قيمة الأولوية للطلب. |
| جهات الاتصال | مصفوفة JSON لكائنات الاتصال | يحدد جهة اتصال واحدة أو أكثر (حتى 5) في هذا الطلب. يطلب رقم هاتف واحد على الأقل لكل جهة اتصال. |
| Windows | صفيف JSON من كائنات النافذة | يحدد الفترات الزمنية الصالحة التي يمكن فيها إجراء المكالمة الصادرة. إذا لم يتم توفيره، يتم تعيين النظام افتراضيا على نافذة مدتها 24 ساعة تبدأ على الفور (من الوقت الحالي حتى 24 ساعة بعد ذلك). |
كائن التلامس
| رئيسي | النوع | الوصف |
|---|---|---|
| معرف فريد | السلسلة | معرف فريد للجهة الاتصال. يمكن أن يكون معرف اتصال أو معرف خارجي. |
| الاسم الأول | السلسلة | الاسم الأول للجهة الاتصال. |
| اسم العائلة | السلسلة | اسم العائلة للجهة الاتصال. |
| رقم الهاتف المحمول | السلسلة | رقم الهاتف المحمول لجهة الاتصال. |
| رقم هاتف الأعمال | السلسلة | رقم هاتف العمل الخاص بجهة الاتصال. |
| رقم الهاتف المنزلي | السلسلة | رقم الهاتف المنزلي لجهة الاتصال. |
| البريد الإلكتروني | السلسلة | اختياري. عنوان البريد الإلكتروني لجهة الاتصال. |
postalcode |
السلسلة | اختياري. الرمز البريدي للجهة الاتصال. |
| state | السلسلة | اختياري. حالة الاتصال. |
country |
السلسلة | اختياري. الدولة/المنطقة التي تهدف فيها الاتصال. |
addressline |
السلسلة | اختياري. خط العنوان الخاص بجهة الاتصال. |
| city | السلسلة | اختياري. مدينة الاتصال. |
| timezone | السلسلة | اختياري. المنطقة الزمنية للاتصال. يجب أن تكون قيمة من قائمة Dynamics 365 المعتمدة. |
| الصفات المرجعية | كائن JSON لسلاسل القيمة الرئيسية | اختياري. المتغيرات التي يمكن الرجوع إليها داخل عامل Copilot تتدفق لتخصيص السلوك، أو تشغيل المنطق الشرطي، أو استرجاع معلومات مخصصة من سجلات Dataverse. |
| نوافذ | صفيف JSON من كائنات النافذة | اختياري. windows زمنية على مستوى الاتصال تتجاوز Windows الأعلى لهذا الجهة المعنية. |
ملحوظة
واحد على الأقل من mobilePhoneNumber، businessPhoneNumber، أو homePhoneNumber مطلوب لكل جهة اتصال.
كائن Windows
| رئيسي | النوع | الوصف |
|---|---|---|
| بدء | السلسلة | الطابع الزمني للبداية لهذه النافذة. يجب أن يتم تحديده بالتوقيت العالمي المنسق في yyyy-MM-ddTHH:mm:ss.fffZ التنسيق. |
| الانتهاء | السلسلة | الطابع الزمني للانتهاء لهذه النافذة. يجب أن يتم تحديده بالتوقيت العالمي المنسق في yyyy-MM-ddTHH:mm:ss.fffZ التنسيق. |
نموذج الطلب
{
"ApiVersion": "1.0",
"ProactiveEngagementConfigId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"RequestId": "e1f2a3b4-c5d6-7890-abcd-ef1234567890",
"Priority": "1",
"Contacts": "[{\"uniqueIdentifier\":\"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\"firstName\":\"John\",\"lastName\":\"Doe\",\"mobilePhoneNumber\":\"+15550100\",\"businessPhoneNumber\":\"+15550101\",\"homePhoneNumber\":\"+15550102\",\"email\":\"text@a.com\",\"postalcode\":\"25642\",\"state\":\"WA\",\"country\":\"USA\",\"addressline\":\"1234 227th PL SE\",\"city\":\"Seattle\",\"timezone\":\"(GMT-03:00) Brasilia\",\"inputAttributes\":{\"AppointmentTime\":\"10:00 AM\",\"CustomerNumber\":\"1234567\"},\"windows\":[{\"start\":\"2025-12-10T09:00:00Z\",\"end\":\"2025-12-10T17:00:00Z\"}]}]"
}
المعلومات ذات الصلة
استخدام واجهة برمجة تطبيقات CCaaS_CreateProactiveVoiceDelivery
استخدم واجهة برمجة التطبيقات CCaaS_CreateOperation
استخدام جداول المشاركة الاستباقية لإعداد التقارير