Skip to main content

​
Tap target title URL override

Updated: Nov 13, 2025 This document explains how to send approved message templates using the tap_target_configuration component within a template message. Tap target override enables image-based, text-based, and header-less message templates to function as interactive Call-to-Action URL buttons. These buttons display a custom title and open the destination linked to the first URL button. WhatsApp Business Accounts (WABAs) must be fully verified and consistently maintain high-quality standards to ensure compliance and access to this component.

​
Request syntax

Use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send a text message template to a WhatsApp user. 
curl 'https://graph.facebook.com/&lt;API_VERSION&gt;/&lt;WHATSAPP_BUSINESS_PHONE_NUMBER_ID&gt;/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer &lt;ACCESS_TOKEN&gt;' \
-d '
\{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "&lt;WHATSAPP_USER_PHONE_NUMBER&gt;",
  "type": "template",
  "template": {
    "name": "&lt;TEMPLATE_NAME&gt;",
    "language": {
      "code": "&lt;LANGUAGE_AND_LOCALE_CODE&gt;"
    },
    "components": [\
      {\
        "type": "tap_target_configuration",\
        "parameters": [\
          {\
            "type": "tap_target_configuration",\
            "tap_target_configuration": [\
              {\
                "url": "&lt;URL&gt;",\
                "title": "&lt;TITLE&gt;"\
              }\
            ]\
          }\
        ]\
      },\
          <!-- Add additional components -->\
    ]
  }
}

​
Request parameters

PlaceholderDescriptionExample Value
&lt;ACCESS_TOKEN&gt;
String		Required.
System token or business token.		EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
&lt;API_VERSION&gt;
String		Optional.
Graph API version.		v24.0
&lt;LANGUAGE_AND_LOCAL_CODE&gt;
String		Required.
Template language and locale code.		en
&lt;TEMPLATE_NAME&gt;
String		Required.
Name of template.		august_promotion
&lt;TITLE&gt;
String		Required.
URL Title.		Offer Details!<br />
&lt;URL&gt;
String		Required.
URL.		https://www.luckyshrubs.com
&lt;WHATSAPP_BUSINESS_PHONE_NUMBER_ID&gt;
String		Required.
WhatsApp business phone number ID.		106540352242922
&lt;WHATSAPP_USER_PHONE_NUMBER&gt;
String		Required.
WhatsApp user phone number.		+16505551234

​
Example request

Example request to send a template message with the tap_target_configuration type. 
curl 'https://graph.facebook.com/v24.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
\{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+1233214532",
  "type": "template",
  "template": {
    "name": "august_promotion",
    "language": {
      "code": "en"
    },
    "components": [\
      {\
        "type": "header",\
        "parameters": [\
          {\
            "type": "image",\
            "image": {\
              "link": "https://www.luckyshrubs.com"\
            }\
          }\
        ]\
      },\
      {\
        "type": "body",\
        "parameters": [\
          {\
            "type": "text",\
            "text": "Hello Andy..."\
          }\
        ]\
      },\
      {\
        "type": "tap_target_configuration",\
        "parameters": [\
          {\
            "type": "tap_target_configuration",\
            "tap_target_configuration": [\
              {\
                "url": "https://www.luckyshrubs.com/",\
                "title": "Offer Details"\
              }\
            ]\
          }\
        ]\
      }\
    ]
  }
}'

​
Example response

\{
   "messaging_product": "whatsapp",
   "contacts": [\
       {\
           "input": "+1233214532",\
           "wa_id": "1233214532"\
       }\
   ],
   "messages": [\
       {\
           "id": "wamid.HBgLMTMyMzI4NjU2NzgVAgARGBJBQzRBRDBEMDEwQzVBM0M0QkIA",\
           "message_status": "accepted"\
       }\
   ]
}
Did you find this page helpful? Thumbs up icon Thumbs down icon ON THIS PAGE Request syntax Request parameters Example request Example response