مشاركة عبر

إثراء تفاصيل سجل CRM برؤى من تطبيقك (معاينة)

  • مقالة

مهم

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

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

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

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

يحصل هذا الإجراء على السجلات المتعلقة بسجل CRM. يعزز الإجراء المهارات الحالية ل Copilot للمبيعات.

عملية API

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

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

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

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

إشعار

تدعم نقطة الامتداد هذه عرض الرؤى من ما يصل إلى خمسة امتدادات للموصل في السيارة الجانبية لـ Outlook.

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

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

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

مخطط للرؤى

الاسم نوع البيانات/التنسيق مطلوبة التفاصيل وصف لإضافته في الإجراء
recordId سلسلة‬‬ نعم المعرف الفريد للسجل. يحدد هذا الإخراج بشكل فريد كل سجل مرتبط يتم إرجاعه بواسطة الإجراء.
recordTypeDisplayName سلسلة‬‬ نعم اسم العرض لنوع السجل، مثل العقد. يجب أن تكون مترجمة باللغة المحددة من خلال Accept-Language الرأس. يشير هذا الإخراج إلى اسم العرض السجل نوع السجل سجل كل سجل ذي صلة الذي أرجعه الإجراء.
recordTypePluralDisplayName سلسلة‬‬ نعم اسم العرض الجمعي لنوع السجل، مثل العقود. يجب أن تكون مترجمة باللغة المحددة من خلال Accept-Language الرأس. يشير هذا الإخراج إلى اسم العرض الجمعي لنوع السجل لكل سجل ذي صلة يتم إرجاعه بواسطة الإجراء.
recordType سلسلة‬‬ نعم اسم النظام لنوع السجل، مثل العقد. يشير هذا الإخراج إلى نوع كل سجل مرتبط تم إرجاعه بواسطة الإجراء.
recordTitle سلسلة‬‬ نعم اسم العرض لنوع السجل، مثل عقد تجديد Contoso 2023. يشير هذا الإخراج إلى عنوان كل سجل ذي صلة يتم إرجاعه بواسطة الإجراء.
عنوان URL سلسلة‬‬ لا. عنوان URL صالح لفتح السجل في تطبيق الشريك. يشير هذا الإخراج إلى عنوان URL لكل سجل ذي صلة يتم إرجاعه بواسطة الإجراء.
additionalProperties كائن له قيم اسم الخاصية وقيمة الخاصية من نوع السلسلة لا.

خصائص إضافية تظهر في العرض التفصيلي. تكون أسماء الخصائص وقيمها باللغة الطبيعية باللغة المحددة من خلال Accept-Language الرأس. إليك مثال.

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

مثال

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

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

لقطة شاشة تعرض تشريح السجلات ذات الصلة من تطبيق شريك.

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

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

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