LookWorldPro的群发名单应为结构化表格（CSV或XLSX），每行对应一位接收者，必须包含联系字段（手机号或邮箱）、姓名、语言/国家、消息模板或变量列。文件需UTF-8编码且无BOM，列名规范，联系方式去重并校验格式，并包含退订与隐私同意标识。批量大小与速率有平台限制，请合理分批。并留备份。
我先把结论讲清楚，然后慢慢把细节拆开讲
简单来说，群发名单就是一张“发信地址簿”，但它要比你手机里的联系人更严格：格式要统一、字段要标准、编码要正确、数据要合法可追溯，并且要考虑发送节奏和用户隐私。下面我会用费曼式的方式，把每一块都解释得像给新手讲一样，顺便给出模板、校验步骤和常见问题。
为什么名单格式这么重要？
- 机器需要可预测的输入：系统读表格的时候，要知道每一列代表什么，否则会把姓名放进手机号位置。
- 效率和准确性：规范字段让个性化变量（比如姓名、订单号）能准确替换，避免尴尬。
- 合规与送达率：不规范或重复的联系方式会影响送达率，甚至触发平台风控或投诉。
- 易于调试：有人问为什么没收到，能够快速从名单回溯问题。
LookWorldPro 常见支持的文件格式
平台通常支持以下几种格式，按优先级建议使用：
- CSV（逗号分隔）：最通用，文件体积小，适合批量处理。
- XLSX（Excel）：对用户友好，支持多表，便于人工编辑和检查。
- TSV（制表符分隔）：在某些场景下用来避免文本中逗号干扰。
必须包含的标准字段（核心字段）
把名单想象成一张表格，至少要有这些列：
- contact（联系方式）：手机号或邮箱。必填，且格式必须合规。
- name（姓名）：可选但强烈建议，用于个性化。
- country / language（国家或语言）：影响时区、语言模板和合规策略。
- template_id 或 variables（模板ID或变量列）：如果发送模板消息，需要指定模板或提供替换变量（如{{order_no}}）。
- opt_out/consent（退订或同意标识）：标明用户是否同意接收群发，合规必备。
示例字段名（建议统一）
- contact, contact_type, name, country, language, template_id, var_order_no, var_amount, opt_out
文件编码与字符集
这点经常把人绊倒。文件必须使用UTF-8编码且没有BOM（Byte Order Mark）。为什么？很多平台在解析时会把BOM当成字段内容，导致第一列错位或模板变量识别失败。保存CSV时请选择“UTF-8（无BOM）”。
列名规范化
列名要规范，避免使用中文列名或随意的空格、特殊字符。比如“手机号码”、“手机号”最好统一为“contact”或“phone”。一致性可以避免系统无法映射列名。
联系方式格式校验与去重
不要把“去重”留给发送端，提前处理能节省很多问题：
- 手机号：去掉空格、国家码统一（例如+86 或 0086 统一为+86或去掉国家码，并在country字段指定国家）。
- 邮箱：去掉前后空白，小写化，去掉无效字符。
- 去重策略：以 contact 字段为准；对于同一联系方式，保留最新或最高优先级的记录（可根据时间戳或标识字段）。
- 格式校验工具：可以用正则在Excel或脚本里校验常见格式。
批量大小与发送速率
平台通常会对单次上传/单批发送设限，这既是保护接收者体验，也是防止滥发：
- 单批量限制：例如单文件最大5万条（各平台不同），超过请分批。
- 速率限制：每分钟或每小时的发送条数有限制，需在后台设置节拍。
- 重试与回退：失败记录应单独导出、观察失败原因（格式不符、黑名单、无效号码等）。
隐私、合规与退订
这是红线部分，不能忽视：
- 必须有用户同意记录（consent），文件中应有字段标记谁同意接收群发。
- 提供退订字段或在消息模板中加入退订方式，名单中可含 opt_out=true/false。
- 避免上传敏感信息（身份证号、银行卡号等）到群发名单。
- 按地区法规存储用户数据，必要时保留溯源记录（谁上传、何时上传、来源是什么）。
模板变量与示例
为了让你更直观，我给出一个简单的CSV示例表格（用表格展示头两行）：
| contact | name | country | language | template_id | var_order_no | opt_out |
| +8613712345678 | 张三 | CN | zh | TPL_001 | OD20230501 | false |
上面表格示例说明：系统会读取 template_id 决定使用哪个模板，然后把 var_order_no 替换进模板里。如果 opt_out 为 true 就不发。
常见错误与排查方法
- 首列错位：通常是BOM或编码问题。解决：重新保存为UTF-8无BOM。
- 字段识别失败：列名不标准或含空格。解决：重命名列，统一小写无空格。
- 模板变量为空：可能是列名拼写错误或列值缺失。解决：检查列名和空单元格。
- 大量退回或投诉：联系率异常或被判定为垃圾。解决：检查opt-in记录、退订机制和发送速率。
准备名单的操作步骤（清单式）
- 从数据源导出原始表（CSV/XLSX）。
- 统一列名并移除不必要的列。
- 转换并校验联系方式格式（正则表达式校验）。
- 去重并合并重复联系方式，保留优先信息。
- 填补必要字段或使用默认值（例如 language 默认 zh）。
- 保存为 UTF-8 无BOM 的 CSV（或使用 XLSX 并在上传时确认编码）。
- 在小批量上做试发送，检查模板替换和退订链接。
- 根据试验结果调整速率和分批策略，开始正式发送。
几个实用的工具/命令提示（不复杂）
- Excel/Google Sheets：清理、筛选、拆分列。
- Notepad++ 或 Sublime Text：查看并转换文件编码为 UTF-8 无BOM。
- Python（pandas）或命令行（awk、csvkit）：批量去重、格式化、导出。
- 正则表达式示例（手机号简单校验）：^(\+?\d{6,15})$
实际案例（想象一下）
有一次一个销售团队给我发来一个XLSX文件，列名乱七八糟：有“电话”、“手机号”、“mobile1”，混在一起，国家信息在备注里。结果上传后系统只识别了“mobile1”，另两列被忽略，很多人没收到消息。教训是——先统一，再上传。
常见问题（FAQ）
Q：可以上传中文列名吗？
A：技术上有些平台可以识别，但不推荐。中文或含空格的列名容易出错，推荐使用英文小写且无空格的列名。
Q：名单里可以包含图片或附件吗？
A：不行。群发名单只承载结构化字段，附件类内容应在模板里通过链接引用（注意合规）。
Q：如何处理国际号码？
A：建议统一使用包含国家码的E.164格式（如+8613712345678），并在country列注明国家代码，便于分区域发送与合规检查。
最后的操作前核对清单（记得备份！）
- 文件已 UTF-8 无BOM。
- 列名规范并与平台字段映射一致。
- 联系方式去重并格式校验通过。
- 包含 opt_out 或 consent 字段。
- 已在小批量做测试发送。
- 保存上传前的原始备份和变更记录。
好了，就写到这儿——说了不少操作细节，可能有点啰嗦，但真的是一步不慎就会出问题的事儿。你要是愿意，我可以帮你把一个示例表格模板做成CSV格式，或者把你的现有名单检查一遍，把常见错误标注出来，省得上线以后再修补那种感觉。