处理源 .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 中使用您指定的外部 ID 创建一条记录。
- 如果联系人的信息在同一个文件中重复多次，则该联系人会更新多次，并且导入的行数计数器会反映重复情况。然而，更新发生的顺序无法保证。
当使用新的批量导入流程更新先前导入的联系人时，请确保使用相同的外部 ID，以避免创建重复记录。
如果某个联系人的信息在文件中重复多次，则该联系人将更新多次，并且导入计数将反映重复情况。然而，更新发生的顺序无法保证。
例如，如果您导入一个电子表格，其中的一条记录使用“A”作为外部 ID，然后重新导入同一张电子表格，并使用“B”作为该记录的外部 ID，则 Genesys Cloud 会创建一条记录，而不是更新现有记录。要更新现有记录，请始终使用相同的外部 ID。
外部组织
电视外部组织外部 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 期望帐户数据在所有字段中都相同。例如，在具有相同外部组织外部 ID 的所有行中，帐户名称必须相同。当多行具有相同的外部组织外部 ID 时，导入过程仅导入其中一行帐户数据。Genesys 不保证流程会导入哪一行账户数据。它不一定是帐户行集中的第一行或最后一行。因此，所有行的帐户数据必须相同。
- 您不能使用 .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 | 四 | 四 | 无冲突 | ||
| 姓氏 | 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 | 由于未选中“导入字段”复选框，导入后联系人 C 的工作电话保持不变。 | |
| 家庭电话 | 没有更新，任何联系都没有任何价值。 | ||||
| 其他电话 | 没有更新，任何联系都没有价值 |
此示例仅导入联系人。假设 .csv 文件中的外部组织字段为空。
在批量导入过程中，在导入配置文件屏幕中选择了以下选项：
- 匹配联系人：外部 ID、电话号码和电子邮件地址
- 合并匹配的联系人：仅更新第一个匹配的联系人
在此示例中，搜索的标识符的顺序为：（电子邮件 ID 在 ExternalID 之前）
- 外部ID：123AABC
- 电子邮件：tom.selleck@sag.aftra.com
- 电话：+1 919 432-5523
.csv 中的工作电子邮件与联系人 C 的工作电子邮件匹配，工作电话与联系人 B 的手机匹配。由于未选择合并并更新所有匹配的联系人选项，导入后只有联系人 C 会更新，而联系人 B 保持不变，尽管两个联系人都与 CSV 数据部分匹配。
在下表中，
- 这字段名称column 表示.csv文件中的字段名称。
- 这CSV 数据（丰富请求）列表示来自.csv 文件的数据。
- 这联系方式列是 Genesys Cloud 中精选的联系人。
- 这联系 C列是 Genesys Cloud 中精选的联系人
- 这更新联系人 C列是导入完成后合并的联系人。
- 这解释列描述了如何导入联系人 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 中的数据进行更新。 | |
| 家庭电话 | 没有更新，任何联系都没有任何价值。 | ||||
| 其他电话 | 没有更新，任何联系都没有任何价值。 |
在这个例子中，一些联系人被识别，一些联系人被整理。根据定义，已识别的联系人尚未在系统中声明标识符。精选联系人在创建时已声明其标识符。
联系人可以是以下三种类型之一：
- 短暂的：自动生成的联系人与客户端网络标识符或 cookie 相关联，但没有其他信息。换句话说，它是一个空的联系人，网络 cookie/客户端标识符指向它。它们的生存时间 (TTL) 限制为 60 天。
- 已识别：自动生成的联系人具有非 cookie PII，并且具有 60 天的 TTL 限制。
- 精选：由代理或 API 调用创建或_提升_的联系人。它们没有 TTL 限制。
临时联系人和已识别联系人是由系统生成的，不会出现在搜索 API、反向白页查找或扫描中。
系统中匹配以下两个联系人：
- 联系 B（精选）
- 联系人 C（已确认）
在批量导入过程中，在导入配置文件屏幕中选择了以下选项：
- 匹配联系人：外部 ID、电子邮件地址和电话号码。
- 合并匹配的联系人：合并并更新所有匹配的联系人。
在此示例中，搜索的标识符的顺序为：
- ExternalID:123AABC
- 邮箱: johnny@gmail.com
- 电话： 空
.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 | 合并过程中会小心处理电子邮件以避免数据丢失。因此，尽管 .csv 数据的工作电子邮件为空，但我们仍会在合并后保留联系人 B 的工作电子邮件，并将其放置在合并后的联系人 D 的工作电子邮件中。 | ||
| 个人电邮 | johnny@gmail.com | johnny@gmail.com | .csv 中的个人电子邮件与联系人 C 的其他电子邮件匹配。 .csv 中的值用于合并的联系人 D 的个人电子邮件。 |
||
| 其他邮箱 | johnny@gmail.com | johnny@gmail.com | 合并过程中会小心处理电子邮件以避免数据丢失。因此虽然.csv数据的工作邮箱为空，但我们在合并后仍然保留联系人C的另一封邮箱，并将其放在合并后的联系人D的其他邮箱中。 | ||
| 手机 | 没有更新，任何联系都没有任何价值。 | ||||
| 工作电话 | 没有更新，任何联系都没有价值 | ||||
| 家庭电话 | 没有更新，任何联系都没有任何价值。 | ||||
| 其他电话 | 没有更新，任何联系都没有价值 |
外部联系人（旧导入流程）
联系人 ID 是必填的关键字段。 Genesys Cloud 的 导入流程 使用它来确定唯一的联系人。 它有助于识别联系人，以便您可以使用同一电子表格轻松更新现有联系人。 对于每个唯一的联系人 ID，导入过程都会创建一个 Genesys Cloud 外部联系人记录。 导入过程会将该行中的所有联系人字段导入到相应的 Genesys Cloud 外部联系人记录中。
创建联系人 ID 时，您可以使用字母和数字的任意组合。 例如，您可以使用 CRM 或 ERP 系统中的唯一标识符，也可以 创建对自己有意义的 复合密钥。 它可以是要用来唯一标识记录的任何 ID。
如果您只打算导入记录一次，则可以使用所需的任何外部 ID。 系统会生成与这些外部 ID 对应的内部 ID。
如果您之前已导入联系人并希望更新记录，请确保对现有联系人使用相同的联系人 ID。 否则，Genesys Cloud 会创建新记录，而不是更新现有记录。
例如，假设您有一个包含一条记录的电子表格，并以 A 作为联系人 ID 导入该电子表格。 稍后，您想通过重新导入同一电子表格来更新该记录。 该记录的联系人 ID 必须与上一次导入时的联系人 ID 相同。 相反，如果您使用 B 作为该记录的联系人 ID 重新导入电子表格，Genesys Cloud 将创建一条新记录，而不是更新现有记录。
外部组织
账户 ID 是导入过程用来确定唯一组织的 关键字段。 对于每个唯一的账户 ID，导入过程都会创建一个 Genesys Cloud 外部组织记录。 导入过程会将行中的所有帐户字段导入到相应的 Genesys Cloud 外部组织记录中。
创建账户 ID 时，您可以使用字母和数字的任意组合。 您可以创建对自己有意义的复合密钥。
将外部联系人与外部组织关联
要将外部联系人与外部组织关联，请在 .csv 源文件的同一行中键入这些联系人。
在这个例子中，凯瑟琳·史密斯是 Office Mart 的买家。 导入过程为 Office Mart 创建外部组织记录和凯瑟琳·史密斯的外部联系人记录。 在 “外部联系人” 中，凯瑟琳·史密斯以 Office Mart 组织的外部联系人的身份出现。
关联多个外部 联系人与一个 外部 组织
要将多个外部联系人与一个 外部 组织关联，请为他们分配相同的账户 ID。
在此示例中，凯瑟琳、乔希和丽贝卡都是 Office Mart 组织的联系人。
- 当导入过程遇到多个具有相同账户 ID 的行时，Genesys Cloud 希望所有字段中的帐户数据都相同。 例如，在具有相同账户 ID 的所有行中，“帐户名称” 必须相同。 当多行具有相同的账户 ID 时，导入过程仅导入其中一行帐户数据。 Genesys 不保证流程会导入哪一行账户数据。 它不一定是帐户行集中的第一行或最后一行。 因此，账户数据的所有行必须相同。
- 您不能使用 .csv 文件将成员导入手动创建的组织。
