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
- Download the Intufind plugin from your dashboard
- Go to Plugins → Add New → Upload Plugin in WordPress admin
- Upload the ZIP file and click Install Now
- Click Activate
Upload and activate the Intufind plugin
Step 2: Connect with Your API Key
- Go to Intufind in your WordPress admin menu
- Enter your API key (create one in your Intufind dashboard)
- Click Save API Key
Enter your API key to connect to Intufind cloud services
Step 3: Index Your Content
- After activation, Intufind automatically syncs your content
- For WooCommerce stores, products are indexed first
- 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
- Visit the Intufind Shopify App (or search "Intufind" in the Shopify App Store)
- Click Add app
- Review and authorize the required permissions
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
- Go to Online Store → Themes → Customize
- Click App embeds in the left sidebar
- Toggle Intufind Chat to enabled
- Click Save
Enable the widget in theme settings
Step 4: Customize (Optional)
- Go to Apps → Intufind in your Shopify admin
- Customize colors, prompts, and behavior
- Click Save
Custom Integration (Script Tag)
Add the Intufind widget to any website with a single script tag.
Step 1: Get Your Publishable Key
- Log in to your Intufind dashboard
- Go to API Keys
- 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
- Next.js Integration — React component approach
- Developer API Docs — Full REST API reference
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:
- Open your website in a new incognito/private window
- Click the chat widget in the bottom corner
- Ask a question about your products or content
- Verify the response references your actual content
Troubleshooting
| Issue | Solution |
|---|---|
| Widget doesn't appear | Check if content has finished indexing |
| No search results | Verify products/content synced successfully |
| Slow responses | Check your plan's usage limits |
| Widget styling wrong | Clear browser cache and reload |
Next Steps
- Customize your widget — Colors, position, branding
- Set up chat prompts — Guide user conversations
- Configure live agent handoff — Human escalation
- View your dashboard — Monitor usage and analytics