Quick Start Guide

Get Savanto running on your website in under 60 seconds. Choose the method that fits your platform.

Quick Start (Any Website) — Recommended

The fastest way to get started. Paste your website URL and Savanto crawls your site, trains your AI assistant, and gives you a widget embed code — all in under 60 seconds.

Step 1: Sign Up

1. Create a free account (no credit card required)
2. You'll land on the onboarding wizard

Step 2: Enter Your Website URL

1. In the Quick Start section, enter your website URL (e.g., yoursite.com)
2. Click Train My AI
3. Watch as Savanto discovers and indexes your pages in real-time

Your AI assistant is trained on your actual website content — pages, posts, products, FAQs, and more.

Step 3: Add the Widget

Once crawling completes, you'll see a success message with your embed code:

<script
  src="https://cdn.savanto.ai/chat-loader.js"
  data-publishable-key="if_pk_your_key_here"
  data-workspace-id="your-workspace-id"
  async
></script>

Copy this code and paste it before the closing </body> tag on your website. That's it — your AI assistant is live.

Step 4: Customize (Optional)

After setup, visit your Savanto dashboard to:

• Customize widget colors and branding
• Configure suggested prompts
• Set up live agent handoff
• Add more content sources

WordPress / WooCommerce

For WordPress sites, you can use the Quick Start method above, or install our dedicated plugin for deeper integration with automatic content sync.

Step 1: Install the Plugin

Option A: WordPress Plugin Directory

1. In WordPress admin, go to Plugins → Add New
2. Search for "Savanto"
3. Click Install Now, then Activate

Option B: Download from Website

1. Download the plugin from savanto.ai/downloads/wordpress
2. Go to Plugins → Add New → Upload Plugin in WordPress admin
3. Upload the ZIP file and click Install Now
4. Click Activate

Step 2: Connect with Your API Key

1. Go to Savanto in your WordPress admin sidebar
2. Enter your API key (find it in your Savanto dashboard → API Keys)
3. Click Save API Key

Step 3: Content Syncs Automatically

After connecting, Savanto automatically syncs your content:

• Posts and pages are indexed immediately
• WooCommerce products sync with prices, images, and variants
• Custom post types can be enabled in Savanto → Knowledge

Step 4: You're Live!

The chat widget is automatically enabled after sync completes. Visit your site to see it in action.

Optional customizations:

• Adjust widget colors in your dashboard
• Configure suggested prompts in Savanto → Chat
• Set up live agent handoff in Savanto → Chat → Live Agent
• Manage which content syncs in Savanto → Knowledge

For full details, see WordPress Installation and WordPress Getting Started.

Shopify

Step 1: Install the App

1. Visit the Savanto Shopify App (or search "Savanto" in the Shopify App Store)
2. Click Add app
3. Review and authorize the required permissions

Step 2: Automatic Setup

Once installed, Savanto automatically:

• Syncs your entire product catalog
• Indexes collections and pages
• Configures default widget settings

Step 3: Enable the Widget

1. Go to Online Store → Themes → Customize
2. Click App embeds in the left sidebar
3. Toggle Savanto Chat to enabled
4. Click Save

Step 4: Customize (Optional)

1. Go to Apps → Savanto in your Shopify admin
2. Customize colors, prompts, and behavior
3. Click Save

For full details, see Shopify Installation and Shopify Getting Started.

Custom Integration (Script Tag)

Add the Savanto widgets to any website with a single script tag. This works alongside the Quick Start method or as a standalone integration.

Chat Widget

Add this single line before </body>:

<script
  src="https://cdn.savanto.ai/chat-loader.js"
  data-publishable-key="if_pk_your_key_here"
  data-workspace-id="your-workspace-id"
  async
></script>

That's it! The chat widget will appear on your site.

Search Widget (Optional)

Want instant ⌘K search? Add the search widget alongside the chat:

<script
  src="https://cdn.savanto.ai/search-loader.js"
  data-publishable-key="if_pk_your_key_here"
  data-workspace-id="your-workspace-id"
  async
></script>

Visitors can press ⌘K (Mac) or Ctrl+K (Windows) to open instant search.

See Search Widget Documentation for full configuration options.

Configuration Options

For more control, use the config object approach:

<script>
window.savantoConfig = {
  publishableKey: 'if_pk_your_key_here',
  workspaceId: 'your-workspace-id',
  title: 'AI Assistant',
  greeting: 'How can I help you today?',
  widgetPosition: 'bottom-right',
};
</script>
<script src="https://cdn.savanto.ai/chat-loader.js" async></script>

Framework-Specific Guides

• Framework Integration — React, Next.js, Vue, and more

Indexing Content (API)

For custom integrations, use the Savanto SDK to index your content programmatically:

npm install @savantoai/ai-sdk

import { createClient, upsertProduct, upsertPost } from '@savantoai/ai-sdk';

const client = createClient({
  baseUrl: 'https://api.savanto.ai',
  auth: 'if_sk_your_secret_key', // Secret key (server-side only!)
});

// Index a product
await upsertProduct({
  client,
  body: {
    id: 'prod_123',
    name: 'Example Product',
    content: 'A detailed product description used for semantic search and AI responses.',
    price: 29.99,
    url: 'https://yoursite.com/products/example',
  },
});

// Index content/posts
await upsertPost({
  client,
  body: {
    id: 'post_456',
    title: 'Blog Post Title',
    content: 'Full post content here — the more detail, the better the AI responses.',
    url: 'https://yoursite.com/blog/post',
  },
});

See the API reference for all available endpoints and types.

Note: Use your Secret Key (if_sk_) for server-side indexing. Never expose it in client-side code. The Publishable Key (if_pk_) is safe for the widget.

Verify It's Working

After setup, test your integration:

1. Open your website in a new incognito/private window
2. Click the chat widget in the bottom corner
3. Ask a question about your products or content
4. Verify the response references your actual content

Troubleshooting

Next Steps

• Search Widget Setup — Add ⌘K instant search
• Chat Widget Customization — Colors, position, branding
• Framework Integration — React, Next.js, Vue
• WordPress Docs — Full WordPress guide
• Shopify Docs — Full Shopify guide
• Dashboard Overview — Monitor usage and analytics