Single product

spm One catalog product with photo, name and price, plus the button that opens it.

How it works

The template is approved once, with no product at all: the header goes with format: PRODUCT, which is a placeholder. The product — photo, name and price — comes from the catalog at send time, identified by catalog_id and product_retailer_id. It is the model for answering about a specific item: the same approved template serves any product in the account.

At creation and at send time

At creation	At send time
The message and footer text	The product, with photo, name and price
The `PRODUCT` header, empty

Fields in this model

Field	What it is for	Rule
`category`	Fixed	Always `MARKETING`
`HEADER`	The product slot	`format: PRODUCT`, nothing else
`BODY`	The text next to the product	Up to 160 characters
`FOOTER`	Optional	Up to 60 characters
`SPM` button	Opens the product in the catalog	Fixed label: `Ver` on a `pt_BR` template, `View` elsewhere

The SPM label is the most confusing case: on the same pt_BR template, Meta demands Ver for SPM and View items, in English, for MPM. There is no language rule; both were measured in rejections.

Full JSON

Two JSON payloads: one creates the template, and Meta approves it once. The other sends the message, and goes on every dispatch, with that send’s values in the variables marked with braces.

1. Create the template

POST /whatsapp/businesses/{wabaId}/templates — see API reference.

{
  "name": "exemplo_spm",
  "category": "MARKETING",
  "language": "en_US",
  "allow_category_change": true,
  "parameter_format": "NAMED",
  "components": [
    {
      "type": "HEADER",
      "format": "PRODUCT"
    },
    {
      "type": "BODY",
      "text": "Hi {{customer_name}}, your order {{order_number}} is confirmed and ships today.",
      "example": {
        "body_text_named_params": [
          {
            "param_name": "customer_name",
            "example": "Marina"
          },
          {
            "param_name": "order_number",
            "example": "1042"
          }
        ]
      }
    },
    {
      "type": "FOOTER",
      "text": "Reply STOP to opt out"
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "SPM",
          "text": "View"
        }
      ]
    }
  ]
}

2. Send it once approved

POST /v1/channels/{channelId}/messages — see Send template.

{
  "recipient": {
    "identifier": "5511999999999"
  },
  "content": {
    "type": "TEMPLATE",
    "attachments": [
      {
        "template": {
          "name": "exemplo_spm",
          "language": {
            "policy": "deterministic",
            "code": "en_US"
          },
          "components": [
            {
              "type": "body",
              "parameters": [
                {
                  "type": "text",
                  "text": "{{customer_name}}"
                },
                {
                  "type": "text",
                  "text": "{{order_number}}"
                }
              ]
            },
            {
              "type": "header",
              "parameters": [
                {
                  "type": "product",
                  "product": {
                    "catalog_id": "{{catalog_id}}",
                    "product_retailer_id": "{{product_retailer_id}}"
                  }
                }
              ]
            }
          ]
        }
      }
    ]
  }
}

What Meta rejects here

A label other than the required one, with code 2388153.
A body over 160 characters.
A text or media header in place of PRODUCT.

Channels

Messages

Templates (WhatsApp)

Flows (WhatsApp)

Webhooks

How it works

At creation and at send time

Fields in this model

Full JSON

1. Create the template

2. Send it once approved

What Meta rejects here

​How it works

​At creation and at send time

​Fields in this model

​Full JSON

​1. Create the template

​2. Send it once approved

​What Meta rejects here

How it works

At creation and at send time

Fields in this model

Full JSON

1. Create the template

2. Send it once approved

What Meta rejects here