مشاركة عبر

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

  • مقالة

مهم

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

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

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

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

يحصل هذا الإجراء على sales insights إضافية متعلقة بسجل CRM الذي سيتم عرضه في بطاقة ملخص سجل C4S. يعزز الإجراء المهارات الحالية لـ copilot للمبيعات.

عملية API

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

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

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

الاسم نوع البيانات/التنسيق مطلوبة التفاصيل وصف لإضافته في الإجراء
recordType سلسلة‬‬ نعم نوع الكيان أو الكائن في CRM الذي يتم طلب الرؤى ذات الصلة به مثل الأنشطة. تتضمن القيمة الاسم الفريد غير المرتبط باللغة للكيان أو نوع الكائن، وليس اسم العرض الذي يمكن ترجمته. تتضمن الأمثلة الحساب و الفرصة. يمكنك توسيع إمكانية ملخص سجل CRM التي يوفرها Copilot للمبيعات مع رؤى من التطبيق الخاص بك.
recordId سلسلة‬‬ نعم المعرف الفريد لسجل CRM. يشير هذا الإدخال إلى المعرف الفريد لسجل CRM الذي يتم طلب الرؤى الخاصة به.
startDateTime سلسلة بتنسيق "التاريخ والوقت". لا. ابدأ التاريخ والوقت للبحث عن رؤى. يتبع التنسيق OpenAPI المواصفات. إليك مثال: 2017-07-21T17:32:28Z. يشير هذا الإدخال إلى تاريخ البدء والوقت للرؤى المطلوبة.
endDateTime سلسلة بتنسيق "التاريخ والوقت". لا. تاريخ ووقت الانتهاء للبحث عن الرؤى. يتبع التنسيق OpenAPI المواصفات. إليك مثال: 2017-07-21T17:32:28Z. يشير هذا الإدخال إلى تاريخ ووقت الانتهاء للرؤى المطلوبة.
أعلى رقم صحيح لا. عدد الرؤى المطلوب جلبها. يشير هذا الإدخال إلى عدد الرؤى التي تريد إحضارها.
skip رقم صحيح لا. عدد الرؤى المطلوب تخطيها. يشير هذا الإدخال إلى عدد الرؤى التي يجب تخطيها.
crmType سلسلة‬‬ لا. والقيم الصالحة هي Dynamics 365 و Salesforce. يشير هذا الإدخال إلى نوع CRM الذي يوجد به سجل CRM، والذي يتم طلب معلومات عنه.
crmOrgUrl سلسلة‬‬ لا. اسم المضيف لمؤسسة CRM، مثل contoso.crm.dynamics.com. يشير هذا الإدخال إلى عنوان URL الخاص ببيئة CRM التي يوجد بها سجل CRM، والتي يتم طلب المعلومات الخاصة بها.

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

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

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

مخطط للرؤى

الاسم نوع البيانات/التنسيق مطلوبة التفاصيل الوصف المراد إضافته في العمل
العنوان سلسلة‬‬ نعم عنوان البصيرة على بطاقة الاقتباس. إنه عنوان اللغة الطبيعية للرؤية في اللغة التي يتم تحديدها من خلال Accept-Language رأس الطلب. هنا مثال: تم توقيع العقد. يشير هذا الإخراج إلى عنوان النشاط في بطاقة الاقتباس.
الوصف سلسلة‬‬ نعم وصف نتيجة تحليلات يتم عرضه كنقاط نقطية في ملخص السجل وهو وصف اللغة الطبيعية للرؤية باللغة المحددة من خلال Accept-Language الرأس. هنا مثال: وقع كيني ولوغان واثنان آخران عقد التجديد Contoso 2023 في 9/7/2023. يشير هذا الإخراج إلى وصف البينة.
التاريخ/الوقت سلسلة بتنسيق "التاريخ والوقت". نعم تاريخ ووقت النشاط بتنسيق UTC. إذا كان للنشاط وقت بدء ووقت انتهاء، فيجب أن يحدد التطبيق الوقت الذي يجب إظهاره. يتبع التنسيق OpenAPI المواصفات. إليك مثال: 2017-07-21T17:32:28Z. يشير هذا الإخراج إلى الوقت المقترن بالرؤى.
عنوان URL سلسلة‬‬ لا. عنوان URL صالح لفتح النشاط في تطبيق الشريك. يشير هذا الإخراج إلى عنوان URL لفتح المعلومات.
additionalProperties كائن له قيم اسم الخاصية وقيمة الخاصية من نوع السلسلة لا.

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

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

إشعار

على الرغم من أن متطلبات واجهة برمجة التطبيقات (API) لتوسيع إمكانات ملخص البريد الإلكتروني وإمكانيات ملخص السجل قد تبدو متشابهة، إلا أنه يجب إضافتها كإجراءات منفصلة في الموصل.

مثال

{
    "value": [
        {
            "title": "Contract signed",
            "description": "You have 5 connections in Fourth Coffee Inc",
            "dateTime": "2024-05-07T03:28:38.0667701Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        },
        {
            "title": "Contract signed",
            "description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
            "dateTime": "2024-05-07T03:28:38.0669445Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        }
    ],
    "hasMoreResults": false
}

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

لقطة شاشة توضح تشريح أحدث الأنشطة من تطبيق الشريك.

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

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

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