次の方法で共有


アプリケーションからの分析情報を活用して CRM レコードのサマリーを充実させる (プレビュー)

重要

  • これは運用に対応したプレビュー機能です。
  • 運用に対応したプレビューには 追加使用条件 が適用されます。

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

営業担当者は、準備中の会議や読んでいる電子メールのコンテキストをよりよく理解するために、顧客からの問い合わせ、懸念事項、メモなど、関連する顧客関係管理 (CRM) 情報を求めています。 Sales アプリは AI を使用して、各 CRM レコードの概要を生成します。 この要約では、営業のフェーズ、予算、契約完了予定日などの重要な詳細が強調されています。 Sales アプリが独自のアプリケーションからの分析情報を提供する CRM レコードの概要機能を拡張できます。

API の説明

次の API の説明をアクションに追加する必要があります。 これにより、Sales アプリは、機能を強化するために呼び出す必要がある正しい API を識別できます。

このアクションにより、CRM レコードに関連する Sales Insights が追加され、C4S レコードのサマリー カードに表示されます。 このアクションにより、Copilot for Sales の既存のスキルが強化されます。

API 操作

この API は、操作の種類: GET を使用します

入力パラメーター

Sales アプリは、API に次の入力パラメーターを提供するように設計されています。

件名 データ型 / 形式 必須 詳細 アクションに追加する説明
レコード タイプ はい アクティビティなどの関連分析情報が要求される CRM のエンティティまたはオブジェクトのタイプです。 値には、ローカライズ可能な表示名ではなく、エンティティまたはオブジェクト タイプの言語に依存しない一意の名前が含まれます。 例としては 取引先企業営業案件 が含まれます。 この入力は、分析情報が要求される CRM 内のエンティティまたはオブジェクト タイプを示します。
recordId はい CRM レコードの一意識別子です。 この入力は、分析情報が要求される CRM レコードの一意識別子を示します。
startDateTime 'date-time' 形式の文字列 いいえ 分析情報を検索する開始日時です。 形式は OpenAPI の仕様に従います。 例: 2017-07-21T17:32:28Z. この入力は、要求された分析情報の開始日時を示します。
終了日時 'date-time' 形式の文字列 いいえ 分析情報を検索する終了日時です。 形式は OpenAPI の仕様に従います。 例: 2017-07-21T17:32:28Z. この入力は、要求された分析情報の終了日時を示します。
上部 整数 いいえ 取得する分析情報の数です。 この入力は、取得する分析情報の数を示します。
スキップ 整数 いいえ スキップする分析情報の数です。 この入力は、スキップする分析情報の数を示します。
crmType いいえ 有効な値は Dynamics 365Salesforce です。 この入力は、分析情報が要求される既存の CRM レコードの CRM のタイプを示します。
crmOrgUrl いいえ CRM 組織のホスト名 ( contoso.crm.dynamics.com など)。 この入力は、分析情報が要求される既存の CRM レコードの CRM 環境の URL を示します。

出力パラメーター

Sales アプリは API から分析情報 (オブジェクト) の一覧を受け取ると想定しており、各分析情報には特定のパラメーターがあることを想定しています。 Sales アプリが出力を正しく解析できるようにするには、応答構造が次の表のガイドラインに従っている必要があります。

パラメーター データ型 必須 詳細
価値 Array はい 分析情報のスキーマ セクションの説明に従って定義された分析情報 (オブジェクト) のリスト。
hasMoreResults ブール値 いいえ より多くの結果が利用可能かどうかを示す値です。

分析情報のためのスキーマ

件名 データ型 / 形式 必須 詳細 アクションに追加する説明
肩書き はい 引用カードに記載の分析情報のタイトルです。 これは、Accept-Language リクエスト ヘッダで指定された言語による、分析情報の自然言語のタイトルです。 たとえば 契約の締結 などです。 この出力は、引用カード内のアクティビティのタイトルを示します。
プロパティ はい 分析情報の説明です。 これはレコード サマリーの箇条書きで表示され、Accept-Language ヘッダーで指定された言語による分析情報の自然言語記述です。 例: ケニー、ローガン、他 2 名が 2023 年 9 月 7 日に Contoso 2023 年の更新契約に署名 この出力は、分析情報の説明を示します。
dateTime 'date-time' 形式の文字列 はい UTC 形式でのアクティビティの日付と時刻です。 アクティビティに開始時刻と終了時刻の両方がある場合、アプリケーションはどちらの時刻を表示するかを決定する必要があります。 形式は OpenAPI の仕様に従います。 例: 2017-07-21T17:32:28Z. この出力は、分析情報に関連付けられた時間を示します。
url いいえ パートナー アプリケーションでアクティビティを開くための有効な URL です。 この出力は、分析情報を開くための URL を示します。
additionalProperties String 型の プロパティ名プロパティ値 の値を持つオブジェクト いいえ

詳細ビューに表示される追加プロパティです。 プロパティ名と値は、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. パートナー アプリケーションで分析情報の詳細を表示するために選択できるリンクです。 これは、API 応答の分析情報の URL に基づいています。

レコードの概要を表示する
アプリケーションからの分析情報でメールの概要を充実させる
アプリケーションからのファイル リンクを使用してメールの下書きを強化する
アプリケーションからのデータを使用して営業案件の分析情報を強化する
アプリケーションからの分析情報を活用して CRM レコードの詳細を充実させる
パートナー アプリケーションを使用して Microsoft 365 Copilot の売上を拡張する
Microsoft 365 Copilot で Sales の拡張機能をビルドする