以 CSV 格式创建列表

通过上传逗号分隔值 (.csv) 格式的记录来创建列表。 设置您想要符合的数据格式.csv 语法在上传或附加到列表之前以 UTF-8 编码：

• 每条记录都是由换行符或回车符/换行符对终止的一行。
• 列名不能包含特殊字符，例如反斜杠。
• 使用逗号分隔数据项（称为字段）。
• 第一行必须是用逗号分隔的字段名称的标题行。
• 将包含空格或逗号的字段用双引号括起来。
• 用双引号将包含前导或尾随空格的字符串括起来。
• 如果字段为空，请在记录中的该位置插入逗号。
• 将包含逗号的字段括在一对双引号字符内。 例如，“名字、姓氏”、“电话号码”、“地址”。
• 如果字段包含双引号，请将整个字段用双引号括起来，然后将每个双引号字符转换为两个双引号字符。
• .csv 文件不得在数据末尾包含任何空行，这可能会导致导入失败。

必填列

.csv 文件至少必须包含一列电话号码。 例如，单列适用于 “请勿联系” 列表：

大多数联系人列表需要更多列，例如联系人姓名或账户代码。 请务必在 .csv 文件中定义所需的所有列。

当您上传文件以创建新列表时，系统会在云中创建一个包含匹配列的表。 之后，您无法追加包含不同列集的数据。

不要超过 50 列

联系人列表中允许的最大列数为 50。 如果此新联系人列表超过该限制，但事件查看器中没有为其显示条目，则会显示一条错误消息。

规则名称必须唯一。

第一行中的所有列名必须是唯一的。 如果复制列名称，则不会导入该文件。

包含唯一标识符列

在 .csv 中包含唯一标识每一行的列。 这样做可以确保将来可以准确地附加新的或更新的数据。 典型的唯一标识符是客户的 ID 或账号。 稍后，当您 将记录 附加到联系人列表时，请选择 “唯一标识符” 列。 使用该列，追加过程可以最准确地将传入的数据与现有联系人进行匹配。

如果没有唯一标识符，整行就是主键。 如果追加修改过的记录，即使现有行具有相同的标识符，后续上载也会将该记录作为新行附加。 这种行为不是人们在导出列表、更改列表然后追加（上传）数据时所期望的。

当您使用唯一标识符时，系统会替换现有记录。

使用区域列

联系人列表记录通常为每个联系人存储多个电话号码，例如工作号码、手机号码和家庭号码。 要使用 可呼叫时间 功能，每个电话号码列必须有一个对应的时区列，其中包含 Tz 数据库 格式的区域名称。 例如，名为 “家庭时区” 的列包含与 “家庭电话” 列中每个号码对应的时区。 顺便说一句，请勿联系人列表不使用区域列。

• 作为最佳做法，在创建联系人列表时，请指定与每个电话号码列（例如，家庭或办公室）对应的唯一 ID 和区域列。

• 以后无法添加区域列，但可以通过附加（上传）具有相同唯一 ID 的记录来填充或更新现有区域列。 当 Genesys Cloud 找到匹配的行时，它会使用追加文件中的数据更新列。 例如，系统使用从 .csv 文件读取的时区数据更新记录中的任何区域列。 区域列必须存在。

• 将每个时区列与联系电话列相关联，通常在创建列表时这样做。 如果忘记了，可以稍后编辑联系人列表，并通过从时区列下拉列表中进行选择，将其时区列映射到电话号码列。

  

不要删除前导和尾随的空格

保存联系人列表时，将从联系人列表的联系人字段中删除前导和尾随空格。 如果您不想从联系人列表中删除空格，请切换修剪前导/尾随空白切换到不。

使用电子表格而不是文本编辑器来编辑 .csv 文件

我们建议您从电子表格编辑器中另存为 .csv。 当电子表格保存 .csv 文件时，它会自动插入所需的引号和逗号。 与手动设置记录格式相比，使用电子表格不容易出错。

例如，Microsoft Excel 中的 “ 文件 ” > “ 另存为” > “ CSV（逗号分隔）” 命令会生成以下 .csv 记录：

Last Name, First Name,Home Phone, Home Time Zone,Cell Phone,Cell Time Zone,Balance Due,Account Code,HomeAddress
Doe,"James ""Big John""",317-123-4567,America/Indiana/Indianapolis,317-987-6543,America/Indiana/Indianapolis,175,1003,"123 Anystreet, Indianapolis, IN"
Downing,Mary,424-999-2334,America/Los_Angeles,,,234,3799,"724 Bel Air Drive, Los Angeles, CA"