getting started/Quick Start Guide

Quick Start Guide

Get Intufind running on your website in just a few minutes. Choose your platform below.

WordPress / WooCommerce

Step 1: Install the Plugin

  1. Download the Intufind plugin from your dashboard
  2. Go to Plugins → Add New → Upload Plugin in WordPress admin
  3. Upload the ZIP file and click Install Now
  4. Click Activate

WordPress plugin installation Upload and activate the Intufind plugin

Step 2: Connect with Your API Key

  1. Go to Intufind in your WordPress admin menu
  2. Enter your API key (create one in your Intufind dashboard)
  3. Click Save API Key

Enter your API key to connect to Intufind cloud services

Step 3: Index Your Content

  1. After activation, Intufind automatically syncs your content
  2. For WooCommerce stores, products are indexed first
  3. Watch the progress in the status panel

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 Intufind → Chat → Styling
  • Configure suggested prompts in Intufind → Prompts
  • Set up live agent handoff in Intufind → Chat → Live Agent

Shopify

Step 1: Install the App

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

Shopify app installation Install Intufind from the Shopify App Store

Step 2: Automatic Setup

Once installed, Intufind automatically:

  • Syncs your entire product catalog
  • Indexes content for AI-powered search
  • 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 Intufind Chat to enabled
  4. Click Save

Enable Shopify app embed Enable the widget in theme settings

Step 4: Customize (Optional)

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

Custom Integration (Script Tag)

Add the Intufind widget to any website with a single script tag.

Step 1: Get Your Publishable Key

  1. Log in to your Intufind dashboard
  2. Go to API Keys
  3. Copy your Publishable Key (starts with if_pk_)

Step 2: Add the Widget

Add this single line before </body>:

<script 
  src="https://cdn.intufind.com/widget/v2/loader.js"
  data-publishable-key="if_pk_your_key_here"
  async
></script>

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

Configuration Options

For more control, use the config object approach:

<script>
window.intufindConfig = {
  publishableKey: 'if_pk_your_key_here',
  title: 'AI Assistant',
  greeting: 'How can I help you today?',
  widgetPosition: 'bottom-right',
};
</script>
<script src="https://cdn.intufind.com/widget/v2/loader.js" async></script>

Framework-Specific Guides


Indexing Content (API)

To index your content for AI-powered search, use our SDK:

npm install @intufind/sdk
import { IntufindClient } from '@intufind/sdk';

const client = new IntufindClient({
  apiKey: 'if_sk_your_secret_key', // Secret key (server-side only!)
  siteId: 'your-site-id'
});

// Index a product
await client.products().upsert({
  id: 'prod_123',
  title: 'Example Product',
  description: 'Product description here',
  price: 29.99,
  url: 'https://yoursite.com/products/example'
});

// Index content/posts
await client.posts().upsert({
  id: 'post_456',
  title: 'Blog Post Title',
  content: 'Full post content here...',
  url: 'https://yoursite.com/blog/post'
});

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

IssueSolution
Widget doesn't appearCheck if content has finished indexing
No search resultsVerify products/content synced successfully
Slow responsesCheck your plan's usage limits
Widget styling wrongClear browser cache and reload

Next Steps