海王出海群发名单格式有什么要求

海王出海群发名单通常以CSV或Excel表格上传，关键字段包括平台标识、联系人标识（如E.164格式手机号或平台ID）、姓名、国家/语言、标签和可选自定义变量，文件应使用UTF-8编码并做去重与授权校验，确保包含退订/隐私同意信息以满足合规要求。

先把问题说清楚：名单格式为什么重要

简单说，名单格式是群发能否顺利、准确到达目标并合规的基础。想象你要给全世界寄明信片：地址写错、语言不对或者没有收件人允许，明信片会被退回或被投诉。一样的，格式决定信息能不能“到门口”。

用费曼法先把核心拆成三块

• 内容字段：谁、在哪、用什么渠道联系，这是最基础的列。
• 形式与编码：文件类型、字符编码、分隔符这些决定系统能否正确读入。
• 合规与质量：去重、授权、退订字段和字段校验，保证发送合法且高命中率。

一：必须包含的字段（最小集）

下面这组字段是任何群发名单的核心，不同渠道可能有额外要求，但这些是通用且不可或缺的。

• platform（渠道/平台）：标识目标渠道，如WhatsApp、Facebook、Telegram等（便于平台按渠道路由）。
• contact_id（联系人标识）：关键字段。对手机：必须为E.164格式（例如+8613712345678）；对社媒：为PSID、username或用户ID，视渠道而定。
• name（姓名/昵称）：用于个性化合并变量，建议单独拆分first_name/last_name以便灵活使用。
• country（国家/地区）：用于语言、时区和合规判断，建议使用ISO 3166-1 alpha-2代码（如CN、US）。
• language（语言）：ISO语言代码（如zh、en），方便系统选择翻译或模板。
• consent（是否已授权）：布尔值或枚举（yes/no/opt-in），证明用户同意接收消息。
• opt_out（退订标识）：显式字段，若为true则排除在发送列表外。

二：常用的可选字段（提高转化和分组）

• tags/labels：用于快速分群（VIP、leads、inactive等）。
• custom_*（自定义变量）：任意以custom_开头的列可在模板中作为合并字段。
• timezone：用于控制投放时段，避免夜间打扰。
• email：有些渠道需要或备份联络方式。
• last_contacted：用于频次控制，避免超发。

三：文件格式与编码要求

要让系统读懂你的名单，这些“格式规则”很关键：

• 文件类型：支持CSV（首选）和Excel（.xlsx）。CSV更简洁，兼容最高。
• 分隔符：通常为逗号（,），如内容可能含逗号，建议用双引号包裹文本字段或使用制表符分隔的TSV。
• 字符编码：必须使用UTF-8，避免中文或特殊符号乱码（尤其是姓名、表情等）。
• 首行表头：建议包含英文字段名，平台会做字段映射；如果没有表头，上传时需手动映射。
• 空值与占位：空字段用空字符串，不要用“NULL”或“-”。

四：列名规范与示例（推荐模板）

下面给出一份常见推荐表头与对应示例，按此准备上传能减少映射和报错。

字段名	类型	示例	备注
platform	string	WhatsApp	区分渠道，方便路由
contact_id	string	+8613712345678	手机必须E.164格式；社媒为用户ID或PSID
first_name	string	小明	用于称呼合并
last_name	string	张	可选
country	string	CN	ISO代码
language	string	zh	用于模板本地化
consent	boolean	yes	必需以证明已获授权
opt_out	boolean	no	true则跳过发送
tags	string	VIP;2025-Q1	分号或逗号分隔多标签

五：上传前的预处理步骤（一步步来）

把准备工作当作烘焙前的秤量，少一点懒会省很多麻烦：

• 1) 统一编码并保存为CSV UTF-8，打开文本编辑器检查是否有奇怪字符。
• 2) E.164校验：所有手机号统一加上国家码并去除空格、括号、破折号。
• 3) 去重：按contact_id去重，保留最新或有更多信息的那条记录。
• 4) 校验授权：确保consent列为yes的才纳入发送，记录来源（订阅渠道、时间）最好存在于备注。
• 5) 字段映射测试：上传一个10-50条的小样本做预览，验证合并变量和语言选择是否正确。

六：渠道差异与特殊要求（别走错门）

千万别把所有渠道当成同一类：每个渠道对ID格式和合规要求不一样。

• WhatsApp：必须使用E.164手机号；模板消息需事先审核（企业模板），非模板消息在首次联系上有严格限制。
• Facebook/ Messenger：通常使用PSID（页面场景）或用户ID；不能用手机号直接呼叫。用户需先与页面互动或同意。
• Instagram：可能使用username或IG user id，API权限受限，群发能力有限。
• Telegram：有时可用username或numeric ID；机器人权限和频道设置会影响可达性。
• 邮件与SMS：邮件遵循RFC标准，手机号遵循E.164，且需要对应的退订字段与退订链接/短信关键字。

七：合规要点（不只是技术要求）

这部分不像格式那么“显而易见”，但做不对会导致账号被封或罚款。

• 记录同意来源：保存用户何时、如何同意接收消息（表单、聊天、订阅框等）。
• 提供退订途径：每次营销消息需包含明确退订方式或在名单中维护opt_out字段。
• 区域法规：关心GDPR、CCPA、当地电信监管条例和平台政策（比如WhatsApp商业政策）。
• 频率控制：避免短时间内频繁触达同一用户，维护last_contacted字段。

八：常见错误与排查方法

• 乱码：通常是因为不是UTF-8编码，解决：以UTF-8另存并重新上传。
• 号码被拒收：检查是否为有效E.164、是否被标记为退订或黑名单。
• 字段映射错位：上传时预览列名并手动映射，避免姓名与号码对不上。
• 批量失败：查看错误报告（通常平台会返回行号和错误原因），先修复前100条再批量重试。

九：实操小技巧（能省时间的那些事儿）

• 分批上传并命名（例如：leads_202604），这样回溯容易。
• 把常用的字段模板保存为CSV模板，避免每次重建表头。
• 用简单脚本（Python或Google Sheets公式）统一手机号格式、去空格和去重。
• 先发小批量A/B测试不同文本或语言，再扩大发送。

一个简单的CSV示例（两行）

platform,contact_id,first_name,country,language,consent,opt_out,tags

WhatsApp,+8613712345678,小明,CN,zh,yes,no,VIP

Facebook,1234567890123456,Anna,US,en,yes,no,lead

最后，简单提醒两点：一是平台的具体限制（例如单次上限条数、单文件大小）会变化，上传前在海王出海的“上传帮助”或控制台提示里确认；二是系统虽然能容错很多细节，但把基本的格式、编码、授权准备好，会把你从大量排查和投诉中解放出来——说到这里我还想起上个月有人因为没加国家码全发失败，嗯，就像做菜少盐一样，细节决定成败。