autoch.at Documentation

Appearance

Shortlinks and Domain Management ​

Configure short domains and trackable shortlinks to keep messages shorter (especially in SMS) and track link clicks.

Overview ​

The shortlink system provides two features:

  1. Short Domain Replacement: Automatically replace your long domain with a shorter one in all messages
  2. Shortlink Tracking: Convert URLs into trackable shortlinks with UTM parameters for analytics

Benefits ​

  • SMS Character Savings: Shorter URLs save valuable characters in text messages
  • Better Branding: Consistent use of your preferred short domain across all channels
  • Click Tracking: Track which links customers click and when
  • Analytics Integration: UTM parameters automatically added for Google Analytics and other tools
  • Cleaner links: Use short, branded links in customer messages

Short Domain Replacement ​

Short domain replacement automatically converts your long domain to a shorter one in all AI-generated messages.

How It Works ​

When your AI assistant includes URLs in messages, the system automatically replaces your long domain with your configured short domain.

Example:

  • Long Domain: superdavesautosales.ca
  • Short Domain: sdas.cc
  • Original URL: https://superdavesautosales.ca/products
  • Replaced URL: https://sdas.cc/products

Configuration ​

Short domain replacement is configured in Settings → Branding:

  1. Short Domain: Enter your short domain (e.g., sdas.cc)
  2. Long Domain: Enter your original domain (e.g., superdavesautosales.ca)

Note: Both domains must be configured for replacement to work.

What Gets Replaced ​

The system replaces your long domain in:

  • Full URLs: https://superdavesautosales.ca/products → https://sdas.cc/products
  • URLs with paths: superdavesautosales.ca/about → sdas.cc/about
  • URLs with query strings: superdavesautosales.ca?ref=123 → sdas.cc?ref=123
  • Markdown links: [Products](https://superdavesautosales.ca/products) → [Products](https://sdas.cc/products)

Advanced Short Domain Setup ​

For production use, you can configure a managed short domain with SSL certificates:

  1. Go to Settings → Branding → Short Domains
  2. Click Add Short Domain
  3. Enter your short domain name
  4. Follow DNS verification instructions
  5. System automatically generates SSL certificate
  6. Domain becomes active once verified

Managed Short Domains:

  • Automatic SSL certificate management
  • DNS verification and monitoring
  • Certificate renewal handled automatically
  • Suitable for production

Shortlink tracking converts URLs into short, trackable links with UTM parameters for analytics.

How It Works ​

When shortlink tracking is enabled, URLs in your AI assistant's messages are automatically converted to shortlinks:

Example:

  • Original URL: https://sdas.cc/products?category=vehicles
  • Shortlink: https://sdas.cc/abc123
  • Destination: Same URL with UTM parameters added automatically

Shortlink tracking is available in Settings → Branding after you've configured a short domain:

  1. Ensure you have a Short Domain configured
  2. Enable Shortlink Tracking toggle
  3. Configure UTM Source (default: ai_agent)

UTM Parameters ​

Shortlinks automatically include UTM parameters for analytics tracking:

  • utm_source: Identifies the source (default: ai_agent or your custom value)
  • utm_medium: The communication channel (sms, email, chat, voice)
  • utm_campaign: Optional campaign identifier
  • utm_content: Optional content identifier
  • utm_term: Optional term identifier

Example Shortlink:

https://sdas.cc/abc123
→ Redirects to: https://sdas.cc/products?utm_source=ai_agent&utm_medium=sms

UTM Source Configuration ​

You can customize the utm_source parameter:

  • Default: ai_agent
  • Custom: Set your own value (e.g., company_name, marketing_campaign)

This helps you identify traffic from your AI assistant in analytics tools like Google Analytics.

Shortlinks are generated when:

  • Your AI assistant includes URLs in responses
  • Shortlink tracking is enabled
  • A short domain is configured (yours or system default)

Channels:

  • ✅ SMS messages
  • ✅ Email messages
  • ✅ Chat messages
  • ✅ Voice call transcripts (if URLs are shared)

Analytics and Tracking ​

Click Analytics ​

Track shortlink performance in your dashboard:

  • Total Clicks: Number of times each shortlink was clicked
  • Click History: Detailed log of each click with timestamp
  • Channel Breakdown: See clicks by channel (SMS, email, chat, voice)
  • Geographic Data: Country and city information (when available)
  • Device Information: User agent and referrer data

Accessing Analytics ​

View shortlink analytics in:

  • Dashboard: Overview of shortlink performance
  • Analytics Section: Detailed click statistics and history
  • Conversation View: See which links were clicked in each conversation

Integration with Analytics Tools ​

UTM parameters in shortlinks work seamlessly with:

  • Google Analytics: Automatic tracking of traffic sources
  • Other Analytics Tools: Standard UTM parameter support
  • Custom Dashboards: Export data via API

System Default Domain ​

If you haven't configured your own short domain, the system can use a default short domain provided by administrators. This allows shortlink generation to work immediately without requiring domain setup.

When Default Domain is Used:

  • You haven't configured your own short domain
  • System default domain is available
  • Shortlinks will use the default domain

Note: Your own short domain always takes priority over the system default.

Best Practices ​

Short Domain Selection ​

  1. Keep It Short: Shorter domains save more characters in SMS
  2. Make It Memorable: Choose something easy to remember
  3. Brand Consistency: Use your brand name or abbreviation
  4. Check Availability: Ensure the domain is available and registered

UTM Parameter Strategy ​

  1. Consistent Naming: Use consistent utm_source values
  2. Channel Tracking: Let the system automatically set utm_medium
  3. Campaign Tracking: Use utm_campaign for specific marketing campaigns
  4. Content Differentiation: Use utm_content to differentiate link variations
  1. Enable When Needed: Only enable shortlink tracking when you need analytics
  2. Monitor Performance: Regularly review click analytics
  3. Test Links: Verify shortlinks work correctly after configuration
  4. Update UTM Source: Customize utm_source to match your analytics needs

Configuration Steps ​

Quick Setup (Basic) ​

  1. Go to Settings → Branding
  2. Enter your Short Domain (e.g., sdas.cc)
  3. Enter your Long Domain (e.g., superdavesautosales.ca)
  4. Save changes

Domain replacement will now work automatically.

Full Setup (With Tracking) ​

  1. Complete Quick Setup above
  2. Enable Shortlink Tracking toggle
  3. Set UTM Source (optional, defaults to ai_agent)
  4. Save changes

Shortlinks will now be generated for all URLs in messages.

Advanced Setup (Managed Domain) ​

  1. Go to Settings → Branding → Short Domains
  2. Click Add Short Domain
  3. Enter domain name
  4. Follow DNS verification steps
  5. Wait for SSL certificate generation
  6. Domain becomes active automatically

Troubleshooting ​

Domain Replacement Not Working ​

Check:

  • Both short and long domains are configured
  • Domains are entered correctly (no typos)
  • Settings have been saved

Solution: Verify domain configuration in Settings → Branding.

Check:

  • Short domain is configured (yours or system default)
  • Shortlink tracking is enabled
  • URLs are included in AI responses

Solution: Ensure short domain is configured and shortlink tracking is enabled.

Check:

  • Short domain DNS is configured correctly
  • SSL certificate is valid (for managed domains)
  • Domain is active

Solution: Verify domain status in Settings → Branding → Short Domains.

Analytics Not Showing ​

Check:

  • Shortlinks are being clicked
  • UTM parameters are configured correctly
  • Analytics tool is set up to track UTM parameters

Solution: Verify UTM source configuration and check analytics tool settings.

Examples ​

Example 1: Basic Domain Replacement ​

Configuration:

  • Short Domain: sdas.cc
  • Long Domain: superdavesautosales.ca

AI Response:

Check out our inventory at https://superdavesautosales.ca/vehicles

Sent to Customer:

Check out our inventory at https://sdas.cc/vehicles

Configuration:

  • Short Domain: sdas.cc
  • Shortlink Tracking: Enabled
  • UTM Source: ai_agent

AI Response Includes:

Visit https://sdas.cc/products to see our selection

System Generates:

  • Shortlink: https://sdas.cc/abc123
  • Destination: https://sdas.cc/products?utm_source=ai_agent&utm_medium=sms

Sent to Customer:

Visit https://sdas.cc/abc123 to see our selection

When Clicked:

  • Redirects to: https://sdas.cc/products?utm_source=ai_agent&utm_medium=sms
  • Click is tracked in analytics

Example 3: Custom UTM Source ​

Configuration:

  • Short Domain: sdas.cc
  • Shortlink Tracking: Enabled
  • UTM Source: super_daves_auto

Result:

  • Shortlinks include: utm_source=super_daves_auto
  • Easy to identify in Google Analytics

Next Steps ​

autoch.at Documentation

Copyright © 2024 autoch.at