​

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:

1. Use the following format for dynamic URLs: https://yourdomain.com/{{1}}
2. The {{1}} placeholder will be replaced with a custom value for each message

Example:

https://trypopcorn.ai/{{1}}

​

Using Dynamic URLs in Campaigns

When sending a campaign with a parameterized URL:

1. In the campaign setup, you’ll see a field to enter only the parameter value (not the full URL)
2. Enter just the value that should replace {{1}}, such as:
   • pricing
   • welcome
   • specialoffer

The system will then replace {{1}} with your parameter value.

​

API Integration

You can also set dynamic URL values when sending templates through the API:

POST https://api.trypopcorn.ai/template/:templateId
Content-Type: application/json
POPCORN-API-KEY: your_popcorn_api_key

{
  "recipientNumber": "1234567890",
  "buttonValues": {
    "Learn More": "pricing"
  }
}

​

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

1. URL Format: Keep URLs simple and human-readable
2. Parameter Values: Use short, meaningful values that make sense in your URL structure
3. Testing: Always test your dynamic URLs before sending to customers
4. Tracking: All button clicks are automatically tracked in your campaign dashboard
5. Mobile Optimization: Ensure all destination pages are mobile-optimized

​

Common Patterns

​

Product Pages

https://store.com/{{1}}

Where {{1}} could be: shoes, electronics, sale

​

User-Specific Pages

https://app.com/onboarding/{{1}}

Where {{1}} could be: step1, business, personal

​

UTM Tracking

https://yoursite.com/landing?utm_campaign={{1}}

Where {{1}} could be: spring_sale, welcome_offer, follow_up

​

Troubleshooting

If your dynamic URLs aren’t working correctly:

1. Ensure your template uses double braces: {{1}} (not single braces {1})
2. For parameterized URLs, make sure you’re providing only the value to replace the placeholder
3. Verify that the button text in your API call matches exactly the text in your template
4. 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