ソース.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 と照合し更新します。
- To successfully merge the existing contacts with the new records, when you perform the .csv bulk import, it is important that all phone numbers in the .csv file follow the E.164 format when matching by phone.
- 古い連絡先に、新しい .csv ファイル内の電子メールまたは電話番号と一致する電子メールまたは電話番号がない場合、システムは .csv 内に指定された外部 ID を持つレコードを作成します。
- 連絡先の情報が同じファイル内で複数回繰り返されている場合、連絡先は複数回更新され、インポートされた行カウンタにその繰り返しが反映されます。ただし、更新が行われる順序は保証されません。
以前にインポートした連絡先を更新するときは、重複レコードが作成されないように、同じ外部 ID を使用するようにしてください。
たとえば、外部 ID として「A」を使用してレコードを含むスプレッドシートをインポートし、後でそのレコードの外部 ID として「B」を使用して同じスプレッドシートを再インポートすると、Genesys Cloud は既存のレコードを更新する代わりにレコードを作成します。既存のレコードを更新するには、常に同じ外部 ID を使用します。
外部組織
The External Organization External ID is the key field, which the import process uses to determine unique organizations. For each unique External Organization External ID, the import process creates one Genesys Cloud external organization record. The import process imports all the account fields in the row to the corresponding Genesys Cloud external organization record.
外部組織の外部 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組織の連絡先です。
- If multiple rows share an External Organization External ID, all organization-specific fields must be identical (for example, Account Name) and Genesys Cloud creates one External Organization for all related contacts. Genesys Cloud imports only one row per External ID, creates one External Organization for all related contacts and does not guarantee which row is used. If differences exist across rows, each row is sent separately for updates to the External Org.
- .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 | 衝突なし | ||
姓 | 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 の携帯電話と一致します。このフィールドは、.csv データの携帯電話番号 (この場合は空) のインポート後に更新されます。 | |||
work Phone | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | As the Import Field checkbox was cleared, Contact C’s WorkPhone remains unchanged after the import. | |
自宅電話 | 更新がなければ、連絡に価値はありません。 | ||||
その他電話 | 更新がなければ、連絡に価値はない |
この例では、連絡先のみをインポートします。.csv ファイル内の外部組織フィールドは空であると想定されます。
一括インポート プロセス中に、インポート プロファイル画面で次のオプションが選択されました。
- 連絡先の一致:外部ID、電話番号、メールアドレス
- 一致した連絡先を統合する:最初に一致した連絡先のみ更新
この例では、検索される識別子の順序は次のとおりです。(メール ID は ExternalID の前に来ます)
- ExternalID:123AABC
- email: tom.selleck@sag.aftra.com
- 電話: +1 919 432-5523
The Work email from .csv is matched with Contact C’s Work Email and the work phone was matched to Contact B’s cell phone. As the Merge and update all matched contacts option is not selected, only Contact C will be updated after the import and the Contact B remains unchanged, even though both contacts partially match the CSV data.
次の表では、
- フィールド名列には、.csv ファイル内のフィールド名が示されます。
- CSV データ (エンリッチ要求) 列には、.csv ファイルのデータが表示されます。
- 連絡先 B 列は、Genesys Cloud でキュレーションされた連絡先です。
- The Contact C column is a curated contact in Genesys Cloud
- The Updated Contact C column is the merged contact after completion of the import.
- 説明列には、連絡先 D 列のデータがどのようにインポートされたかが説明されています。
フィールド名 | CSV データ (エンリッチ リクエスト) | 連絡先B | 連絡先C | 連絡先Cを更新しました | 説明 |
---|---|---|---|---|---|
外部 ID | 123AABC | 123AABC |
.csv レコードの外部 ID は、連絡先 C レコードの主な識別子として強化されます。 古い .csv インポートで使用されていたアカウント ID は、連絡先レコードでは使用されなくなり、表示されなくなりました。 |
||
名 | トム | トミー | トム | トム | 衝突がなければ、変化もない。 |
middleName | T | .csv のデータを使用して連絡先 C を更新します。 | |||
姓 | 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 のデータで更新されます。 | |
自宅電話 | 更新がなければ、連絡に価値はありません。 | ||||
その他電話 | 更新がなければ、連絡に価値はありません。 |
In this example, some contacts are identified, and some contacts are curated.
連絡先には次の 3 つの種類があります。
- はかない:クライアント側の Web 識別子または Cookie に関連付けられているが、その他の情報を持たない自動生成された連絡先。つまり、Web Cookie/クライアント側識別子が指す空の連絡先です。有効期間 (TTL) は 60 日間に制限されます。
- 特定された:非 Cookie の PII を持ち、60 日間の TTL 制限がある自動生成された連絡先。
- キュレーション:エージェントまたは API 呼び出しによって作成または_昇格_された連絡先。TTL制限はありません。
Ephemeral and identified contacts are system-generated and do not appear in search APIs, reverse-whitepages lookups, or scans.
システム内で次の 2 つの連絡先が一致します。
- 連絡先 B (キュレーション)
- 連絡先C(特定済み)
一括インポート プロセス中に、インポート プロファイル画面で次のオプションが選択されました。
- 連絡先の一致:外部 ID、電子メール アドレス、電話番号。
- 一致した連絡先を統合する:一致したすべての連絡先を結合して更新します。
この例では、検索される識別子の順序は次のとおりです。
- ExternalID:123AABC
- email: johnny@gmail.com
- 電話番号: null
.csv ファイルの個人メール フィールドは連絡先 C の他のメール フィールドと一致し、CSV の勤務先電話番号は連絡先 B の携帯電話と一致します。
次の表では、
- フィールド名列には、.csv ファイル内のフィールド名が示されます。
- CSV データ (エンリッチ要求) 列には、.csv ファイルのデータが表示されます。
- 連絡先 B 列は、Genesys Cloud でキュレーションされた連絡先です。
- 連絡先 C 列は、Genesys Cloud で識別された連絡先です。
- 連絡先 D 列は、インポート完了後に結合された連絡先です。
- 説明列には、連絡先 D 列のデータがどのようにインポートされたかが説明されています。
フィールド名 | CSV データ (エンリッチ リクエスト) | 連絡先B | 連絡先C | 連絡先D | 説明 |
外部 ID | 123AABC | 123AABC | .csv レコードの外部 ID は、マージされた連絡先 D レコードの主な識別子として強化されます。 | ||
名 | Johnny | Johnny | 競合があるため、識別された連絡先の値が使用されます。 | ||
middleName | マシュー | M | マシュー | 矛盾があるため、最新のキュレーションされた連絡先が使用されます。 | |
姓 | バンクスIV | 銀行 | バンクスIV | バンクスIV | 競合があるため、識別された連絡先の値が使用されます。 |
タイトル | ジョニーボーイ | .csv インポートでは null 値は使用されません。連絡先Cの値が使用されます。 | |||
salutation | Mr | .csv インポートでは null 値は使用されません。連絡先Bの値が使用されます。 | |||
work Email | Banks@gmail.com | Banks@gmail.com | Emails are handled carefully during merges to avoid data loss. Therefore although the .csv data’s work email is null, Genesys Cloud preserves the work Email from Contact B after the merge and place it in Work Email for the merged Contact D. | ||
personal Email | johnny@gmail.com | johnny@gmail.com | .csv からの個人メールは連絡先 C の他のメールと一致します。 .csv の値は、結合された連絡先 D の個人メールに使用されます。 |
||
その他メール | johnny@gmail.com | johnny@gmail.com | Emails are handled carefully during merges to avoid data loss. Therefore although the .csv data’s work email is null, Genesys Cloud preserves the other Email from Contact C after the merge and place it in other Email for the merged Contact D. | ||
cell Phone | 更新がなければ、連絡に価値はありません。 | ||||
work Phone | 更新がなければ、連絡に価値はない | ||||
自宅電話 | 更新がなければ、連絡に価値はありません。 | ||||
その他電話 | 更新がなければ、連絡に価値はない |