Home/Docs/Installation

Install Salesdok Voice on Your Store

Add one script tag to your store. Takes under 2 minutes. Works everywhere.

Shopify · WooCommerce · Wix · Next.js · Any site
Where to find your Widget ID
Your unique Widget ID is available in your Salesdok dashboard. Go to your Agent → Embed tab to copy it. Go to dashboard

Shopify Installation

1
Log in to your Shopify Admin
Go to your Shopify store admin panel.
2
Navigate to theme code
Go to Online Store → Themes → click the three-dot menu on your current theme → Edit code.
3
Open theme.liquid
In the left sidebar, under Layout, click on theme.liquid.
4
Paste the widget script
Scroll to the bottom of the file. Paste the script tag just before the closing </body> tag.
5
Save and preview
Click Save, then visit your store to verify the voice widget appears in the bottom-right corner. Since theme.liquid is the global layout, the widget will automatically appear on every page of your store — homepage, collections, product pages, cart, and checkout.
<!-- Paste this before </body> in theme.liquid -->
<script
  src="https://salesdok-voice.vercel.app/widget.js"
  data-widget-id="YOUR_WIDGET_ID"
></script>
theme.liquid wraps every page in your Shopify store, so one install covers all pages automatically — no need to add the script to individual templates. If you prefer not to edit theme code, you can also use the free Shopify "Custom Pixels" feature or a script injector app from the Shopify App Store.

Best Practices

Follow these tips to get the most out of your AI salesperson.

1
Place the script before </body>
Always add the widget script just before the closing </body> tag, never inside <head>. This ensures your page content loads first and the widget doesn’t block rendering.
2
Use one script per page
Only include the widget script once per page. If you’re using a global layout file (theme.liquid, _app.tsx, footer.php), it will automatically load on every page — no need to add it to individual templates.
3
Train your agent before going live
Upload your product catalog, FAQs, return policies, and sizing guides before embedding the widget. The more knowledge your AI salesperson has, the better it sells.
4
Choose the right persona
Use "The Closer" for high-intent pages (product pages, cart). Use "The Consultant" for browsing pages (collections, homepage). Use "Knowledge Bot" for support/FAQ pages.
5
Test on mobile
Most Indian D2C traffic is mobile. Test the widget on your phone — it should appear as a small floating button that doesn’t obstruct your CTA buttons or navigation.
6
Monitor your conversations
Check your Salesdok dashboard regularly to see what questions customers are asking. Use these insights to improve your knowledge base and product descriptions.

Multi-Page Sites

How the widget works across your entire store — from homepage to checkout.

1
Global installation (recommended)
Place the script in your site’s global layout file — theme.liquid (Shopify), footer.php (WooCommerce), or root layout (Next.js). This ensures the widget appears on every page with a single install. The widget automatically detects which page the visitor is on and provides contextual answers.
2
The widget persists across navigations
When a customer navigates between pages, the widget opens in a popup window that stays open across page loads. The conversation continues seamlessly — no disconnections, no lost context. Your AI salesperson follows the customer through their entire shopping journey.
3
Page-specific context
The widget automatically sends the current page URL and title to the AI agent. So if a customer is on a product page and asks "is this good for dry skin?", the agent knows which product they’re referring to — no need for the customer to specify.
4
Selective page installation
If you want the widget only on certain pages: On Shopify, wrap the script in a Liquid condition like {% if template contains "product" %}. On Wix, select "Specific pages" in Custom Code settings. On WordPress, use WPCode’s page targeting rules.
5
SPAs and client-side routing
For React, Next.js, or other single-page apps: the widget handles client-side routing automatically. It detects URL changes and updates the page context sent to the agent. No extra configuration needed.

Troubleshooting