Skip to main content

​
What You’ll Learn

  • What deeplinks are and why they matter
  • How to structure deeplinks for your website
  • How to instruct your AI Agent to use them
  • A complete example using categories, styles, and sizes
A deeplink is a URL that leads directly to a specific part of your website. Instead of sending users to your homepage or main shop, a deeplink can point to:
  • A specific product category
  • A filtered search result
  • A specific size, style, or variant
  • A personalized or pre-applied filter combination
This allows your AI Agent to answer with precise, actionable links tailored to what the user wants. Every website is different, but the logic remains the same: Start with a base URL, then add filters (like category, style, size, color, etc.) as URL parameters. For the example below, we’ll use this base URL:
1

Add a Product Category

Attach a category parameter:
Example category mapping:If the user asks for a category that doesn’t exist, your AI Agent should return the list of available categories.
2

Add Style Preferences (Optional)

If the user specifies a style, append:
Example style codes:If no style is mentioned, skip this parameter.
3

New Step

Append the size code:
Your AI Agent will only add this when the user mentions a size.
4

Full Example

A user asks:
The AI Agent constructs the URL:
This deeplink leads directly to filtered results for medium, casual T-shirts.
5

Step-by-Step: Add Deeplinks to Your AI Agent

To make sure your AI Agent correctly builds deeplinks, add clear rules to the AI Agent settings section at GuidelinesRecommended Instruction

​
Best Practices

  • Keep your category and filter lists up to date
  • Use hyperlink formatting (e.g., View results) rather than raw URLs
  • Test multiple example scenarios in the tester
  • Make sure your AI Agent only includes parameters the user actually mentioned