以 CSV 格式创建列表

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

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

    必填列

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

    电话
    317-123-4567

    注意: 格式化字符将被忽略,但带有 E.164 格式化数字的前导加号 (+) 除外。

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

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

    不要超过 50 列

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

    规则名称必须唯一。

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

    包含唯一标识符列

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

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

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

    不要在唯一标识符中使用特殊字符

    您可以使用字母数字字符组成唯一标识符。 空格反斜杠和这些特殊字符不适用于 URL:

    – . _ ~ : / ? # [ ] @ ! $ & ‘ ( ) * + , ; =

    使用区域列

    联系人列表记录通常为每个联系人存储多个电话号码,例如工作号码、手机号码和家庭号码。 要使用 可呼叫时间 功能,每个电话号码列必须有一个对应的时区列,其中包含 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"
    
    
    注意: 如果您在为短信营销活动创建 CSV 列表时使用 Excel 作为电子表格应用程序,则电话号码列必须采用 E.164 格式。 对于电话号码列,使用 Excel 自定义 格式,并使用 +#?/? 数字格式代码。 如果您未指定自定义格式,则 Excel 默认格式会删除 “+” 前缀。