处理源 .csv 文件中的数据

外部 ID 是 Genesys Cloud 的导入流程用于确定唯一联系人。该字段有助于识别联系人，以便您可以通过同一个电子表格轻松更新现有联系人。对于每个唯一的外部 ID，导入过程都会创建一个 Genesys Cloud 外部联系人记录。导入过程将行中的所有联系人字段导入到相应的 Genesys Cloud 外部联系人记录。

散装 33

创建外部 ID 时，您可以使用任意字母和数字的组合。例如，您可以使用 CRM 或 ERP 系统中的唯一标识符，也可以创建对您有意义的复合键。它可以是您想要用来识别记录的任何外部 ID，只要它满足 255 个字符的限制。如果您的 .csv 是从 CRM 中提取的，我们建议使用来自 CRM 的唯一标识符 (UUID)。UUID 允许在即将推出的功能更新中同步来自 CRM 的联系人。

如果您只打算导入记录一次，则可以使用所需的任何外部 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，以避免创建重复记录。

例如，如果您导入一个电子表格，其中的一条记录使用“A”作为外部 ID，然后重新导入同一张电子表格，并使用“B”作为该记录的外部 ID，则 Genesys Cloud 会创建一条记录，而不是更新现有记录。要更新现有记录，请始终使用相同的外部 ID。

Notes: Phone numbers must be in E.164 format to sync call and SMS interactions with that phone numbers.

外部组织

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.

散装 32

创建外部组织外部 ID 时，您可以使用任意字母和数字组合。您可以创建一个对您有意义的组合键，只要满足 255 个字符的限制。如果您的 .csv 是从 CRM 中提取的，我们建议使用来自 CRM 的唯一标识符 (UUID)。UUID 允许在即将推出的功能更新中同步来自 CRM 的联系人。

将外部联系人与外部组织关联

要将外部联系人与外部组织关联，请在 .csv 源文件的同一行中输入他们。

注意： 在以下示例中，某些字段已调整大小或隐藏。

在这个例子中，Angus Reid 是 Phoenix Foundation II 的问题解决者。导入过程会创建 Phoenix Foundation II 的外部组织记录和 Angus Reid 的外部联系人记录。在外部联系人中，安格斯·里德 (Angus Reid) 作为凤凰基金会 II 组织的外部联系人出现。 

散装 34

关联多个外部 联系人与一个 外部 组织

将多个外部联系人与一个联系人关联外部的组织，为所有外部组织分配相同的外部组织外部 ID。 

注意： 在以下示例中，某些字段已调整大小或隐藏。

在此示例中，凯瑟琳、乔希和丽贝卡都是 Office Mart 组织的联系人。

散装 35

注释：
  • 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、电话号码和电子邮件地址
  • 合并匹配的联系人：合并并更新所有匹配的联系人

在此示例中，搜索的标识符的顺序为：

  1. 外部ID：123AABC
  2. 电话：+1 919 432 5523
  3. email: tom.sellenta@sag.aftra.com

.csv 中的工作电话与联系人 C 的手机号码匹配。创建一个新的合并的 ContactD。

在下表中，

  • 字段名称列表示.csv文件中的字段名称。
  • CSV 数据（丰富请求）列表示来自 .csv 文件的数据。
  • 联系人 B 列是 Genesys Cloud 中精选的联系人。
  • 联系人 C 列是 Genesys Cloud 中精选的联系人。
  • 联系人D列是导入完成后合并的联系人。
  • 解释列描述了联系人 D 列数据是如何导入的。 
字段名称 CSV 数据（丰富请求） 联系方式 联系 C 联系人 D（合并联系人） 解释
外部 SIP 123AABC 123AABC .csv 记录中的外部 ID 作为其主要标识符丰富了合并的记录。旧的 .csv 导入所使用的联系人 ID 不再使用或显示在联系人记录中。
名字 汤姆 汤米 汤姆 汤姆 数据冲突，合并的联系人保留.csv 文件中的最新数据。
middleName 四 四 无冲突
姓氏 Selleck 塞尔克 Selleck 数据冲突，合并的联系人保留.csv 文件中的最新数据。
标题 问题解决者 问题解决者 使用来自联系人 C 的值。
salutation 先生 先生。 先生 数据冲突，合并的联系人保留.csv 文件中的最新数据。
工作邮箱 tom.selleck@sag.aftra.com tom@gmail.com tom.selleck@sag.aftra.com tom.selleck@sag.aftra.com 数据冲突，合并的联系人保留.csv 文件中的最新数据。
个人电邮 tom@hotmail.com tommy@yahoo.com tom@gmail.com 合并过程中会小心处理电子邮件和电话号码，以避免数据丢失。如果两个联系人使用相同的字段（例如，workEmail），则数据将移动到另一个可用字段（例如，personalEmail 或 otherEmail）。

在这个例子中，“tom@gmail.com”从workEmail移到personalEmail而不是将其删除。该过程不断重复，直到所有可能的字段都被使用。如果没有更多可用字段，则会删除数据。 
其他邮箱 tommy@hotmail.com 特定的字段名称并不重要，并且尽可能保留合并联系人的数据。如果没有可供重定位的字段，数据将被删除。 
手机 +1 919 432-5523 .csv 中的工作电话与联系人 C 的手机电话相匹配。导入.csv 数据的手机号（本例中为空）后，该字段将会更新。
工作电话 +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 之前）

  1. 外部ID：123AABC
  2. 电子邮件：tom.selleck@sag.aftra.com
  3. 电话：+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 数据（丰富请求） 联系方式 联系 C 更新联系人 C 解释
外部 SIP 123AABC 123AABC

.csv 记录中的外部 ID 作为其主要标识符丰富了联系人 C 记录。

旧的 .csv 导入所使用的帐户 ID 不再使用或显示在联系人记录中。
名字 汤姆 汤米 汤姆 汤姆 没有冲突就没有改变。
middleName 四 使用 .csv 中的数据更新联系人 C。
姓氏 Selleck 塞尔克 Selleck 冲突。使用 .csv 中的数据更新联系人 C。
标题 问题解决者 问题解决者 由于未选中导入字段，因此没有更新。
salutation 先生 先生。 先生 冲突。使用 .csv 中的数据更新联系人 C。
工作邮箱 tom.selleck@sag.aftra.com tom@gmail.com tom.selleck@sag.aftra.com tom.selleck@sag.aftra.com

.csv 中的工作电子邮件与联系人 C 的工作电子邮件匹配。

导入后此联系人会更新，而联系人 B 保持不变，因为它不是第一个匹配的联系人，而联系人 C 是第一个匹配的联系人。
个人电邮 tommy@yahoo.com tom@yahoo.com 由于未选择导入字段，因此没有更新。
其他邮箱 没有更新，任何联系都没有任何价值。
手机 +1 317 845-1232 +1 317 845-1232 由于未选择导入字段，因此没有更新。
工作电话 +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.

联系人可以是以下三种类型之一：

  • 短暂的：自动生成的联系人与客户端网络标识符或 cookie 相关联，但没有其他信息。换句话说，它是一个空的联系人，网络 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.

系统中匹配以下两个联系人：

  • 联系 B（精选）
  • 联系人 C（已确认）

在批量导入过程中，在导入配置文件屏幕中选择了以下选项：

  • 匹配联系人：外部 ID、电子邮件地址和电话号码。
  • 合并匹配的联系人：合并并更新所有匹配的联系人。

在此示例中，搜索的标识符的顺序为：

  1. ExternalID:123AABC
  2. 邮箱: johnny@gmail.com
  3. 电话： 空

.csv 文件中的个人电子邮件字段与联系人 C 的其他电子邮件字段匹配，而 CSV 中的工作电话与联系人 B 的手机号码匹配。

在下表中，

  • 字段名称列表示.csv文件中的字段名称。
  • CSV 数据（丰富请求）列表示来自 .csv 文件的数据。
  • 联系人 B 列是 Genesys Cloud 中精选的联系人。
  • 联系人 C 列是 Genesys Cloud 中已识别的联系人。
  • 联系人D列是导入完成后合并的联系人。
  • 解释列描述了联系人 D 列数据是如何导入的。 
字段名称 CSV 数据（丰富请求） 联系方式  联系 C 联系 D 解释
外部 SIP 123AABC 123AABC .csv 记录中的外部 ID 作为其主要标识符丰富了合并联系人 D 记录。
名字 约翰尼 Johnny 由于存在冲突，因此使用已识别联系人的值。
middleName 马修 一 马修 由于存在冲突，最新精选联系人被使用。
姓氏 Banks IV 银行 Banks IV Banks IV 由于存在冲突，因此使用已识别联系人的值。
标题 约翰尼男孩 .csv 导入中不使用空值。使用联系人 C 的值。
salutation Mr .csv 导入中不使用空值。使用联系人 B 的值。
工作邮箱 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.
个人电邮 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.
手机 没有更新，任何联系都没有任何价值。
工作电话 没有更新，任何联系都没有价值
家庭电话 没有更新，任何联系都没有任何价值。
其他电话 没有更新，任何联系都没有价值