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

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

1. Copy the campaign link from your campaign confirmation or dashboard
2. 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 style, text, color, 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

Advanced Widget Customization

Use the optional attributes below to match the widget button to your brand and website design. All attributes are optional — omit any to use the default.

Button Style & Appearance

Avatar Style (data-button-style="avatar" only)

Button Position & Widget Size

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-style="pill"
  data-button-text="Ask AI"
  data-button-color="#667eea"
  data-button-text-color="#ffffff"
  data-button-size="large"
  data-button-font="Inter"
  data-button-corner="rounded"
  data-button-position="bottom-right"
  data-widget-width="400px"
  data-widget-height="800px"
></script>

Launcher Button Styles

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 — Four launcher styles, full color and font control

Widget Builder Playground

Before embedding the widget on your website, marketers can use the Widget Builder Playground to experiment with all available JS tag parameters in real time — no code required. Adjust button style, text, color, size, font, position, corner style, bounce animation, and widget dimensions, then instantly see how the widget will look on a simulated web page across desktop, tablet, and phone viewports. Once you're happy with the configuration, copy the generated embed code directly from the playground.

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

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

Shopify

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

Webflow

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

Squarespace

1. Go to Settings > Advanced > Code Injection
2. Paste the script in the Footer section
3. Save changes

Customization Examples

Search-bar launcher with pre-filled message:

<script
  src="https://chat.ziptier.ai/wgt/script/latest.js"
  data-chat-url="https://chat.ziptier.ai/bt/v1?id=1234567890"
  data-button-style="textbox"
  data-button-text="What would you like to know?"
></script>

Agent avatar launcher:

<script
  src="https://chat.ziptier.ai/wgt/script/latest.js"
  data-chat-url="https://chat.ziptier.ai/bt/v1?id=1234567890"
  data-button-style="avatar"
  data-button-text="Ask Alex"
  data-button-avtr-initials="AL"
  data-button-color="#667eea"
></script>

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="Ask Our AI About This Product"
></script>

Left-side positioning with bounce animation:

<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-left"
  data-button-animation="ON"
></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.

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

1. Use both options strategically — Standalone links for outbound campaigns, embedded widget for inbound traffic
2. Match button style to context — Use textbox on product pages where users arrive with specific questions, avatar for high-touch experiences, pill or fab for general use
3. Match button text to context — Use descriptive text like "Event Help", "Product Questions", or "Get Answers"
4. Test across devices — Verify both options work on desktop and mobile browsers
5. Monitor your campaign dates — The AI Assistant only functions within your configured start and end dates
6. Track engagement — Use ZipTier analytics to see how users interact with your AI Assistant across both deployment methods