LookWorldPro 在群发名单上最看重的是“结构清晰、联系方式规范、编码统一以及合规证明”。常见接受 CSV、XLSX、JSON 等格式，建议 UTF-8 编码；手机号最好用国际 E.164（如 +8613712345678），邮箱去空并小写；第一行必须有列头（如 phone/email,name,locale,group,consent,vars）；至少包含联系方式和同意/退订字段；变量占位要与消息模板对应且逐条映射；避免重复、控制单批大小并做格式和合规校验；特殊字符、换行、引号要正确转义；媒体、附件和每条消息长度有上限；保留日志与退订记录以满足隐私法规。下面我把这些点拆开讲清楚，举例、给模板、还有常见错误和快速检查清单，方便你一次把名单准备好。
先搞清楚：为什么名单格式这么重要
嗯，说白了，名单就是“邮寄地址簿”，如果地址写错或者格式不对，邮件（或消息）就到不了人，或者平台直接拒收。再者，格式不对会花你大量时间反复修改，或触发平台风控（比如大量无效号码会被限流）。还有合规问题：没有用户同意的名单可能导致法律风险。把这些基本要素规范化，会让群发变得顺畅、可追踪、安全。
常见支持的文件类型与编码
- 推荐格式：CSV（最常见）、XLSX（Excel）、JSON（结构化数据导入）。
- 编码：必须使用 UTF-8（含 BOM 可选，但有的平台不接受 BOM，优先不加 BOM）。
- 字符集：名单中允许 Unicode 字符（姓名、国家/地区、语言等），不要使用平台不支持的控制字符。
核心字段（必备与推荐）
把名单想象成表格，第一行写列头，这是最关键的一步。下面是常见字段及说明：
- phone：手机号，优先 E.164（带“+”和国家码，不含空格或连字符）。示例：+8613712345678。
- email：电子邮箱，小写、无首尾空格。
- name：姓名或称呼，允许 Unicode。
- locale / language：语言或区域代码（如 zh-CN、en-US），用于模板语言选择。
- group / tag：分组标识，便于分类发送。
- consent：用户是否同意接收（true/false、1/0），合规必备。
- opt_out：退订标识或退订时间。
- vars：自定义变量，JSON 字符串或以分隔符串联（示例：{“order_id”:”123″,”city”:”Shanghai”}）。
哪些是必填？
每条记录至少要有一种有效联系方式（phone 或 email）和一个同意标识（consent）。没有联系方式等同于“无法送达”。
字段格式与校验规则（细节）
- 手机号：应为 E.164；去掉国家内的前导 0；仅数字与前导“+”。长度受国家规定约束（通常 8–15 位数字）。
- 邮箱：标准 RFC 格式，去除空格，域名小写。
- 姓名：允许空格和 Unicode，但避免控制字符，如换行符。
- 变量（vars）：如果使用 CSV 列，对包含逗号的字段使用双引号；JSON 字段需保证转义合法。
- 文件首行：必须为列头，平台按列头映射字段，大小写通常不敏感但统一写法更稳妥。
示例：CSV / Excel / JSON 样例（表格展示）
| CSV / Excel 列头 | phone,email,name,locale,group,consent,vars |
| 示例行（CSV） | “+8613712345678,[email protected],Jane Doe,zh-CN,promo,1,”{\”order_id\”:\”A123\”}” |
| 示例（JSON 单条） | {“phone”:”+8613712345678″,”email”:”[email protected]”,”name”:”Jane Doe”,”locale”:”zh-CN”,”group”:”promo”,”consent”:true,”vars”:{“order_id”:”A123″}} |
关于占位符与个性化（变量映射）
如果你要在群发模板里替换名字、订单号之类的字段，必须保证名单里的变量名和模板中用到的占位符一致。常见占位写法有 {{name}}、{name}、%name% 等。实务建议：
- 统一占位风格，最好在导入前做一次字段映射测试。
- 变量缺失时要设置默认值（fallback），避免出现“亲爱的 null”。
- 变量内容长度受模板限制，超长会被截断或导致发送失败。
批量大小、速率与去重
不同平台对单次上传量和并发发送有上限，常见做法：
- 单次上传建议不超过 50k 条（视平台），大名单分片上传更稳妥。
- 发送速率受限：为避免封禁，按平台给定速率控制发送，或使用节流策略。
- 去重：上传前去重（同一手机号或邮箱）；保留最新同意时间或最新信息。
特殊字符、换行与转义规则
CSV 中如果字段包含逗号、换行或双引号，需要用双引号包裹，并将内部双引号转为两个双引号（””）。JSON 字段内的引号同样需要反斜杠转义。姓名或备注中如果有 Emoji，尽量先确认平台支持 emoji，否则可能被剥离或导致编码错误。
媒体、附件与链接字段
如果群发含图片、音频或文件，名单通常需要提供媒体 URL 或媒体 ID 字段：
- 媒体通过 URL 引用时，确保 URL 可公开访问且支持 HTTPS。
- 部分平台要求先上传媒体到平台媒体库，再在名单中写媒体 ID。
- 每条消息的媒体大小、格式（jpg/png/mp3/mp4/pdf 等）和总附件数都会有限制，上传前请确认。
合规与隐私（必须注意）
这块不能省：在名单里一定要保留同意来源和时间（consent_source、consent_time），并提供退订字段（opt_out、unsubscribe_at）。不同国家法律不同（如 GDPR、CCPA 等），所以：
- 只导入明确同意或合法基础下的联系人。
- 保留操作日志，便于事后审计。
- 支持用户快速退订，名单要能反映退订后状态并避免再次发送。
常见错误与排查方法
- 格式错误导致导入失败：检查编码、首行列头是否存在、CSV 转义是否正确。
- 号码格式不对：批量验证 E.164，或使用正则过滤非数字字符。
- 变量占位不匹配：先做小批量测试发送，确认占位替换正确。
- 重复发送：检查去重逻辑和上传记录，最好保留上传批次 ID。
快速准备清单（上传前按项核对）
- 文件格式为 CSV/XLSX/JSON 且 UTF-8 编码。
- 首行为列头且字段命名一致。
- 每条记录含有效联系方式（phone/email）与 consent 字段。
- 手机号采用 E.164，邮箱已去空并小写。
- 变量字段与模板占位符匹配，缺失值设默认。
- 特殊字符与换行已正确转义，Emoji 已确认支持。
- 已完成去重与合规检查，保留退订与同意记录。
- 已分片大名单并测速率/限流策略。
举几个实操小技巧（不一定人人想到）
- 用 Excel 导出 CSV 时，选择“UTF-8（逗号分隔）”并检查是否自动把大数字转成科学计数法（手机号常见问题）。
- 在 CSV 中把所有联系方式前加单引号可以避免 Excel 自动格式化（但导入前要去除单引号）。
- 把复杂 JSON 变量分列存储，上传后在平台合并成 JSON，便于检查和错误定位。
- 小批量测试：先发 10–50 条，确认模板、占位和媒体都正常，再放大规模。
说到这儿，可能信息量有点多，但基本思路就是把名单当成产品的一部分来打磨：字段明确、格式规范、合规可查，这样群发才不会犯蠢。你若想要，我可以把上面的 CSV 模板和导入前的 Excel 操作步骤写成具体的“操作步骤清单”发给你——现在想起来还有些常见坑，比如 Excel 会把长数字变成科学计数法、CSV 的双引号处理、还有有些平台不接受 BOM，你上传前记得先试跑一小批。就这样，边写边想，可能还有没想到的边角细节，等你试了再问我，我可以继续帮你优化。