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

Important

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

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

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

API の説明

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

このアクションにより、CRM レコードに関連する Sales Insights が追加され、C4S レコードのサマリー カードに表示されます。 このアクションにより、販売のための副操縦士の既存のスキルが向上します。

API 操作

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

入力パラメーター

Sales エージェントは、API に次の入力パラメーターを提供するように設計されています。

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

出力パラメーター

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

パラメーター データの種類 必須 詳細情報
value Array Yes 「分析情報のスキーマ」セクションの説明に従って定義されている 分析情報 (オブジェクト) の一覧。
さらに結果があります ブール値 No より多くの結果を使用できるかどうかを示す値。

分析情報のスキーマ

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

詳細ビューに表示される追加プロパティです。 プロパティ名と値は、Accept-Language ヘッダーで指定された言語の自然言語です。 次に例を示します。

{
 "ステータス": "サインオフ"、
 "所有者": "ケニースミス"
}
 この出力は、分析情報の詳細ビューに表示される追加のプロパティを示します。

Note

電子メールの要約機能とレコードの要約機能を拡張するための API 要件は似ているように見えますが、コネクター内の別のアクションとして追加する必要があります。

Example

{
    "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 レコードの詳細を充実させる
パートナー アプリケーションを使用して販売エージェントを拡張する
Sales エージェントの拡張機能をビルドする

  • Last updated on