Dynamic URL Buttons in WhatsApp Templates
Overview
Dynamic URL buttons allow you to personalize button links for each recipient in your WhatsApp templates. This feature enables you to:- Direct users to personalized landing pages
- Track conversions with unique URLs
- Create reusable templates with dynamic destinations
Creating Templates with Dynamic URLs
When creating a WhatsApp template with a URL button:- Use the following format for dynamic URLs:
https://yourdomain.com/{{1}}
- The
{{1}}
placeholder will be replaced with a custom value for each message
Using Dynamic URLs in Campaigns
When sending a campaign with a parameterized URL:- In the campaign setup, you’ll see a field to enter only the parameter value (not the full URL)
- Enter just the value that should replace
{{1}}
, such as:pricing
welcome
specialoffer
{{1}}
with your parameter value.
API Integration
You can also set dynamic URL values when sending templates through the API:API Parameters
buttonValues
(object) - Key-value pairs mapping button text to URL values- Keys must exactly match the button text in your template
- For parameterized URLs, provide only the parameter value (e.g., “pricing”)
- For static URLs, provide the complete URL
Best Practices
- URL Format: Keep URLs simple and human-readable
- Parameter Values: Use short, meaningful values that make sense in your URL structure
- Testing: Always test your dynamic URLs before sending to customers
- Tracking: All button clicks are automatically tracked in your campaign dashboard
- Mobile Optimization: Ensure all destination pages are mobile-optimized
Common Patterns
Product Pages
{{1}}
could be: shoes
, electronics
, sale
User-Specific Pages
{{1}}
could be: step1
, business
, personal
UTM Tracking
{{1}}
could be: spring_sale
, welcome_offer
, follow_up
Troubleshooting
If your dynamic URLs aren’t working correctly:- Ensure your template uses double braces:
{{1}}
(not single braces{1}
) - For parameterized URLs, make sure you’re providing only the value to replace the placeholder
- Verify that the button text in your API call matches exactly the text in your template
- Check that your destination URL correctly handles the parameter values
Limitations
- Each button can have only one dynamic parameter (
{{1}}
) - WhatsApp has a maximum URL length limitation
- URL parameters should not contain special characters that need URL encoding