WhatsApp模板变量：{{1}}与命名参数的区别

{
  "type": "BODY",
  "text": "Hi {{1}}! Your order {{2}} ships on {{3}}.",
  "example": { "body_text": [["Layla", "OM-4821", "12 November"]] }
}

{
  "type": "BODY",
  "text": "Hi {{first_name}}! Your order {{order_number}} ships on {{ship_date}}.",
  "example": {
    "body_text_named_params": [
      { "param_name": "first_name", "example": "Layla" },
      { "param_name": "order_number", "example": "OM-4821" },
      { "param_name": "ship_date", "example": "12 November" }
    ]
  }
}

如何在API调用中发送参数？

您发送模板名称、语言，以及带有这些值的components数组。位置模板的结构如下：

{
  "messaging_product": "whatsapp",
  "to": "971500000000",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": { "code": "en" },
    "components": [
      { "type": "body", "parameters": [
        { "type": "text", "text": "Layla" },
        { "type": "text", "text": "OM-4821" },
        { "type": "text", "text": "12 November" }
      ] }
    ]
  }
}

对于命名模板，每一项还要带上parameter_name，它必须与占位符一致：

{ "type": "text", "parameter_name": "order_number", "text": "OM-4821" }

标题媒体参数如何工作？

媒体标题没有文本变量。创建时，标题中放的是通过Meta上传流程获得的示例素材句柄，该示例会随模板一起审核。发送时您传入素材，例如按媒体ID传入图片：

{ "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] }

上面的ID是Meta文档中的示例，不是真实素材。

通过OmniChannels.ai API如何实现？

我们的sendbulk端点按WhatsApp API文档以表单字段接收模板：

实例：发货通知模板

“Souq Rafiq”（虚构）是一家阿联酋零售商，想发送一条带商品图片和物流跟踪按钮的发货通知。

1. 撰写模板，使其既不以变量开头也不以变量结尾：“Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it.”
2. 添加标题为图片，页脚为纯文本，再添加URL按钮https://shop.example/track/{{1}}，示例值如OM-4821。
3. 提交时为每个变量提供真实可信的示例，然后等待审批状态。
4. 发送时提供三个正文值、物流跟踪后缀，以及（如果要覆盖的话）标题图片。

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-shipped \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=order_shipped \
  -F templateLanguage=en \
  -F bodyTemplateVariables=Layla \
  -F buttonsTemplateVariable=OM-4821

此代码片段展示的是单个值的字段名。如果每位收件人有多个正文变量，请使用个性化上传，而不是重复执行该命令。首次活动前，请与我们的团队确认编码方式。

如何用CSV实现模板个性化？

每位收件人一行，每个变量一列，然后在个性化发送中上传。

1. 在第一列填写收件人的国际格式号码。请参阅E.164电话号码格式。
2. 每个变量增加一列，并在首次活动前与我们的团队确认列布局。
3. 先清理数据：去掉空格、统一大小写、使用同一种日期格式、删除空值，因为空变量会导致消息错乱或发送失败。
4. 预览多行数据，并先发给您自己的号码。

数据清理的步骤见用Excel或CSV群发短信；这些方法同样适用于WhatsApp。

如何在位置参数和命名参数之间做选择？

根据有多少人会改动模板、模板有多少变量来选择。

1. 一两个变量、由一人负责：位置参数即可，也是默认格式。
2. 三个或更多变量，或多个团队编辑模板：使用命名参数，让每个占位符自带说明。
3. 同样的文案有多个语言版本：各版本保持相同的名称或编号，这样一套发送流程就能填充所有语言。
4. 始终记录哪一列来源数据对应哪个变量，这样以后修改模板时数据不会错位。

提交之前，带着示例值把成品消息朗读一遍。如果听起来不自然，审核人员和客户也会这样觉得。

常见错误有哪些？

• 以变量开头或结尾， Meta将其列为驳回原因。
• 跳号，或在位置模板中乱序重复使用同一编号。
• 占位式示例，例如“test”，对审核人员没有任何信息量。
• 变量中含有特殊字符，如#、$或%。
• 位置模板发送时顺序错误，会把正确的数据放到错误的位置。
• 命名模板中parameter_name不匹配。
• 用变量掩盖消息的真实用途。 类别与内容不符的模板可能被驳回或被重新归类；请参阅类别指南。
• 局限： 本指南反映的是撰写时Meta文档的说明。审核决定权在Meta，规则也会变化，请查阅所附页面。

OmniChannels.ai如何提供帮助

BroadNet是Meta官方的商业解决方案提供商（Business Solution Provider）。在OmniChannels.ai中，您可以创建带变量、媒体和按钮的WhatsApp模板，预览并跟踪审批状态，然后通过API，或在活动中上传Excel或CSV，以个性化的值发送。系统包含重复号码过滤和送达报告。请参阅WhatsApp Business API页面和活动平台。