以 CSV 格式创建列表

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

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

必填列

.csv 文件至少必须包含一列电话号码。例如，“请勿联系”列表的单个列可能如下所示：

定义 .csv 文件所需的所有列，例如联系人姓名和帐户代码。当您上传.csv 文件来创建新列表时，系统会在云中创建一个包含匹配列的表。创建此表后，您无法附加包含不同列集的数据。 

不要超过 50 列

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

规则名称必须唯一。

第一行的所有列名必须是唯一的。如果重复列名，则文件无法导入。

包含唯一标识符列

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

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

使用区域列

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

• 作为最佳实践，在创建联系人列表时，请指定唯一的 ID 和与每个电话号码列相对应的区域列（例如，家庭或工作）。
• 您以后无法添加区域列，但您可以通过附加（上传）具有相同唯一 ID 的记录来填充或更新现有的区域列。当 Genesys Cloud 找到匹配的行时，它会使用追加文件中的数据更新列。例如，系统使用从 .csv 文件读取的时区数据更新记录中的任何区域列。区域列必须存在。
• 将每个时区列与一个联系电话列关联，这通常在创建列表时执行。如果您忘记了，您可以稍后编辑联系人列表，并通过从时区列下拉列表中选择将其时区列映射到电话号码列。
  

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

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

使用电子表格程序编辑 .csv 文件

我们建议您使用电子表格程序而不是文本编辑器将其另存为 .csv。当电子表格保存 .csv 文件时，它会自动插入所需的引号和逗号。使用电子表格比手动格式化记录更不容易出错。

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