إثراء مسودات البريد الإلكتروني باستخدام ارتباطات الملفات من تطبيقك (إصدار أولي)
مهم
- هذه ميزة معاينة جاهزة للإنتاج.
- تخضع الإصدارات الأولية الجاهزة للإنتاج لشروط الاستخدام التكميلية..
[هذا المقال عبارة عن وثائق نسخة مسبقة وهو عرضة للتغيير.]
عندما تستخدم Copilot للمبيعات لصياغة مسودة رسالة بريد إلكتروني، فإنه يأخذ في الاعتبار هدف البريد الإلكتروني ويستخدم معلومات CRM من Salesforce أو Dynamics 365 لإنشاء المسودة. يمكنك توسيع إمكانية كتابة مسودة البريد الإلكتروني التي يوفرها برنامج Copilot للمبيعات بواسطة الملفات الموصى بها من تطبيقك الخاص.
إشعار
هذه الميزة مدعومة فقط لمسودات البريد الإلكتروني التي يتم إنشاؤها باستخدام الجزء الجانبي من Copilot للمبيعات في Outlook.
وصف واجهة برمجة التطبيقات
يجب عليك إضافة وصف واجهة برمجة التطبيقات التالي إلى الإجراء. وبهذه الطريقة، يمكن ل Copilot للمبيعات تحديد واجهة برمجة التطبيقات الصحيحة التي يجب استدعاؤها لإثراء الإمكانية.
يؤدي هذا الإجراء إلى الحصول على الملفات ذات الصلة بمحادثة البريد الإلكتروني، والتي ستظهر في مسودات البريد الإلكتروني C4S في Outlook. يعزز الإجراء المهارات الحالية لـ copilot للمبيعات.
عملية API
يستخدم API هذا نوع العملية: POST
حمولة الإدخال
تذهب هذه الحمولة كنص طلب لطلب API.
| الاسم | نوع البيانات | مطلوبة | التفاصيل | وصف لإضافته في الإجراء |
|---|---|---|---|---|
| resourceData | الكائن | نعم | بيانات المورد التي سيتم استخدامها لإحضار المحتوى المقترح. بالنسبة إلى بنية البيانات، انتقل إلى نموذج بيانات البريد الإلكتروني لقابلية التوسعة. | يحدد هذا الإدخال محتوى البريد الإلكتروني وهو عبارة عن مجموعة من سلسلة رسائل البريد الإلكتروني والموضوع وتفاصيل أخرى. |
| resourceType | سلسلة | نعم | نوع المورد الذي يتم إحضار اقتراحات المحتوى له. على سبيل المثال، "email-thread" أو "teams-chat". | يحدد هذا الإدخال نوع المورد الذي تمت مشاركته لإحضار ارتباطات الملفات المقترحة، وهي في هذه الحالة "email-thread". |
| recordType | سلسلة | لا. | نوع سجل CRM مثل الحساب أو الفرصة. | يحدد هذا الإدخال نوع السجل CRM، المرتبطة بسلسلة رسائل البريد الإلكتروني. |
| recordId | سلسلة | لا. | المعرف الفريد لسجل CRM المراد استخدامه للمحتويات المقترحة. | يوفر هذا الإدخال المعرف الفريد لسجل CRM المرتبط بسلسلة رسائل البريد الإلكتروني. |
| crmType | سلسلة | لا. | نوع نظام CRM، إذا كان متصلاً. والقيم الصالحة هي Salesforce و Dynamics 365. | يشير هذا الإدخال إلى نوع CRM الذي يوجد فيه السجل المتعلق بسلسلة رسائل البريد الإلكتروني. |
| crmOrgUrl | سلسلة | لا. | عنوان URL لمؤسسة CRM. | يشير هذا الإدخال إلى عنوان URL الخاص ببيئة CRM التي يوجد فيها السجل المرتبط بسلسلة رسائل البريد الإلكتروني. |
| inputPrompt | سلسلة | لا. | المطالبة المقترحة المستخدمة حاليًا التي قدمها المستخدم لإنشاء مسودة البريد الإلكتروني. على سبيل المثال ، "الرد على مخاوف" أو "تقديم اقتراح". | يشير هذا الإدخال إلى المطالبة التي قدمها المستخدم أثناء صياغة مسودة رسالة بريد إلكتروني. |
| أعلى | رقم صحيح | لا. | عدد العناصر المراد إحضارها. | يشير هذا الإدخال إلى عدد ارتباطات الملفات المراد إحضارها. |
| skip | رقم صحيح | لا. | عدد العناصر المراد تخطيها. | يشير هذا الإدخال إلى عدد العناصر التي يجب تخطيها عند إحضار ارتباطات الملفات المقترحة. |
نموذج بيانات البريد الإلكتروني لقابلية للتوسعة
| الخاصية | نوع | التفاصيل | وصف لإضافته في الإجراء |
|---|---|---|---|
| plaintextBody | سلسلة | يتضمن نص البريد الإلكتروني الكامل جميع الرسائل السابقة لسلسلة رسائل البريد الإلكتروني فيه. | يوفر هذا الإدخال كل المحتوى من سلسلة رسائل البريد الإلكتروني بتنسيق نصي. |
| fullHtmlBody | سلسلة | إصدار HTML الكامل لنص البريد الإلكتروني الذي يتضمن جميع الرسائل السابقة لسلسلة رسائل البريد الإلكتروني فيه. | يوفر هذا الإدخال كل المحتوى من سلسلة رسائل البريد الإلكتروني بتنسيق HTML. |
| الموضوع | سلسلة | موضوع البريد الإلكتروني. | يوفر هذا الإدخال موضوع البريد الإلكتروني. |
| من | سلسلة | عنوان البريد الإلكتروني الخاص بالمرسل. | يوفر هذا الإدخال عنوان البريد الإلكتروني الخاص بالمرسل. |
| إلى | String[] | عناوين البريد الإلكتروني للمستلم. | يوفر هذا الإدخال عنوان البريد الإلكتروني الخاص بالمستلم. |
| نسخة | String[] | عناوين البريد الإلكتروني الخاصة بالمستلمين التي تمت إضافتها في الحقل "نسخة" في البريد الإلكتروني. | يوفر هذا الإدخال كافة عناوين البريد الإلكتروني للمستلمين المضمنة في الحقل "نسخة" في البريد الإلكتروني. |
| مخفية | String[] | عناوين البريد الإلكتروني الخاصة بالمستلمين التي تمت إضافتها في الحقل "مخفية" في البريد الإلكتروني. | يوفر هذا الإدخال كافة عناوين البريد الإلكتروني للمستلمين المضافة إلى الحقل "مخفية" في البريد الإلكتروني. |
| sentDateTime | DateTimeOffset | تاريخ ووقت البريد الإلكتروني بتنسيق UTC مع خاصية الإزاحة. لمزيد من المعلومات، انتقل إلى بنية DateTimeOffset (النظام) | يوفر هذا الإدخال الطابع الزمني للبريد الإلكتروني. |
| messageId | سلسلة | معرف رسالة Graph للبريد الإلكتروني. | يوفر هذا الإدخال معرف رسالة البريد الإلكتروني. |
| conversationId | سلسلة | معرف محادثة Graph لسلسلة رسائل البريد الإلكتروني. | يوفر هذا الإدخال معرف محادثة سلسلة رسائل البريد الإلكتروني. |
معلمات الإخراج
| الخاصية | نوع البيانات | مطلوبة | التفاصيل |
|---|---|---|---|
| القيمة | صفيف | نعم | قائمة بارتباطات الملفات (الكائنات) التي تم تعريفها كما هو موضح في مخطط استجابة اقتراحات محتوى الملفات أو الارتباطات |
| hasMoreResults | قيمة منطقية | لا. | قيمة تشير إلى ما إذا كان هناك المزيد من النتائج المتوفرة. |
مخطط استجابة اقتراحات محتوى الملفات أو الارتباطات
| الاسم | تنسيق نوع البيانات | مطلوبة | التفاصيل | وصف لإضافته في الإجراء |
|---|---|---|---|---|
| contentType | string | نعم | نوع المحتوى المراد إظهاره. لمزيد من المعلومات، انتقل إلى القيم المعرفة مسبقًا لنوع المحتوى | يشير هذا الإخراج إلى نوع المحتوى المضمن في مسودة البريد الإلكتروني. |
| المحتوى | string | نعم | تم تضمين المحتوى الفعلي. يمكن أن يكون إما صفحة ويب أو عنوان URL للملف. | يشير هذا الإخراج إلى المحتوى الفعلي المضمن في مسودة البريد الإلكتروني. يمكن أن يكون إما صفحة ويب أو عنوان URL. |
| contentTitle | string | نعم | عنوان المحتوى المقترح المعروض للمستخدم. | يشير هذا الإخراج إلى عنوان المحتوى. |
| contentDescription | string | نعم | وصف المحتوى المقترح المعروض للمستخدم. | يشير هذا الإخراج إلى النص المراد تضمينه عند وصف الملفات. |
| contentIconUrl | string | لا. | أيقونة المحتوى المقترح المعروض للمستخدم. في حالة عدم توفيرها، يتم استخدام أيقونة عامة. | يشير هذا الإخراج إلى الأيقونة التي سيتم تضمينها للمحتوى. |
| additionalProperties | الكائن | لا. | مجموعة من أزواج الاسم والقيمة التي تشير إلى خصائص إضافية لارتباط الملف الذي يُرجعه الإجراء. | يشير هذا الإخراج إلى خصائص إضافية كأزواج اسم وقيمة لكل ارتباط ذي صلة يتم إرجاعه بواسطة الإجراء. |
القيم المعرفة مسبقًا لـ contentType
| قيمة السلسلة | نوع المحتوى |
|---|---|
| content-file | ملف خارجي (عام) |
| content-web | صفحة ويب خارجية |
| content-doc | مستند Microsoft Word |
| content-pdf | مستند Microsoft PDF |
| content-pptx | عرض تقديمي Microsoft Powerpoint |
| content-xlsx | جدول بيانات Microsoft Excel |
مثال
{
"value": [
{
"contentType": 0,
"content": "https://www.bing.com",
"contentTitle": "Purchase Contract",
"contentDescription": "Purchase Contract Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Logan Edwards",
"Sender Name": "Kenny Smith"
}
},
{
"contentType": 3,
"content": "https://www.microsoft.com",
"contentTitle": "Strategy Planning",
"contentDescription": "Strategy Planning Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Gabriela Edwards",
"Sender Name": "Maria Smith"
}
},
{
"contentType": 1,
"content": "https://www.bing.com",
"contentTitle": "Contoso Website",
"contentDescription": "Contoso Website Description",
"contentIconUrl": null,
"additionalProperties": {
"Total Views": "100",
"Domain": "Contoso.com"
}
}
],
"hasMoreResults": false
}
يوضح المثال الموجود في الصورة التالية كيفية تعيين مخرجات واجهة برمجة التطبيقات (API) إلى مسودة البريد الإلكتروني.
وسيلة الإيضاح:
- ارتباطات الملفات من تطبيقات الشركاء.
(راجع أيضًا)
قم بتلخيص سلسلة رسائل البريد الإلكتروني باستخدام معلومات المبيعات باستخدام Copilot في Outlook
إثراء ملخصات البريد الإلكتروني برؤى من تطبيقك
إثراء معلومات المبيعات الرئيسية برؤى من تطبيقك
قم بإثراء تفاصيل سجل CRM برؤى من تطبيقك
قم بإثراء ملخصات سجلات CRM برؤى من تطبيقك
تمديد Microsoft 365 Copilot للمبيعات مع تطبيقات الشركاء
إنشاء Copilot للمبيعات جديدة