WhatsApp 联系人自定义属性设置：创建行业/品类扩展字段并在群发消息模板中调用变量

概览

联系人属性是你插入消息正文的变量 — 订单号、优惠码、追踪链接、预约时间 — 让同一条模板对每位收件人自动个性化。它们是可复用的合并字段（merge fields），在编辑器中以有含义的名称出现，发送时由 WAthink 按联系人的取值填充。

从 More 菜单的 Attributes 进入。页面列出工作区内每条属性的名称、键、默认值、描述与状态，并提供按状态筛选的侧栏、搜索框以及列表 / 网格切换。

按工作区共享：属性属于工作区，而不属于个人，因此不同工作区之间永远不会看到彼此的定义。

内置字段与自定义属性

撰写消息时会用到两类变量：

• 内置字段无需创建 — 它们来自联系人。本页面只管理自定义属性。
• 斜杠选择器会列出启用的自定义属性供插入。标准联系人字段由消息编辑器本身插入。

何时新增：如果想个性化的值不是标准联系人字段，就为它创建一条自定义属性；否则直接用内置字段即可。

创建属性

1. 点击 New attribute 打开创建弹窗。
2. 填写显示名称与键（key）（两者必填）。
3. 可选：设置默认值与描述。
4. 保持启用（默认）以便属性出现在斜杠选择器中；关闭它则保留定义但从选择器隐藏。
5. 保存。新属性会出现在表格顶部。

字段说明

键创建后不可更改。键在创建后为只读 — 编辑弹窗会有意禁用该字段，因为键已被你的模板与消息引用。你可以修改显示名称、默认值与描述，也可以切换启用状态，但不能改键。需要改键时，请新建一条属性并更新你的模板。

用斜杠选择器插入属性

要使用属性，在任何支持编排的消息正文中输入 / — 模板、广播、WhatsApp 营销活动以及流程构建器。选择器会列出启用的属性。

选择属性会插入命名占位符（例如 {{order_id}}），而不是裸数字 — 编辑时你看到的始终是有含义的名称。保存时 WAthink 会把它规范化为位置占位符 {{1}}、{{2}}…，并记录「槽位 → 属性键」的映射；发送时按该映射填入收件人的值（缺少值时使用属性的默认值）。

位置占位符与变量映射

存储时，消息正文使用位置占位符 {{1}}、{{2}}、{{3}}，同时保存一张槽位到属性键的映射表。这样编辑器与斜杠选择器可以显示有含义的名称，而存储与发送仍能精确对应每个变量的取值。

• 已经写成编号的文本会保持不变；命名占位符会在保存时按首次出现顺序重新编号。
• 编号必须从 1 开始且连续：使用 {{1}}、{{2}}、{{3}}，不要跳号。正常通过斜杠选择器插入的内容由 WAthink 自动排好编号；没有占位符的正文始终有效。
• 发送时还可以在模板变量映射面板中为每个槽位单独指定取值 — 可以填字面量、{{属性键}}，或两者混合 — 用于营销活动、广播、定时消息与聊天回复，而无需修改模板本身。留空的槽位表示沿用模板自己的变量映射。

管理列表

表格完全可交互，无需刷新页面：

• 按状态筛选：左侧栏提供 All、Active、Inactive，各自显示实时数量。
• 搜索：按名称、键或描述搜索；输入时实时更新（防抖）。
• 编辑：修改显示名称、默认值、描述或启用开关（键保持锁定）。
• 删除：确认提示后删除该行。
• 三个统计卡片汇总工作区：总数、启用（在选择器中显示）与停用（从选择器隐藏）。

最佳实践

• 始终设置默认值。发送时若联系人缺少该值，会使用默认值，而不是让消息失败或显示空白槽位。
• 键使用 snake_case。保持简短一致：order_id、tracking_url、discount_code、appointment_at。
• 停用而非删除。当要弃用某属性但保留旧模板可用时，关闭它即可 — 它会退出选择器，但定义仍然保留。

属性的使用位置

同一套启用的属性在所有撰写消息的地方都可用 — 斜杠选择器适用于：

• 模板（创建模板时）
• 广播
• WhatsApp 营销活动
• 流程构建器

故障排查