自動化ディクショナリを使用してデータ パラメーター キーを渡す
概要
自動化ディクショナリはセッションのコンテキスト データを保持します。 自動化ディクショナリのキーを使用して、テンプレートでパラメーター キーを渡すことができます。
Dynamics 365 チャネル統合フレームワーク アプリでテンプレートを作成している間、セッションのタイトル、通知のタイトル、アプリケーション タブ テンプレートのタイトル、アプリケーション タブの種類のカスタム パラメーター値など、パラメーター キーを渡すことができます。 これらのキーは、実行時に利用可能なコンテキスト情報に基づき置き換えられます。
テンプレートでデータ パラメーターを渡す
通知を含むテンプレートのシナリオを説明します。
通知は、フィールド ヘッダー と 値 とそれぞれ呼ばれる特定のフィールドと値を表示します。
顧客の Kenny Smith が会話を始めました。 エージェントが通知を確認すると、Kenny Smith として 顧客名 が表示されます。
ここで フィールド ヘッダー は 顧客名 であり、値 は Kenny Smith です。
顧客名を Kenny Smith として識別するテンプレートの場合、ユーザーは管理者として値としてパラメーターを渡すように構成する必要があります。
同様に、セッションと通知のタイトルに対してデータ パラメーターを渡すことができます。 詳細については データ パラメーター キーへの自動化ディクショナリ形式 を参照してください。
Dynamics 365 チャネル統合フレームワークは、セッションのコンテキスト、チャネル プロバイダー、Microsoft Dataverse、ユーザーのアクションに基づいて、これらのパラメーター値を実際の値に置き換えます。
詳細については コンテキスト データ パラメーターの種類 を参照してください。
コンテキスト データ パラメーターの種類
自動化ディクショナリは、次のソースから利用できるコンテキスト データ パラメーターを使用します。
チャネル プロバイダーからのコンテキスト データ
このコンテキスト データは、顧客サービスのオムニチャネルや、Dynamics 365 チャネル統合フレームワークで公開されるウィジェットを使用するサードパーティ チャネル プロバイダーなど、ファースト パーティ チャンネル プロバイダーからのものです。 ウィジェット内の updateContext API を使用することで、チャネル統合フレームワーク ウィジェットのコンテキスト データを自動化ディクショナリに渡すことができます。 任意のデータを渡すことができますが、一般的な例としては、顧客名、顧客の電話番号、電話の IVR から収集したデータポイントなどです。 このデータは、テンプレートやマクロやエージェント スクリプトなどの生産性ツールのスラグとして自動化ディクショナリで参照することができます。
ユーザー アクションからのデータ コンテキスト
このデータは、エージェントがセッションで活動を実行するときに入力します。 たとえば、新しい顧客レコードやサポート案件を開く時です。
Dataverse からのコンテキスト データ
組織データは Dataverse に保存され、OData クエリを使用してデータをフェッチできます。 詳細については OData クエリ を参照してください。
データ パラメーター キーのための自動化ディクショナリ形式
自動化ディクショナリはセッションのコンテキスト データを保持します。 自動化ディクショナリのキーは、マクロのアクションにパラメーターとして渡すことができます。 システムは、セッションのコンテキスト、チャネル プロバイダー、Dataverse、ユーザーのアクションに基づいて、これらのパラメーター キーを実際の値に置き換えます。
サポートされる形式を下記に表示します。
スラグ
スラグは、コンテキストに基づいて実行時に Dynamics 365 チャネル統合フレームワークが入力する置換パラメータです。 以下に例を示します。
| スラグ | 説明 |
|---|---|
{customerName} |
会話を開始した顧客の名前。 |
{caseId} |
サポート案件に固有の ID。 システムは、サポート案件が会話にリンクされている場合に サポート案件 ID のみを表示します。 |
{caseTitle} |
サポート案件のタイトル。 システムは、サポート案件が会話にリンクされている場合にサポート案件のタイトルのみを表示します。 |
書式
チャネル プロバイダ、現在のユーザセッション、および/または Dataverse からコンテキストを取得する {Slug} パラメーター形式。
次に例を示します。
{caseId}
OData クエリ
OData クエリを使用して、Dataverse から利用可能なコンテキストを取得できます。
OData クエリの形式:
{$Odata.<entityName>.<entityAttributeName>.<?options>}
次に例を示します。
{$Odata.account.name.?$filter=id eq '{accountid}'}{$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}{$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}
静的な値
これらはビジネス要件としてそれぞれ更新するハードコードされた値です。 選択するすべてのハードコードされた属性は、特定の属性に対する形式の種類に従います。
次に例を示します。
受信するチャット要求の場合に、実行時にエージェントに表示するセッションと通知のテンプレートに、静的なタイトルを指定します。
通知のタイトル = New chat request
セッションのタイトル = Chat conversation