مشاركة عبر

إثراء معلومات المبيعات الرئيسية برؤى من تطبيقك (معاينة)

  • مقالة

مهم

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

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

  • الفرصة المرتبطة بالبريد الإلكتروني
  • الفرصة الأكثر صلة ، بناء على جهات الاتصال والحسابات في البريد الإلكتروني

يمكنك توسيع إمكانية معلومات المبيعات الأساسية التي يوفرها برنامج Copilot للمبيعات من خلال رؤى من التطبيق الخاص بك.

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

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

يحصل هذا الإجراء على رؤى مبيعات إضافية ستظهر في بطاقة معلومات المبيعات الرئيسية C4S في Outlook sidecar. يعزز الإجراء المهارات الحالية لـ copilot للمبيعات.

عملية API

يستخدم API هذا نوع العملية: GET

معلمات الإدخال

Copilot للمبيعات هذا المستخدم لتوفير معلمات الإدخال التالية لم واجهات برمجة التطبيقات الخاصة بك.

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

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

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

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

مخطط للرؤى

الاسم نوع البيانات/التنسيق مطلوبة التفاصيل وصف لإضافته في الإجراء
العنوان سلسلة‬‬ نعم عنوان بطاقة الاقتباس sales insights . يجب أن يتضمن اسم الشريك فقط ويمكن أن يحتوي على ما يصل إلى 20 حرفا. يشير هذا الإخراج إلى عنوان بطاقة الاقتباس للرؤى.
الوصف سلسلة‬‬ نعم وصف نتيجة تحليلات المبيعات. يتم عرضه كنقطة نقطية في جزء معلومات المبيعات الرئيسية ويمكن أن يحتوي على ما يصل إلى 130 حرفا. هنا مثال: التحقق من الصحة: الخطوات التالية: التوافق مع المخطط الزمني ومعايير النجاح. يشير هذا الإخراج إلى نص الرؤية لتضمينها في معلومات المبيعات الأساسية.
عنوان URL سلسلة‬‬ لا. عنوان URL صالح لفتح الرؤى في تطبيق الشريك. يشير هذا الإخراج إلى عنوان URL للتعرف على مزيد من المعلومات حول الرؤى.
التاريخ/الوقت DateTime لا. تاريخ ووقت النشاط بتنسيق UTC. إذا كان للنشاط وقت بدء ووقت انتهاء، فيجب أن يحدد التطبيق الوقت الذي يجب إظهاره. يتبع التنسيق OpenAPI المواصفات. إليك مثال: 2017-07-21T17:32:28Z. يشير هذا الإخراج إلى الوقت المقترن بالرؤى.
additionalProperties كائن له قيم اسم الخاصية وقيمة الخاصية من نوع السلسلة لا. مجموعة من أزواج الاسم والقيمة التي تشير إلى خصائص إضافية للرؤية ذات الصلة التي يُرجعها الإجراء. يتم عرض هذه المعلومات في بطاقة منبثقة عندما يحدد المستخدمون الرؤى في جزء معلومات المبيعات الرئيسية. يشير هذا الإخراج إلى خصائص إضافية كأزواج اسم وقيمة لكل معلومات ذات صلة يتم إرجاعها بواسطة الإجراء.

مثال

{
    "value": [
        {
            "title": "Contract signed",
            "description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
            "dateTime": "2023-09-07T03:42:35.4662309Z",
            "url": https://contosohub.com,
            "additionalProperties": {
                "Contract name": "Renewal contract for Fourth Coffee",
                "Signed by": "Alberto Burgos, Tony Benis",
                "Signed": "9/7/23",
                 "Related Opportunity": "50 CafeA-100 Automatic"
            }
        }
    ],
    "hasMoreResults": false
}

يوضح المثال الموجود في الصورة التالية كيفية تعيين مخرجات واجهة برمجة التطبيقات (API) إلى معلومات المبيعات الرئيسية.

لقطة شاشة تعرض رؤى من تطبيقات الشركاء في معلومات المبيعات الرئيسية.

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

  1. القسم الذي يعرض الرؤى من تطبيق الشريك. ويشتق عنوان المقطع من اسم الموصل Microsoft Power Platform .
  2. أوصاف الرؤى من استجابة واجهة برمجة التطبيقات (API).
  3. أرقام الاقتباس التي يمكن تحديدها لعرض تفاصيل حول الرؤى.
  4. بطاقة اقتباس تعرض تفاصيل حول الرؤية.
  5. رمز وعنوان البصيرة. يتم استرداد الأيقونة من بيانات تعريف موصل Microsoft Power Platform. العنوان هو عنوان المعرفة الواردة من استجابة واجهة برمجة التطبيقات (API).
  6. خصائص إضافية للرؤية من استجابة واجهة برمجة التطبيقات (API).
  7. اسم تطبيق الشريك. الاسم الذي يظهر هو اسم Microsoft Power Platform الموصل.
  8. الرابط الذي يمكن تحديده لعرض تفاصيل الرؤية في تطبيق الشريك. يعتمد ذلك على عنوان URL للرؤية في استجابة واجهة برمجة التطبيقات.

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