以 CSV 格式创建列表

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

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

必填列

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

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

不要超过 50 列

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

规则名称必须唯一。

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

包含唯一标识符列

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

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

使用区域列

Contact list records often store multiple phone numbers per contact, such as work, cell, and home numbers. To use the callable times feature, each phone number column must have a corresponding time zone name column which contains the zone name in Tz database format . For example, a column named Home Time Zone to contain the time zone corresponding to each number in the Home Phone column. Note that zone columns are not used in Do Not Contact lists.

• As a best practice, specify both a unique Id and a time zone name column corresponding to each phone number column–for example, home or work–when you create a contact list.
• You cannot add time zone name columns later, but you can populate or update existing zone name columns by appending–uploading–records that have the same unique ID. When Genesys Cloud finds a matching row, it updates columns using data in the append file. For example, the system updates any zone name columns in a record with time zone data read from the .csv file. The zone name columns must exist.
• Associate each time zone name column with a contact number column when you create a list. You can also edit the contact list later, and map its time zone columns to phone number columns by selecting from the time zone column dropdown list.
  

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

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

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

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

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