ソース.csvファイルのデータを操作する
外部IDはGenesys Cloudの必須キーフィールドです。インポートプロセス一意の連絡先を決定するために使用します。このフィールドは連絡先を識別するのに役立ち、同じスプレッドシートを介して既存の連絡先を簡単に更新できます。インポート プロセスでは、一意の外部 ID ごとに 1 つの Genesys Cloud 外部連絡先レコードが作成されます。インポート プロセスでは、行内のすべての連絡先フィールドが、対応する Genesys Cloud 外部連絡先レコードにインポートされます。
外部 ID を作成するときは、文字と数字の任意の組み合わせを使用できます。たとえば、CRM または ERP システムの一意の識別子を使用することも、自分にとって意味のある複合キーを作成することもできます。255 文字の制限を満たしていれば、レコードを識別するために使用する任意の外部 ID を使用できます。.csv が CRM から抽出される場合は、CRM の一意の識別子 (UUID) を使用することをお勧めします。UUID を使用すると、今後の機能更新で CRM から連絡先を同期できるようになります。
レコードを1回だけインポートする予定の場合は、必要な外部IDを使用できます。 システムは、これらの外部IDに対応するように内部IDを生成します。
- 以前に連絡先をインポートしたことがある場合は、古い一括インポート プロセスでは、システムは電話番号または電子メール アドレスの識別子のみを使用して、連絡先を新しい外部 ID と照合し更新します。
- 既存の連絡先を新しいレコードと正常に統合するには、.csv一括インポートを実行するときに、.csvファイル内のすべての電話番号がE.164形式電話でマッチングする場合。
- .csvファイル内の電話番号がE.164形式に準拠していない場合、インポート プロセスで警告がトリガーされます。インポート プロセスが連絡先のインポートを続行している間、ID 解決アルゴリズムが電話番号に基づいて連絡先を正確に照合して結合するという保証はありません。
- 古い連絡先に、新しい .csv ファイル内の電子メールまたは電話番号と一致する電子メールまたは電話番号がない場合、システムは .csv 内に指定された外部 ID を持つレコードを作成します。
- 連絡先の情報が同じファイル内で複数回繰り返されている場合、連絡先は複数回更新され、インポートされた行カウンタにその繰り返しが反映されます。ただし、更新が行われる順序は保証されません。
以前にインポートした連絡先を更新するときは、重複レコードが作成されないように、同じ外部 ID を使用するようにしてください。
たとえば、外部 ID として「A」を使用してレコードを含むスプレッドシートをインポートし、後でそのレコードの外部 ID として「B」を使用して同じスプレッドシートを再インポートすると、Genesys Cloud は既存のレコードを更新する代わりにレコードを作成します。既存のレコードを更新するには、常に同じ外部 ID を使用します。
外部組織
T外部組織の外部IDはインポートプロセスで一意の組織を決定するために使用するキーフィールド。 インポート プロセスでは、一意の外部組織外部 ID ごとに 1 つの Genesys Cloud 外部組織レコードが作成されます。インポート プロセスでは、行内のすべてのアカウント フィールドが対応する Genesys Cloud 外部組織レコードにインポートされます。
外部組織の外部 ID を作成するときは、文字と数字の任意の組み合わせを使用できます。255 文字の制限を満たしていれば、自分にとって意味のある複合キーを作成できます。.csv が CRM から抽出される場合は、CRM の一意の識別子 (UUID) を使用することをお勧めします。UUID を使用すると、今後の機能更新で CRM から連絡先を同期できるようになります。
外部連絡先を外部組織と関連付ける
外部連絡先を外部組織に関連付けるには、.csv ソース ファイル内の同じ行に入力します。
この例では、Angus Reid は Phoenix Foundation II の問題解決者です。インポート プロセスにより、Phoenix Foundation II の外部組織レコードと Angus Reid の外部連絡先レコードが作成されます。「外部連絡先」では、アンガス・リードがフェニックス財団 II 組織の外部連絡先として登場します。
複数の外部を関連付ける との連絡 外部の 組織
複数の外部連絡先を1つの連絡先に関連付けるには外部の組織ごとに、同じ外部組織外部 ID を割り当てます。
この例では、Kathryn、Josh、およびRebeccaは、すべてOffice Mart組織の連絡先です。
- 複数の行が外部組織の外部IDを共有する場合、すべての組織固有のフィールド(アカウント名など)が同一である必要があり、Genesys Cloudは関連するすべての連絡先に対して1つの外部組織を作成します。Genesys Cloud は、外部 ID ごとに 1 行のみをインポートし、関連するすべての連絡先に対して 1 つの外部組織を作成しますが、どの行が使用されるかは保証しません。行間に差異が存在する場合、各行は更新のために外部組織に個別に送信されます。
- .csvファイルを使用して、手動で作成した組織にメンバーをインポートすることはできません。
一括インポートプロセスがマージアクションを管理する方法
この例では、連絡先のみをインポートし、.csv ファイル内のすべての外部連絡先組織フィールドが空であると想定します。
一括インポート プロセス中に、インポート プロファイル画面で次のオプションが選択されました。
- 連絡先の一致:外部ID、電話番号、メールアドレス
- 一致した連絡先を統合する:一致するすべての連絡先を結合して更新する
この例では、次の識別子が検索されます。
- ExternalID:123AABC
- 電話: +1 919 432 5523
- email: tom.sellenta@sag.aftra.com
.csv の勤務先電話番号は連絡先 C の携帯電話番号と一致します。新しいマージされた ContactD が作成されます。
次の表では、
- フィールド名列には、.csv ファイル内のフィールド名が示されます。
- CSV データ (エンリッチ要求) 列には、.csv ファイルのデータが表示されます。
- 連絡先 B 列は、Genesys Cloud でキュレーションされた連絡先です。
- 連絡先 C 列は、Genesys Cloud でキュレーションされた連絡先です。
- 連絡先 D 列は、インポート完了後に結合された連絡先です。
- 説明列には、連絡先 D 列のデータがどのようにインポートされたかが説明されています。
| フィールド名 | CSV データ (エンリッチ リクエスト) | 連絡先B | 連絡先C | 連絡先 D (統合された連絡先) | 説明 |
|---|---|---|---|---|---|
| 外部 ID | 123AABC | 123AABC | .csv レコードの外部 ID は、マージされたレコードの主な識別子として強化されます。古い .csv インポートで使用されていた連絡先 ID は、連絡先レコードでは使用されなくなり、表示されなくなりました。 | ||
| 名 | トム | トミー | トム | トム | データが競合している場合、マージされた連絡先には .csv ファイルの最新データが保持されます。 |
| middleName | T | T | .csv インポートでは null 値は使用されません。接点Cの値が使用されます。 | ||
| 姓 | Selleck | Selk | Selleck | データが競合している場合、マージされた連絡先には .csv ファイルの最新データが保持されます。 | |
| タイトル | 問題解決者 | 問題解決者 | 連絡先 C の値が使用されます。 | ||
| salutation | Mister | Mr. | Mister | データが競合している場合、マージされた連絡先には .csv ファイルの最新データが保持されます。 | |
| work Email | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com | データが競合している場合、マージされた連絡先には .csv ファイルの最新データが保持されます。 |
| personal Email | tom@hotmail.com | tommy@yahoo.com | tom@gmail.com | データの損失を避けるために、マージ中は電子メールと電話番号は慎重に処理されます。2 つの連絡先が同じフィールド (workEmail など) を使用している場合、データは別の使用可能なフィールド (personalEmail や otherEmail など) に移動されます。 この例では、「tom@gmail.com」は削除されるのではなく、workEmail から personalEmail に移動されます。このプロセスは、すべての可能なフィールドが使用されるまで繰り返し続行されます。スペースが限られている場合、リクエスト値に対応するために古いメールは削除されます。 |
|
| その他メール | tommy@hotmail.com | 特定のフィールド名は重要ではなく、可能な限り、マージされた連絡先のデータが保持されます。再配置可能なフィールドが残っていない場合、データは削除されます。 | |||
| cell Phone | +1 919 432-5523 | .csv の勤務先電話番号は連絡先 C の携帯電話番号と一致します。 | |||
| work Phone | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | [インポート フィールド] チェックボックスがオフになっているため、インポート後も連絡先 C の勤務先電話番号は変更されません。 | |
| 自宅電話 | 更新がなければ、連絡に価値はありません。 | ||||
| その他電話 | 更新がなければ、連絡に価値はない |
この例では、連絡先のみをインポートします。.csv ファイル内の外部組織フィールドは空であると想定されます。
一括インポート プロセス中に、インポート プロファイル画面で次のオプションが選択されました。
- 次の条件で連絡先を一致:外部ID、メールアドレス、電話番号
- 一致した連絡先を統合する:最初に一致した連絡先のみ更新
この例では、検索される識別子の順序は次のとおりです。(メール ID は ExternalID の前に来ます)
- ExternalID:123AABC
- email: tom.selleck@sag.aftra.com
- 電話: +1 919 432-5523
.csv の勤務先メールは連絡先 C の勤務先メールと一致し、勤務先電話番号は連絡先 B の携帯電話と一致しました。「一致するすべての連絡先を結合して更新する」オプションが選択されていないため、両方の連絡先が CSV データと部分的に一致しているにもかかわらず、インポート後に連絡先 C のみが更新され、連絡先 B は変更されません。
次の表では、
- フィールド名列には、.csv ファイル内のフィールド名が示されます。
- CSV データ (エンリッチ要求) 列には、.csv ファイルのデータが表示されます。
- 連絡先 B 列は、Genesys Cloud でキュレーションされた連絡先です。
- 連絡先C列はGenesys Cloudでキュレーションされた連絡先です
- 更新された連絡先 C 列は、インポート完了後のデータです。
- 説明列には、連絡先 D 列のデータがどのようにインポートされたかが説明されています。
| フィールド名 | CSV データ (エンリッチ リクエスト) | 連絡先B | 連絡先C | 連絡先Cを更新しました | 説明 |
|---|---|---|---|---|---|
| 外部 ID | 123AABC | 123AABC |
.csv レコードの外部 ID は、連絡先 C レコードの主な識別子として強化されます。 古い .csv インポートで使用されていたアカウント ID は、連絡先レコードでは使用されなくなり、表示されなくなりました。 |
||
| 名 | トム | トミー | トム | トム | 衝突がなければ、変化もない。 |
| middleName | T | T |
.csv には middleName の値がありませんが、連絡先 C にはあります。 したがって、連絡先 C の middleName 値は変更されません。 |
||
| 姓 | Selleck | Selk | Selleck | 対立。.csv のデータを使用して連絡先 C を更新します。 | |
| タイトル | 問題解決者 | 問題解決者 | インポート フィールドのチェックが外れているため、更新はありません。 | ||
| salutation | Mister | Mr. | Mister | 対立。.csv のデータを使用して連絡先 C を更新します。 | |
| work Email | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com |
.csv の勤務先メールは連絡先 C の勤務先メールと一致します。 この連絡先はインポート後に更新され、連絡先 B は最初に一致した連絡先ではなく、連絡先 C が最初に一致した連絡先であったため、変更されません。 |
| personal Email | tommy@yahoo.com | tom@yahoo.com | インポート フィールドが選択されていないため、更新はありません。 | ||
| その他メール | 更新がなければ、連絡に価値はありません。 | ||||
| cell Phone | +1 317 845-1232 | +1 317 845-1232 | インポート フィールドが選択されていないため、更新はありません。 | ||
| work Phone | +1 919 432-5523 | +1 317 845-1232 | +1 919 432-5523 | 競合があるため、連絡先 C は .csv のデータで更新されます。 | |
| 自宅電話 | 更新がなければ、連絡に価値はありません。 | ||||
| その他電話 | 更新がなければ、連絡に価値はありません。 |
この例では、一部の連絡先が識別され、一部の連絡先がキュレーションされます。
連絡先には次の 3 つの種類があります。
- はかない:クライアント側の Web 識別子または Cookie に関連付けられているが、その他の情報を持たない自動生成された連絡先。つまり、Web Cookie/クライアント側識別子が指す空の連絡先です。有効期間 (TTL) は 60 日間に制限されます。
- 特定された:非 Cookie の PII を持ち、60 日間の TTL 制限がある自動生成された連絡先。
- キュレーション:エージェントまたは API 呼び出しによって作成または_昇格_された連絡先。TTL制限はありません。
一時的な連絡先と識別された連絡先はシステムによって生成され、検索 API、逆ホワイトページ検索、またはスキャンには表示されません。
システム内で次の 2 つの連絡先が一致します。
- 連絡先 B (キュレーション)
- 連絡先C（特定済み）
一括インポート プロセス中に、インポート プロファイル画面で次のオプションが選択されました。
- 連絡先の一致:外部 ID、電子メール アドレス、電話番号。
- 一致した連絡先を統合する:一致したすべての連絡先を結合して更新します。
この例では、次の識別子が検索されます。
- ExternalID:123AABC
- email: johnny@gmail.com
- 電話: +1 919 432-5523
.csvファイルの個人メールフィールドは、連絡先Cの他のメールフィールドと一致します。 johnny@gmail.com 。
.csv の勤務先電話番号は連絡先 B の携帯電話番号 (+1 919 432-5523) と一致します。
次の表では、
- フィールド名列には、.csv ファイル内のフィールド名が示されます。
- CSV データ (エンリッチ要求) 列には、.csv ファイルのデータが表示されます。
- 連絡先 B 列は、Genesys Cloud でキュレーションされた連絡先です。
- 連絡先 C 列は、Genesys Cloud で識別された連絡先です。
- 連絡先 D 列は、インポート完了後に結合された連絡先です。
- 説明列には、連絡先 D 列のデータがどのようにインポートされたかが説明されています。
| フィールド名 | CSV データ (エンリッチ リクエスト) | 連絡先B | 連絡先C | 連絡先D | 説明 |
| 外部 ID | 123AABC | 123AABC | .csv レコードの外部 ID は、マージされた連絡先 D レコードの主な識別子として強化されます。 | ||
| 名 | Johnny | Johnny | .csv インポートでは null 値は使用されません。接点Cの値が使用されます。 | ||
| middleName | マシュー | M | マシュー | 矛盾があるため、最新のキュレーションされた連絡先が使用されます。 | |
| 姓 | バンクスIV | 銀行 | バンクスIV | バンクスIV | ここでは .csv の値が優先されます。 |
| タイトル | ジョニーボーイ | ジョニーボーイ | .csv インポートでは null 値は使用されません。連絡先Cの値が使用されます。 | ||
| salutation | Mr | Mr | .csv インポートでは null 値は使用されません。連絡先Bの値が使用されます。 | ||
| work Email | Banks@gmail.com | Banks@gmail.com | .csv インポートでは null 値は使用されません。連絡先Bの値が使用されます。 | ||
| personal Email | johnny@gmail.com | johnny@gmail.com | .csv からの個人メールは連絡先 C の他のメールと一致します。 .csv の値は、結合された連絡先 D の個人メールに使用されます。 |
||
| その他メール | johnny@gmail.com |
.csv からの個人メールは連絡先 C の他のメールと一致します。 このシナリオでは、マージされた連絡先のもう一方のメールアドレスは空のままです個人用電子メールがすでにこの電子メール アドレスを取得しているため、重複する電話番号または電子メールの値は保存されません。 |
|||
| cell Phone | +1 919 432-5523 |
.csv の勤務先電話番号は連絡先 B の携帯電話番号と一致します。 このシナリオでは、勤務先電話番号がすでにこの電話番号の値を取得しており、重複する電話番号または電子メールの値は保存されないため、結合された連絡先の携帯電話番号は空のままになります。 |
|||
| work Phone | +1 919 432-5523 | +1 919 432-5523 | .csv の勤務先電話番号は連絡先 B の携帯電話番号と一致します。 | ||
| 自宅電話 | 更新がなければ、連絡に価値はありません。 | ||||
| その他電話 | 更新がなければ、連絡に価値はない |
