Home/Campaigns/AI Assistant Deployment

AI Assistant Deployment

Once you've created and configured your ZipTier campaign, you're ready to deploy your AI Assistant and start engaging with your audience. ZipTier provides two flexible deployment options to fit your needs: a standalone hosted page or an embeddable widget for your own website.

Both options provide the full ZipTier AI Assistant experience with all your customizations, branding, and content. Choose the option that best fits your marketing strategy, or use both simultaneously for maximum reach.

Deployment Options Overview

Standalone Page

A dedicated ZipTier-hosted URL for your AI Assistant

Best for: Email campaigns, social media, QR codes, direct sharing

Website Embed

A JavaScript widget that adds the AI Assistant to your website

Best for: Landing pages, product pages, support portals

After completing the campaign creation wizard, you'll see both deployment options on the confirmation screen, ready to copy and use.

Option 1: Standalone Page

Every campaign automatically gets a unique, shareable URL that hosts your AI Assistant on ZipTier's platform. This is the simplest deployment option and requires no technical setup.

How It Works

Your campaign link takes visitors directly to a full-page AI Assistant experience. The page displays your branding, greeting message, and all customizations configured during campaign setup.

Example URL:

https://acmeCon2026.ziptier.ai/chat

How to Use

Copy the campaign link from your campaign confirmation or dashboard
Share the link directly with your audience via:
- Email campaigns and newsletters
- Social media posts
- QR codes on printed materials
- Text messages or chat apps
- Presentation slides

Advantages

Zero setup required — Just copy and share
Works everywhere — Any device with a browser
Full-screen experience — Distraction-free conversation
Easy tracking — Simple URL for campaign analytics
QR code friendly — Perfect for print materials and events

Best Practices

Use URL shorteners (like bit.ly) for cleaner links in social media
Create QR codes for event signage, business cards, or printed collateral
Include clear call-to-action text when sharing (e.g., "Ask our AI Assistant")

Option 2: Website Embed

Embed the AI Assistant directly on your own website using a simple JavaScript widget. This adds a floating chat button that opens the full conversation interface without visitors leaving your site.

How It Works

Add a single <script> tag to your website. The widget displays a floating button (customizable text and position) that, when clicked, opens your AI Assistant in a modal overlay.

Embed Code

<script
  src="https://chat.ziptier.ai/wgt/script/latest.js"
  data-chat-url="https://chat.ziptier.ai/bt/v1?id=1234567890"
></script>

Configuration Attributes

Required

Attribute	Description
`src`	The ZipTier widget script URL. Always use the latest script URL provided.
`data-chat-url`	The full URL of your AI Assistant campaign link.

Advanced Widget Customization

For more advanced customization, you can use additional attributes to control the appearance and behavior of the AI Assistant widget. These options allow you to match the widget to your brand and website design.

Attribute	Default	Description	Examples
`data-button-position`	`bottom-right`	Position of the floating chat button	`bottom-left`, `bottom-right`
`data-button-text`	`Ask AI`	Text displayed on the chat button	`Get Help`, `Product Questions?`
`data-button-color`	Theme default	Background color of the chat button	`#667eea`, `rgb(102, 126, 234)`
`data-button-size`	`medium`	Size of the floating chat button	`small`, `medium`, `large`
`data-widget-position`	`center`	Position of the chat widget modal	`left`, `center`, `right`

Complete customization example:

<script
  src="https://chat.ziptier.ai/wgt/script/latest.js"
  data-chat-url="https://chat.ziptier.ai/bt/v1?id=1234567890"
  data-button-position="bottom-right"
  data-button-text="Ask AI"
  data-button-color="#667eea"
  data-button-size="large"
  data-widget-position="right"
></script>

Advantages

Seamless experience — Visitors stay on your website
Contextual help — Provide assistance exactly where users need it
Brand consistency — AI Assistant appears as part of your site
Multiple pages — Add to any page on your site
Customizable appearance — Match button text to page context

Website Embed Installation

Basic Installation

Add the script tag just before the closing </body> tag:

<!DOCTYPE html>
<html>
<head>
  <title>Your Page</title>
</head>
<body>
  <!-- Your page content -->
  
  <!-- ZipTier AI Assistant -->
  <script
    src="https://chat.ziptier.ai/wgt/script/latest.js"
    data-chat-url="https://chat.ziptier.ai/bt/v1?id=1234567890"
  ></script>
</body>
</html>

Platform-Specific Instructions

WordPress

Go to Appearance > Theme Editor (or use a plugin like "Insert Headers and Footers")
Locate your theme's footer.php file
Paste the script tag just before </body>
Save changes

Shopify

Go to Online Store > Themes
Click Actions > Edit Code
Open theme.liquid
Paste the script tag just before </body>
Save changes

Webflow

Go to Project Settings > Custom Code
Paste the script in the Footer Code section
Publish your site

Squarespace

Go to Settings > Advanced > Code Injection
Paste the script in the Footer section
Save changes

Customization Examples

Custom button text for a product page:

<script
  src="https://chat.ziptier.ai/wgt/script/latest.js"
  data-chat-url="https://chat.ziptier.ai/bt/v1?id=1234567890"
  data-button-text="Product Questions?"
></script>

Left-side positioning:

<script
  src="https://chat.ziptier.ai/wgt/script/latest.js"
  data-chat-url="https://chat.ziptier.ai/bt/v1?id=1234567890"
  data-position="bottom-left"
></script>

Event-specific assistant:

<script
  src="https://chat.ziptier.ai/wgt/script/latest.js"
  data-chat-url="https://chat.ziptier.ai/bt/v1?id=1234567890"
  data-button-text="Summit Assistant"
></script>

Choosing the Right Option

Use this guide to determine which deployment option works best for your specific use case. Remember, you can use both options simultaneously.

Use Case	Recommended	Why
Email marketing campaigns	Standalone Page	Easy to include a clickable link
Social media posts	Standalone Page	Direct link works across all platforms
QR codes (print, signage)	Standalone Page	Simple URL converts to clean QR code
Product landing pages	Website Embed	Contextual help while browsing products
Event registration pages	Website Embed	Answer questions without leaving registration flow
Support/FAQ pages	Website Embed	Instant AI assistance for common questions
Webinar follow-up	Both	Link in email + embed on resources page
Trade show booth	Standalone Page	QR code on signage for attendees
Customer portal	Website Embed	Integrated help within existing experience

Troubleshooting

Standalone Page Issues

Link not working — Verify the campaign is within its active date range
Wrong content displaying — Confirm you're using the correct campaign ID
Page not loading — Check your internet connection and try refreshing

Website Embed Issues

Widget not appearing
- Check the data-chat-url matches your campaign link
- Verify campaign is within its active date range
- Look for JavaScript errors in browser console
- Disable ad blockers that may interfere with third-party scripts
Widget positioned incorrectly
- Your site's CSS may override widget positioning
- Try switching between bottom-right and bottom-left
Widget conflicts with other elements
- Other floating elements (cookie banners, chat widgets) may overlap
- Check z-index conflicts in your site's CSS

Best Practices

Use both options strategically — Standalone links for outbound campaigns, embedded widget for inbound traffic
Match button text to context — Use descriptive text like "Event Help", "Product Questions", or "Get Answers"
Test across devices — Verify both options work on desktop and mobile browsers
Monitor your campaign dates — The AI Assistant only functions within your configured start and end dates
Track engagement — Use ZipTier analytics to see how users interact with your AI Assistant across both deployment methods

Need help? Visit our support portal for assistance with deployment or customization.