Skip to main content
Magic Links are smart deep links and public tracking URLs that let you measure campaign performance, pass UTM parameters to a website, or send referral parameters into chatbot conversation flows. When a user clicks a Magic Link, ChatbotX automatically redirects them to the destination URL you configured, while dynamically capturing and injecting any query string parameters using the {{variable_name}} double curly brace syntax. To access Magic Links, select Tools from the left navigation bar and click the Magic Links card.
1

Open Magic Links

On the Magic Links page, click the + Create Magic Links button in the top-right corner.
2

Configure settings

Fill in the two required fields in the creation form:
  • Name — an identifier for this Magic Link. Use only letters, numbers, underscores _, and hyphens -. This string is appended directly to the public tracking URL (e.g., https://app.chatbotx.io/r/YOUR_BOT_ID/Ads).
  • URL — the destination URL where users will be redirected. Use {{variable_name}} placeholders anywhere in the URL to dynamically insert query string values from the tracking link.
3

Create the link

Click Create to save and generate your Magic Link.

​
Standard URL Formats

The table below shows standard destination URL formats you can paste into the URL field for common use cases. Replace the placeholder values with your own account details.

​
How Redirect and Variable Substitution Works

When a user clicks the public tracking URL — for example:
ChatbotX reads the query string parameters (campaign=summer_sale, source=facebook) and substitutes them into the destination URL you configured. If the URL field contained:
The user is redirected to:
If a query string parameter is omitted from the tracking URL, the corresponding {{variable_name}} placeholder safely resolves to an empty string, so your destination URL will never break.
After creation, each Magic Link appears in the management table. Click the … action menu at the end of any row to perform the following actions:

​
Best Practices

  • Name field: Use only letters, numbers, underscores _, and hyphens -. Avoid spaces or special characters, which will break the public tracking URL structure.
  • Variable substitution: Every {{variable_name}} in the URL field is dynamically replaced by the matching query string parameter passed through the public tracking URL. Variables with no corresponding parameter resolve to an empty string.
  • Unique names per campaign: Give each Magic Link a descriptive, unique name so you can easily identify its purpose in the analytics view.
  • Test before launching: Click your Magic Link with sample parameters and verify that the destination URL receives the correct values before publishing an ad campaign.