Skip to main content

​
Tracking click events

Updated: Nov 18, 2025 Marketing Messages API for WhatsApp (formerly known as Marketing Messages Lite API) is now generally available. Available using Marketing Messages API for WhatsApp (MM API for WhatsApp) and Ads Manager only We deliver a webhook payload when users click on 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

At the moment, this feature is not available for all users 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. The webhook payload is on the messages field and is delivered as 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 NameField TypeField Description
action_typeRequired
String		Name of the action
timestampRequired
Unix timestamp		Timestamp of when the event happened
click_componentOptional
Enum		The click action
Can either be cta or body
click_idOptional
String		The unique identifier for the click. Is also appended to the original url when the user visits the url.
tracking_tokenOptional
String		Internal Meta token for processing and tracking
product_idOptional
String		ID of the product, if it was assigned in Ads Manager or Marketing API.
Did you find this page helpful? Thumbs up icon Thumbs down icon ON THIS PAGE Limitations Webhooks