LookWorldPro群发名单格式要求

LookWorldPro 的群发名单应以统一字段、标准编码和明确权限为核心：优先使用 UTF-8 编码的 CSV 或 XLSX，主字段至少包括姓名、E.164 格式的手机号码、国家/地区代码与语言偏好；上传前要去重、校验号码合法性并保留备份以便审计和问题回溯。

先把问题拆成最小的块：什么是“群发名单格式要求”

想像你要给一群朋友发消息，名单就像你手里的通讯录。如果名字位置混乱、电话格式五花八门，信息很容易发错、被退回或者触犯法律。格式要求就是把通讯录收拾成一个规范模样，方便系统识别、避免错误、保障隐私和提高送达率。

为什么要严格遵守格式要求？

• 送达效率：格式正确能减少被拒收或识别失败，提升消息送达率。
• 合规性：记录用户同意、保存日志，有利于遵守隐私与反垃圾法例（如 GDPR 类似原则）。
• 追踪与回溯：若出现退信或投诉，完整名单让问题定位更快。
• 个性化能力：标准化字段支持变量替换（名字、语言、专属优惠），消息更有人情味。

核心要求一览（给工程师和运营都能看懂）

• 文件格式：CSV（逗号分隔）或 XLSX 最佳；优先推荐 CSV 做自动化处理。
• 编码：统一使用 UTF-8（带 BOM 可选，视平台而定），避免出现中文乱码或特殊符号丢失。
• 必填字段：姓名（name）、手机（mobile/E.164）、国家/地区代码（country_code）、语言偏好（language）。
• 可选字段：用户ID（user_id）、邮箱（email）、分组标签（tag）、自定义变量（var_* 如 var_coupon）。
• 电话号码规范：推荐 E.164 格式（+国家码 开头，不带空格或括号，例如 +8613712345678）。
• 去重规则：按 E.164 电话去重优先，其次按用户ID；保留最新或最完整一条记录。
• 行数与批量限制：单次上传或接口调用通常有条数限制（举例：一次最多 50,000 行——具体看平台配额），必要时分批上传。
• 字段命名规范：建议使用小写下划线命名（如 name、mobile、country_code、language、user_id）。

具体字段说明（每项都写清楚，别含糊）

字段名	示例	说明
name	张三	用户显示名，允许中英文、常见符号（避免换行）
mobile	+8613712345678	必须为 E.164 格式，包含“+”和国家码，不带空格和括号
country_code	CN	ISO 3166-1 alpha-2 两位代码，便于分区域发送与合规判断
language	zh-CN	用户语言偏好，建议使用 IETF 语言标签（如 en-US、zh-CN）
email	[email protected]	可选，用于跨渠道通知或回溯
user_id	12345	内部系统唯一标识，便于日志关联
tag	vip	分组标签，支持多个标签以分号或竖线分隔（需提前约定）

E.164 格式示例与常见错误

• 正确：+14155552671（美国）
• 正确：+447911123456（英国）
• 错误举例：13812345678（缺国家码）、+86 138 1234 5678（有空格）、(+86)13812345678（带括号）
• 处理办法：批量转换器或正则校验把各种格式统一转为 E.164，再人工抽样检查。

文件细节：CSV 的那些坑

CSV 看起来简单，但容易出问题：中文乱码、分隔符冲突、换行断列、引号不匹配。下面是实操建议，能省你不少时间。

• 分隔符：使用逗号（,）为默认，若字段可能包含逗号，可用双引号将该字段包裹。
• 文本引号：字段内若含双引号，请用两个双引号转义（例如 “He said “”Hi”””）。
• 换行处理：名单中字段请避免换行，若必须，确保字段用引号包裹并兼容上传解析器。
• BOM 与编码：有些系统需要带 BOM 的 UTF-8 才能正确识别中文；有些则不需。最好按平台说明或先小规模测试。
• 列头须一致：第一行建议为字段名（header），与 API 或后台字段映射一致，避免大小写或下划线混淆。

如何准备一个合格的群发名单：逐步操作清单

1. 从原始数据导出到 CSV/XLSX，保留原始备份。
2. 标准化编码为 UTF-8（视平台要求决定是否带 BOM）。
3. 把电话号码统一转换为 E.164 格式。
4. 补齐必填字段，必要时通过外部数据恢复缺失信息。
5. 去重（按 mobile 或 user_id），并记录去重策略。
6. 校验手机号合法性（正则、运营商清单或第三方号码验证服务）。
7. 过滤未授权或未同意接收群发的用户（保存同意证明或时间戳）。
8. 进行小批量测试发送（例如 50–200 条），验证模板变量替换与编码展示。
9. 上传正式名单并监控发送日志与退信情况。

测试环节要注意什么

• 用不同国家和语言的样例号码测试字符集和换行显示。
• 测试变量占位（例如 {name}、{coupon}），确认空值如何处理（使用默认值或删除行）。
• 模拟退信、屏蔽、投诉情形，观察系统如何记录并反馈。

个性化与模板变量：如何把名单变成“有人情味”的信息

在名单中添加自定义变量字段（如 var_first_purchase_date、var_coupon）可以在模板消息中替换，使信息更贴近用户。规则要事先确定好：

• 变量命名清晰（避免中文名作为列头），如 var_city、var_points。
• 空值策略：模板中应提供默认替代文本，避免出现“亲，{name}”这样的原始占位符。
• 长度限制：注意字段长度限制（例如短信单条 70/160 字符规则），必要时生成短链接或拆分信息。

合规与隐私（必须认真对待）

群发名单关乎个人数据，几个必须把握的点：

• 用户同意：必须能证明用户对接收群发有明确同意（时间戳、来源页面、同意文案）。
• 最小化原则：只上传执行任务必需的数据，不要上不相关的个人信息。
• 数据保存期限：按法律或公司策略保留，超过期限要安全删除或匿名化。
• 访问控制：上传权限与下载权限要细分，日志记录谁做了什么操作。
• 跨境传输：若名单涉及跨境传输，确认目的地法律允许并采用适当的合同或保障措施。

常见问题与解决办法（实战笔记）

• 乱码问题：通常是编码不一致。解决：统一导出为 UTF-8，或试试带 BOM 的 UTF-8。
• 字段少一列：确认第一行 header 是否被识别，或是否用制表符/逗号分隔。
• 分隔符冲突：若内容本身频繁出现逗号，可以改用制表符（TSV），但需确保平台支持。
• 退信率高：检查号码有效性、发送频率、帐号信誉及是否触发运营商风控。
• 隐私投诉：先暂停该批次发送，依据记录回溯同意来源并改进退订入口。

一个简单的 CSV 示例（供参考）

name	mobile	country_code	language	tag	var_coupon
李雷	+8613712345678	CN	zh-CN	vip	WELCOME10
Anna Smith	+14155552671	US	en-US	new_user

自动化与接口上传注意点

• 若通过 API 上传，请确认字段映射、一致的 Content-Type（如 text/csv; charset=UTF-8）和返回码解析逻辑。
• 实现幂等上传：同一批次重复上传时应能被识别并避免重复发送。
• 上传反馈需详细：返回成功/失败行数、失败原因码（如 格式错误/黑名单/号码无效）。

小技巧与贴士（那些实践中学到的）

• 维护“清洗脚本”，把各种手机号格式自动统一为 E.164，记录转换日志。
• 建立“样本名单”用于每次产品或文案更新后的回归测试。
• 把常用变量与模板建立版本管理，便于回滚与审计。
• 分批发送：把名单按国家/语言/标签拆分，能显著降低单批退信与被识别为垃圾信息的风险。

一两句作为结尾话（像在白板上临时记下的笔记）

说到底，把名单做对了就是省力省事的开始——标准化、校验、去重与合规是常做且必做的事。遇到不确定的地方，先小批量跑通，确认变量替换和编码显示正常，再放大规模，省得麻烦从细节里冒出来。