WhatsApp Business 管理 API

优惠码模板

优惠码模板是显示单个复制代码按钮的营销模板。轻触时，系统会将此代码复制到客户的剪贴板上。

限制

  • WhatsApp 网页版客户端目前不支持优惠码模板。
  • 优惠码不得超过 15 个字符。
  • 按钮文本无法自定义。
  • 模板仅限拥有 1 个复制代码按钮。

创建优惠码模板

使用 WhatsApp Business 商业帐号 > 消息模板端点可创建优惠码模板。

请求语法

POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates

POST 请求正文

{
  "name": "<NAME>",
  "language": "<LANGUAGE>",
  "category": "MARKETING",
  "components": [
    ... // Additional components, if using
    {
      "type":"BUTTONS",
      "buttons": [
        {
          "type":"COPY_CODE",
          "example": "<EXAMPLE>"
        },
        ... // Additional buttons, if using
      ]
    }
  ]
}

属性

占位符描述示例值

<NAME>

字符串

必要。


模板的名称。


不超过 512 个字符。

fall2023_promotion

<LANGUAGE>

枚举

必要。


模板的语言和区域代码。

en_US

<EXAMPLE>

字符串

必要。


轻触时会复制的优惠码。


不超过 15 个字符。

25OFF

响应

若请求成功，此 API 将在响应中提供以下内容：

{
   "category" : "<CATEGORY>",
   "id" : "<ID>",
   "status" : "<STATUS>"
}

响应属性

占位符描述示例值

<CATEGORY>

枚举

模板类别。

MARKETING

<ID>

数字字符串

模板编号。

1924084211297547

<STATUS>

枚举

模板状态。

PENDING

请求示例

curl 'https://graph.facebook.com/v21.0/102290129340398/message_templates' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "name": "coupon_code_fall2023_25off",
  "language": "en_US",
  "category": "MARKETING",
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Our Fall Sale is on!"
    },
    {
      "type": "BODY",
      "text": "Shop now through November and use code {{1}} to get {{2}} off of all merchandise!",
      "example": {
        "body_text": [
          [
            "25OFF",
            "25%"
          ]
        ]
      }
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "QUICK_REPLY",
          "text": "Unsubscribe"
        },
        {
          "type": "COPY_CODE",
          "example": "250FF"
        }
      ]
    }
  ]
}'

响应示例

{
  "category" : "MARKETING",
  "id" : "1924084211297547",
  "status" : "PENDING"
}

发送优惠码模板

使用云端 API 可通过模板消息发送已获批准的优惠码模板。请参阅发送优惠码模板。