非標準の事前チャット詳細を渡す
組み込みサービスのコードスニペットでパラメータを使用して事前チャットエクスペリエンスをさらに詳細に制御します。事前チャットエクスペリエンスに関連しているパラメータは extraPrechatFormDetails と extraPrechatInfo の 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 の特に一般的な項目を示しています。
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 で指定した関連オブジェクト内) の名前。 |