إثراء ملخص البريد الإلكتروني باقتراحات المحتوى من التطبيق الخاص بك (إصدار أولي)

مهم

• هذه ميزة معاينة جاهزة للإنتاج.
• تخضع الإصدارات الأولية الجاهزة للإنتاج لشروط الاستخدام التكميلية..

[هذا المقال عبارة عن وثائق نسخة مسبقة وهو عرضة للتغيير.]

عند استخدام Copilot في Outlook وSales app معا، تتضمن ملخصات البريد الإلكتروني التي تظهر في Outlook معلومات المبيعات التي يتم الحصول إليها من نظام إدارة علاقات العملاء (CRM)، مثل Dynamics 365 أو Salesforce CRM. يمكنك توسيع إمكانية ملخص البريد الإلكتروني التي يوفرها تطبيق المبيعات مع رؤى من تطبيقك الخاص.

إشعار

تحل واجهة API هذه محل واجهة API مهارة ملخص البريد الإلكتروني الحالية (معرف العملية: scp-get-email-insights) بإصدار جديد.

وصف واجهة برمجة التطبيقات

يجب عليك إضافة وصف واجهة برمجة التطبيقات التالي إلى الإجراء. يساعد هذا تطبيق Sales على تحديد واجهة برمجة التطبيقات الصحيحة لاستدعاءها لإثراء القدرة.

يحصل هذا الإجراء على sales insights إضافية سيتم عرضها في تجربة ملخص البريد الإلكتروني لـ C4S داخل ملخص Outlook. يعزز الإجراء المهارات الحالية لـ copilot للمبيعات.

تفاصيل API

• اسم API: مهارة ملخص البريد الإلكتروني الإصدار 2
• معرف عملية خاصية Swagger: scp-get-email-insights-v2
• طريقة عملية Swagger: نشر
• المسار: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

حمولة الإدخال

تذهب هذه الحمولة كنص طلب لطلب API.

الاسم	نوع البيانات	مطلوبة	التفاصيل	وصف لإضافته في الإجراء
بيانات الموارد	‏‏الكائن	نعم	بيانات المورد التي سيتم استخدامها لإحضار المحتوى المقترح. بالنسبة إلى بنية البيانات، انتقل إلى نموذج بيانات البريد الإلكتروني لقابلية التوسعة.	يحدد هذا الإدخال محتوى البريد الإلكتروني وهو عبارة عن مجموعة من سلسلة رسائل البريد الإلكتروني والموضوع وتفاصيل أخرى.
الكيانات المرتبطة	صفيف	لا.	مجموعة الكيانات ذات الصلة. بالنسبة لبنية البيانات، انتقل إلى نموذج بيانات الكيان المرتبط.	يحدد هذا الإدخال صفيف سجلات CRM المرتبط بسلسلة رسائل البريد الإلكتروني.
crmType	سلسلة‬‬	لا.	نوع نظام CRM، إذا كان متصلاً. والقيم الصالحة هي Salesforce و Dynamics 365.	يشير هذا الإدخال إلى نوع CRM الذي يوجد فيه السجل المتعلق بسلسلة رسائل البريد الإلكتروني.
crmOrgUrl	سلسلة‬‬	لا.	عنوان URL لمؤسسة CRM.	يشير هذا الإدخال إلى عنوان URL الخاص ببيئة CRM التي يوجد فيها السجل المرتبط بسلسلة رسائل البريد الإلكتروني.
أعلى	رقم صحيح	لا.	عدد العناصر المراد إحضارها.	يشير هذا الإدخال إلى عدد ارتباطات الملفات المراد إحضارها.
skip	رقم صحيح	لا.	عدد العناصر المراد تخطيها.	يشير هذا الإدخال إلى عدد العناصر التي يجب تخطيها عند إحضار ارتباطات الملفات المقترحة.

نموذج بيانات البريد الإلكتروني لقابلية للتوسعة

الخاصية	نوع	التفاصيل	وصف لإضافته في الإجراء
plaintextBody	سلسلة‬‬	يتضمن نص البريد الإلكتروني الكامل جميع الرسائل السابقة لسلسلة رسائل البريد الإلكتروني فيه.	يوفر هذا الإدخال كل المحتوى من سلسلة رسائل البريد الإلكتروني بتنسيق نصي.
fullHtmlBody	سلسلة‬‬	إصدار HTML الكامل لنص البريد الإلكتروني الذي يتضمن جميع الرسائل السابقة لسلسلة رسائل البريد الإلكتروني فيه.	يوفر هذا الإدخال كل المحتوى من سلسلة رسائل البريد الإلكتروني بتنسيق HTML.
الموضوع	سلسلة‬‬	موضوع البريد الإلكتروني.	يوفر هذا الإدخال موضوع البريد الإلكتروني.
من	سلسلة‬‬	عنوان البريد الإلكتروني الخاص بالمرسل.	يوفر هذا الإدخال عنوان البريد الإلكتروني الخاص بالمرسل.
إلى	String[]	عناوين البريد الإلكتروني للمستلم.	يوفر هذا الإدخال عنوان البريد الإلكتروني الخاص بالمستلم.
نسخة	String[]	تمت إضافة عناوين البريد الإلكتروني للمستلم في الحقل "نسخة" في البريد الإلكتروني.	يوفر هذا الإدخال كافة عناوين البريد الإلكتروني للمستلمين المضمنة في الحقل "نسخة" في البريد الإلكتروني.
مخفية	String[]	تمت إضافة عناوين البريد الإلكتروني للمستلم في الحقل "نسخة مخفية" في البريد الإلكتروني.	يوفر هذا الإدخال كافة عناوين البريد الإلكتروني للمستلمين المضافة إلى الحقل "مخفية" في البريد الإلكتروني.
sentDateTime	DateTimeOffset	تاريخ ووقت البريد الإلكتروني بتنسيق UTC مع خاصية الإزاحة. لمزيد من المعلومات، انتقل إلى بنية DateTimeOffset (النظام)	يوفر هذا الإدخال الطابع الزمني للبريد الإلكتروني.
messageId	سلسلة‬‬	معرف رسالة Graph للبريد الإلكتروني.	يوفر هذا الإدخال معرف رسالة البريد الإلكتروني.
معرف المحادثة	سلسلة‬‬	معرف محادثة Graph لسلسلة رسائل البريد الإلكتروني.	يوفر هذا الإدخال معرف محادثة سلسلة رسائل البريد الإلكتروني.

نموذج بيانات الكيان المرتبط

الخاصية	نوع	مطلوبة	التفاصيل	وصف لإضافته في الإجراء
entityId	سلسلة‬‬	نعم	نوع سجل CRM مثل الحساب أو الفرصة.	يوفر هذا الإدخال المعرف الفريد لسجل CRM المرتبط بسلسلة رسائل البريد الإلكتروني.
entityType	سلسلة‬‬	نعم	المعرف الفريد لسجل CRM المراد استخدامه للمحتويات المقترحة.	يحدد هذا الإدخال نوع السجل CRM، المرتبطة بسلسلة رسائل البريد الإلكتروني.
مصدرالكيان	سلسلة‬‬	لا.	يشير هذا الإدخال إلى مصدر الكيان، الذي يحتوي حاليًا على قيم "متصلة" أو فارغة.	يشير هذا الإدخال إلى نوع مصدر الكيان.

معلمات الإخراج

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

المعلمة	نوع البيانات	مطلوبة	التفاصيل
القيمة	صفيف	نعم	قائمة بالرؤى (الكائنات) التي تم تعريفها كما هو موضح في قسم مخطط الرؤى . ملاحظة: على الرغم من أن هذه المعلمة تتضمن قائمة بالتفاصيل، إلا أنه يتم استخدام التفاصيل الأولى فقط في ملخص إثراء البريد الإلكتروني لتجربة اللوحة في Outlook.
لديه نتائج أكثر	قيمة منطقية	لا.	قيمة تشير إلى ما إذا كان هناك المزيد من النتائج المتوفرة.

مخطط للرؤى

الاسم	نوع البيانات/التنسيق	مطلوبة	التفاصيل	وصف لإضافته في الإجراء
نتيجة تحليلات	سلسلة‬‬	نعم	الرؤى التي يتم تسليمها للمستخدمين، مثل زملائك منى كين وراي تاناكا ودانييلا سميث قد عملوا معهم من قبل.	يشير هذا الإخراج إلى النص الذي ترغب في تضمينه في ملخص البريد الإلكتروني.

مثال

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}
 

يوضح المثال في الصورة التالية كيفية تعيين إخراج API إلى ملخص البريد الإلكتروني في الجزء الجانبي.

وسيلة الإيضاح:

1. عنوان البصيرة. يتم تجميع المعارف الدقيقة التي لها نفس العنوان معًا.
2. أوصاف نتيجة التحليلات. كل فكرة لها وصف واحد.

يوضح المثال في الصورة التالية كيفية تعيين إخراج API إلى ملخص البريد الإلكتروني في النص الأساسي للبريد الإلكتروني.

وسيلة الإيضاح:

1. عنوان البصيرة. يتم تجميع المعارف الدقيقة التي لها نفس العنوان معًا.
2. وصف البصيرة. كل فكرة لها وصف واحد.

المعلومات المرتبطة

قم بتلخيص سلسلة رسائل البريد الإلكتروني باستخدام معلومات المبيعات باستخدام Copilot في Outlook
إثراء رؤى الفرصة بالبيانات من تطبيقك
قم بإثراء تفاصيل سجل CRM برؤى من تطبيقك
قم بإثراء ملخصات سجلات CRM برؤى من تطبيقك
توسيع المبيعات في Microsoft 365 Copilot مع تطبيقات الشركاء
إثراء مسودات البريد الإلكتروني باستخدام ارتباطات الملفات من تطبيقك
إنشاء ملحقات للمبيعات في Microsoft 365 Copilot