この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

非標準の事前チャット詳細を渡す

組み込みサービスのコードスニペットでパラメータを使用して事前チャットエクスペリエンスをさらに詳細に制御します。事前チャットエクスペリエンスに関連しているパラメータは extraPrechatFormDetailsextraPrechatInfo の 2 つです。これらのパラメータを使用して、事前チャットフォームに表示されている内容以外の情報をエージェントや組織に送信できます。

extraPrechatFormDetails

このパラメータを使用すると、エージェントに追加情報を送信し、チャットトランススクリプトに情報を追加できます。

次のサンプルコードは、extraPrechatFormDetails の特に一般的な項目を示しています。

1embedded_svc.settings.extraPrechatFormDetails = [{
2  "label": "First Name",
3  "value": "John",
4  "displayToAgent": true
5}, {
6  "label": "Last Name",
7  "value": "Doe",
8  "displayToAgent": true
9}, {
10  "label": "Email",
11  "value": "john.doe@salesforce.com",
12  "displayToAgent": true
13}];

この JSON パラメータでは次のプロパティを使用できます。

名前 説明
label String この項目の表示ラベル。
value String この項目の値。
displayToAgent Boolean この表示ラベルと値をエージェントに表示するかどうか。
transcriptFields String の配列 この値を保存するチャットトランススクリプトレコードの項目の名前。

extraPrechatInfo

このパラメータを使用すると、extraPrechatFormDetails パラメータからの事前チャットフォームの詳細を既存レコードまたは新規レコードの項目に対応付けることができます。このパラメータの情報は、組織の設定ですでに指定されている情報とマージされます。

表示ラベル名が組織の事前チャット設定と extraPrechatInfo パラメータで同じ場合、extraPrechatInfo パラメータの情報が優先されます。

重要

次のサンプルコードは extraPrechatInfo の特に一般的な項目を示しています。

1embedded_svc.settings.extraPrechatInfo = [{
2  "entityFieldMaps": [{
3    "doCreate": false,
4    "doFind": true,
5    "fieldName": "LastName",
6    "isExactMatch": true,
7    "label": "Last Name"
8  }, {
9    "doCreate": false,
10    "doFind": true,
11    "fieldName": "Email",
12    "isExactMatch": true,
13    "label": "Email"
14  }],
15  "entityName": "Contact"
16}];

この JSON パラメータでは次のプロパティを使用できます。

名前 説明
entityName String 検索または作成するレコードのタイプ。
entityFieldMaps オブジェクトの配列 entityName で指定されたレコードタイプ内の項目のリスト。
entityFieldMaps.fieldName String 項目の名前。
entityFieldMaps.label String 事前チャットフォームの項目の表示ラベル。この値は extraPrechatFormDetails パラメータの表示ラベルと一致する必要があります
entityFieldMaps.doCreate Boolean 存在しなかった場合に作成するかどうか。
entityFieldMaps.doFind Boolean 完全一致でない場合に項目を検索するかどうか。
entityFieldMaps.isExactMatch Boolean findOrCreate.map API メソッドを使用して検索を実行するときに、項目値が既存のレコードの項目値に一致する必要があるかどうか。『Live Agent 開発者ガイド』の「findOrCreate.map.isExactMatch」を参照してください。
saveToTranscript String レコードの保存先のトランスクリプト項目の名前。この項目は、標準参照項目または参照関係のあるカスタム項目である必要があります。トランススクリプトに取引先レコードを添付しない場合は、saveToTranscript を空の文字列に設定します。
linkToEntityName String このオブジェクトのリ��ク先となる関連オブジェクトの名前。取引先責任者とケースとの間のデフォルトのリンクが不要な場合は、linkToEntityName を空の文字列に設定します。
linkToEntityField String このオブジェクトのリンク先となる項目 (linkToEntityName で指定した関連オブジェクト内) の名前。