Tracking click events

Updated: Jun 30, 2026

Available using Marketing Messages API for WhatsApp (MM API for WhatsApp) and Ads Manager only

Meta delivers a webhook payload when a WhatsApp user clicks the body or call-to-action of your marketing message. You can subscribe to this webhook to capture this data and use it to inform your campaign decisions.

Limitations

This feature is currently in limited availability

Click events are only available for messages sent in the last 7 days

Webhooks

To receive this webhook, subscribe to the whatsapp_business_account webhook topic. Meta delivers the webhook payload on the messages field, as shown below:

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "user_actions": [
              {
                "action_type": "marketing_messages_link_click",
                "timestamp": "<time_of_click>",
                "marketing_messages_link_click_data": {
                  "click_component": "cta" | "body",
                  "product_id": "sku_id",
                  "click_id": "click_id",
                  "tracking_token": "example_token"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Field Name	Field Type	Field Description
`action_type`	Required String	Name of the action
`timestamp`	Required Unix timestamp	Timestamp of when the event happened
`click_component`	Optional Enum	The click action Can either be `cta` or `body`
`click_id`	Optional String	The unique identifier for the click. It is also appended to the original URL when the user visits the URL.
`tracking_token`	Optional String	Internal Meta token for processing and tracking
`product_id`	Optional String	ID of the product, if it was assigned in Ads Manager or Marketing API.