处理源 .csv 文件中的数据
外部 ID 是 Genesys Cloud 的导入流程用于确定唯一联系人。该字段有助于识别联系人，以便您可以通过同一个电子表格轻松更新现有联系人。对于每个唯一的外部 ID，导入过程都会创建一个 Genesys Cloud 外部联系人记录。导入过程将行中的所有联系人字段导入到相应的 Genesys Cloud 外部联系人记录。
创建外部 ID 时，您可以使用任意字母和数字的组合。例如，您可以使用 CRM 或 ERP 系统中的唯一标识符，也可以创建对您有意义的复合键。它可以是您想要用来识别记录的任何外部 ID，只要它满足 255 个字符的限制。如果您的 .csv 是从 CRM 中提取的，我们建议使用来自 CRM 的唯一标识符 (UUID)。UUID 允许在即将推出的功能更新中同步来自 CRM 的联系人。
如果您只打算导入记录一次，则可以使用所需的任何外部 ID。 系统会生成与这些外部 ID 对应的内部 ID。
- 如果您之前已使用老的批量导入过程中，系统仅使用电话或电子邮件地址标识符来匹配和更新您的联系人与新的外部 ID。
- 为了成功合并现有联系人与新记录，当您执行 .csv 批量导入时，.csv 文件中的所有电话号码都必须遵循E.164 格式通过电话匹配时。
- 如果 .csv 文件中的电话号码不符合 E.164 格式，则导入过程触发警告。虽然导入过程会继续导入联系人，但无法保证身份解析算法能够根据电话号码准确匹配和合并联系人。
- 如果您的旧联系人没有与新 .csv 文件中的电子邮件或电话匹配的电子邮件或电话号码，系统将在 .csv 中使用您指定的外部 ID 创建一条记录。
- 如果联系人的信息在同一个文件中重复多次，则该联系人会更新多次，并且导入的行数计数器会反映重复情况。然而，更新发生的顺序无法保证。
更新先前导入的联系人时，请确保使用相同的外部 ID，以避免创建重复记录。
例如，如果您导入一个电子表格，其中的一条记录使用“A”作为外部 ID，然后重新导入同一张电子表格，并使用“B”作为该记录的外部 ID，则 Genesys Cloud 会创建一条记录，而不是更新现有记录。要更新现有记录，请始终使用相同的外部 ID。
外部组织
T外部组织外部 ID是关键字段，导入过程使用该字段来确定唯一组织。 对于每个唯一的外部组织外部 ID，导入过程都会创建一个 Genesys Cloud 外部组织记录。导入过程将行中的所有帐户字段导入到相应的 Genesys Cloud 外部组织记录。
创建外部组织外部 ID 时，您可以使用任意字母和数字组合。您可以创建一个对您有意义的组合键，只要满足 255 个字符的限制。如果您的 .csv 是从 CRM 中提取的，我们建议使用来自 CRM 的唯一标识符 (UUID)。UUID 允许在即将推出的功能更新中同步来自 CRM 的联系人。
将外部联系人与外部组织关联
要将外部联系人与外部组织关联，请在 .csv 源文件的同一行中输入他们。
在这个例子中，Angus Reid 是 Phoenix Foundation II 的问题解决者。导入过程会创建 Phoenix Foundation II 的外部组织记录和 Angus Reid 的外部联系人记录。在外部联系人中，安格斯·里德 (Angus Reid) 作为凤凰基金会 II 组织的外部联系人出现。
关联多个外部 联系人与一个 外部 组织
将多个外部联系人与一个联系人关联外部的组织，为所有外部组织分配相同的外部组织外部 ID。
在此示例中，凯瑟琳、乔希和丽贝卡都是 Office Mart 组织的联系人。
- 如果多行共享一个外部组织外部 ID，则所有组织特定字段必须相同（例如，帐户名称），并且 Genesys Cloud 为所有相关联系人创建一个外部组织。Genesys Cloud 每个外部 ID 仅导入一行，为所有相关联系人创建一个外部组织，并且不保证使用哪一行。如果各行之间存在差异，则将单独发送每一行以更新外部组织。
- 您不能使用 .csv 文件将成员导入手动创建的组织。
批量导入过程如何管理合并操作
在此示例中，仅导入联系人，并假设 .csv 文件中的所有外部联系人组织字段都为空。
在批量导入过程中，在导入配置文件屏幕中选择了以下选项：
- 匹配联系人：外部 ID、电话号码和电子邮件地址
- 合并匹配的联系人：合并并更新所有匹配的联系人
在此示例中，搜索以下标识符：
- 外部ID：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 数据（丰富请求） | 联系方式 | 联系 C | 联系人 D（合并联系人） | 解释 |
|---|---|---|---|---|---|
| 外部 SIP | 123AABC | 123AABC | .csv 记录中的外部 ID 作为其主要标识符丰富了合并的记录。旧的 .csv 导入所使用的联系人 ID 不再使用或显示在联系人记录中。 | ||
| 名字 | 汤姆 | 汤米 | 汤姆 | 汤姆 | 数据冲突，合并的联系人保留.csv 文件中的最新数据。 |
| middleName | 四 | 四 | .csv 导入时不使用空值。使用联系人 C 的值。 | ||
| 姓氏 | 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 的手机电话相匹配。 | |||
| 工作电话 | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | 由于清除了导入字段复选框，因此联系人 C 的工作电话在导入后保持不变。 | |
| 家庭电话 | 没有更新，任何联系都没有任何价值。 | ||||
| 其他电话 | 没有更新，任何联系都没有价值 |
此示例仅导入联系人。假设 .csv 文件中的外部组织字段为空。
在批量导入过程中，在导入配置文件屏幕中选择了以下选项：
- 匹配联系人依据：外部 ID、电子邮件地址、电话
- 合并匹配的联系人：仅更新第一个匹配的联系人
在此示例中，搜索的标识符的顺序为：（电子邮件 ID 在 ExternalID 之前）
- 外部ID：123AABC
- 电子邮件：tom.selleck@sag.aftra.com
- 电话：+1 919 432-5523
.csv 中的工作电子邮件与联系人 C 的工作电子邮件匹配，工作电话与联系人 B 的手机匹配。由于未选择合并并更新所有匹配的联系人选项，导入后只有联系人 C 会更新，而联系人 B 保持不变，尽管两个联系人都部分匹配 CSV 数据。
在下表中，
- 字段名称列表示.csv文件中的字段名称。
- CSV 数据（丰富请求）列表示来自 .csv 文件的数据。
- 联系人 B 列是 Genesys Cloud 中精选的联系人。
- 联系人 C 列是 Genesys Cloud 中精选的联系人
- 其中Updated Contact C列是导入完成后的数据。
- 解释列描述了联系人 D 列数据是如何导入的。
| 字段名称 | CSV 数据（丰富请求） | 联系方式 | 联系 C | 更新联系人 C | 解释 |
|---|---|---|---|---|---|
| 外部 SIP | 123AABC | 123AABC |
.csv 记录中的外部 ID 作为其主要标识符丰富了联系人 C 记录。 旧的 .csv 导入所使用的帐户 ID 不再使用或显示在联系人记录中。 |
||
| 名字 | 汤姆 | 汤米 | 汤姆 | 汤姆 | 没有冲突就没有改变。 |
| middleName | 四 | 四 |
.csv 没有 middleName 的值，但联系人 C 有。 因此，联系人 C 的 middleName 值不会改变。 |
||
| 姓氏 | 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 中的数据进行更新。 | |
| 家庭电话 | 没有更新，任何联系都没有任何价值。 | ||||
| 其他电话 | 没有更新，任何联系都没有任何价值。 |
在这个例子中，一些联系人被识别，一些联系人被整理。
联系人可以是以下三种类型之一：
- 短暂的：自动生成的联系人与客户端网络标识符或 cookie 相关联，但没有其他信息。换句话说，它是一个空的联系人，网络 cookie/客户端标识符指向它。它们的生存时间 (TTL) 限制为 60 天。
- 已识别：自动生成的联系人具有非 cookie PII，并且具有 60 天的 TTL 限制。
- 精选：由代理或 API 调用创建或_提升_的联系人。它们没有 TTL 限制。
临时联系人和已识别联系人是由系统生成的，不会出现在搜索 API、反向白页查找或扫描中。
系统中匹配以下两个联系人：
- 联系 B（精选）
- 联系人 C（已确认）
在批量导入过程中，在导入配置文件屏幕中选择了以下选项：
- 匹配联系人：外部 ID、电子邮件地址和电话号码。
- 合并匹配的联系人：合并并更新所有匹配的联系人。
在此示例中，搜索以下标识符：
- ExternalID:123AABC
- 邮箱: 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 数据（丰富请求） | 联系方式 | 联系 C | 联系 D | 解释 |
| 外部 SIP | 123AABC | 123AABC | .csv 记录中的外部 ID 作为其主要标识符丰富了合并联系人 D 记录。 | ||
| 名字 | 约翰尼 | Johnny | .csv 导入时不使用空值。使用联系人 C 的值。 | ||
| middleName | 马修 | 一 | 马修 | 由于存在冲突，最新精选联系人被使用。 | |
| 姓氏 | Banks IV | 银行 | Banks IV | Banks IV | .csv 中的值在此具有优先权。 |
| 标题 | 约翰尼男孩 | 约翰尼男孩 | .csv 导入中不使用空值。使用联系人 C 的值。 | ||
| salutation | Mr | Mr | .csv 导入中不使用空值。使用联系人 B 的值。 | ||
| 工作邮箱 | Banks@gmail.com | Banks@gmail.com | .csv 导入中不使用空值。使用联系人 B 的值。 | ||
| 个人电邮 | johnny@gmail.com | johnny@gmail.com | .csv 中的个人电子邮件与联系人 C 的其他电子邮件匹配。 .csv 中的值用于合并的联系人 D 的个人电子邮件。 |
||
| 其他邮箱 | johnny@gmail.com |
.csv 中的个人电子邮件与联系人 C 的其他电子邮件相匹配。 在这种情况下，合并联系人的其他电子邮件保持为空由于个人电子邮件已经占用了该电子邮件地址，因此不会保存重复的电话或电子邮件值。 |
|||
| 手机 | +1 919 432-5523 |
.csv 中的工作电话与联系人 B 的手机电话相匹配。 在这种情况下，合并联系人的手机号码保持为空，因为工作电话已经占用了这个电话号码值，并且重复的电话或电子邮件值不会被保存。 |
|||
| 工作电话 | +1 919 432-5523 | +1 919 432-5523 | .csv 中的工作电话与联系人 B 的手机电话相匹配。 | ||
| 家庭电话 | 没有更新，任何联系都没有任何价值。 | ||||
| 其他电话 | 没有更新，任何联系都没有价值 |
