LookWorldPro 群发名单最关键的要求是：上传 UTF-8 编码的 .csv 或 .xlsx 文件，必须包含标准表头（例如 recipient_id、email、phone、country、language、consent 等），手机号使用 E.164 国际格式，邮件地址要合法且去重，模板变量列名需与消息模板严格对应，日期用 ISO 格式（YYYY-MM-DD），文件大小与行数遵循后台限制，上传前先用小样本做测试发送并查看错误报告与校验提示。
为什么这些格式细节很重要（用最简单的话说）
想象你把一大箱信件放到传送带上，如果信封上地址写得乱七八糟，机器就分不清哪封寄哪里。群发名单也是一样：标准化的字段、统一的编码和明确的手机号/邮件规则，能让系统自动化准确地把消息送到目标，同时避免退信、违规或法律风险。
总体要求概览
- 文件类型：优先 .csv（逗号分隔）或 .xlsx（Excel）。
- 字符编码：UTF-8（无 BOM 优先），避免乱码。
- 表头必须存在且清晰：建议英文短名，如 recipient_id、email、phone、country 等。
- 必须字段与可选字段：核心字段需完整，否则会导致拒绝上传或后续发送失败。
- 数据规范：手机号用 E.164、邮件格式合法、日期用 YYYY-MM-DD、国家用 ISO2/ISO3 等。
- 合规字段：用户同意（consent）、退订标识（opt_out）等必须明确。
- 文件大小与接口限制：按平台后台要求分批上传，避免单次超限。
文件格式与编码细节
- .csv：使用逗号作为分隔符，字段含逗号时需用双引号包裹。
- .xlsx：建议仅含一个工作表（sheet），不要合并单元格或使用公式。
- 编码：强制 UTF-8，若使用 Excel 导出 CSV，请注意保存为 UTF-8 编码；避免使用系统默认 ANSI 编码导致中文乱码。
必填字段与可选字段（推荐表头）
下面的表格给出常见字段、类型及说明，按表头名称上传能最大限度减少解析错误：
| 字段名 | 类型 | 说明 | 示例 |
| recipient_id | 字符串/唯一 | 内部识别 ID，建议不重复 | uid_000123 |
| 字符串 | 收件人邮箱（如有邮件渠道） | [email protected] | |
| phone | 字符串 | 国际格式手机号，建议 E.164（含国家码） | +8613812345678 |
| country | 字符串 | 国家代码，建议 ISO 3166-1 alpha-2（CN、US） | CN |
| language | 字符串 | 首选语言代码，如 en、zh、es | zh |
| consent | 布尔/字符串 | 是否同意接收，值示例：true/false 或 1/0 | true |
| opt_out | 布尔/字符串 | 已退订标识，若已退订则不发送 | 0 |
| first_name / last_name | 字符串 | 用于模板个性化，占位符映射字段 | Li / Hua |
字段格式细节与校验规则
- Email：需符合 RFC 5322 常规格式，建议预先做简单正则校验（包含 @ 和域名部分），并删除明显无效的地址。
- Phone：统一使用 E.164（先写 + 再国家码和号码，不含空格或括号），例如 +441632960960。国内号码 +86 开头。
- Country：尽量使用 ISO 3166-1 alpha-2（两字母），便于分区与法律合规判断。
- Date：所有日期字段采用 ISO 8601（YYYY-MM-DD）以减少时区/解析问题。
- 占位符/模板字段：表头中占位符列（如 first_name）必须与消息模板中的变量名一致，否则会出现空值或占位失败。
上传大小、行数与分批原则
不同平台限制不同，通用建议：
- 单文件大小控制在 10–50MB 内（如超过，建议拆分为多个批次上传）。
- 行数上限常见为 50k–200k 行；若人群大，采用分片上传或 API 批量接口。
- 对于超过限制的数据，用分批编号（batch_id）便于回溯与重试。
重复与冲突处理规则
- 平台通常会基于 primary key（如 recipient_id）或 contact（email/phone）去重；建议事先在本地去重并保留最新记录。
- 如上传有冲突，系统应返回错误报告（哪些行失败，原因是什么），根据报告修正后重新上传。
- 若同时存在 email 与 phone，平台会根据渠道偏好或优先级使用指定字段。
合规与隐私（不能忽视）
- 必须记录并上传用户的同意信息（consent），包含同意来源和时间（如果可用）。
- 遵守目标市场相关法规（如 GDPR、CAN-SPAM 等），保留退订和拒绝名单并在上传时排除这些联系人。
- 敏感数据（身份证、银行卡等）不要上传到群发列表。
常见上传错误与自检清单
上传前快速检查清单（一定要做）：
- 确认文件为 UTF-8 编码并保存为 .csv 或 .xlsx。
- 表头拼写与模板变量一致（大小写敏感时按要求）。
- 手机号为 E.164、邮箱格式正确、没有多余空格或特殊字符。
- 没有合并单元格、公式或隐藏列，删除空行。
- 包含同意标识并排除退订用户。
- 先上传一个小样本（100–500 条）做测试发送，查看回执与错误。
示例：标准 CSV 首行与三条样例
下面是一个简短的 CSV 示例头部（逗号分隔），便于直接复制到你的表格工具里做测试：
| recipient_id,email,phone,country,language,consent,first_name |
| uid_001,[email protected],+8613812345678,CN,zh,true,Li |
| uid_002,[email protected],+14165551234,US,en,true,Anna |
| uid_003,,+442071838750,GB,en,false,Tom |
上传后的校验与异常处理
理想流程是：上传 → 系统做语法与必填字段校验 → 返回错误/警告清单 → 人员修正 → 提交正式发送。关注点包括：邮件退信率、手机号格式错误行、重复联系人列表、以及因合规被屏蔽的国家或号码段。
关于自动化与 API 集成的建议
- 若你频繁导入大量名单，优先使用平台 API 上传并做分批/重试逻辑。
- 把上传前的校验逻辑（邮箱/手机号/必填字段/同意）放在你的系统里自动化，减少人工干预。
- 保持日志：每次上传保存文件名、行数、上传人和时间，便于查询与审计。
好了，就这些主要点。你如果手头有一个具体的名单文件，可以先把小样本准备好（前 100 条），按上面表头和格式调整一次，上传测试看看系统返回的错误，再细化调整——这样通常能省下很多来回修正的时间。我这边边想边写，漏了什么你提醒我也行，咱再把格式对齐到你实际后台的提示。