Widget Installation
Getting Your Embed Code
Navigate to Dashboard -> Assistants -> Your Bot -> Embed Code. You will see a snippet similar to:
<script src="https://cdn.conviro.io/widget/widget.iife.js"></script>
<script>
cw('init', { publicKey: 'pk_YOUR_PUBLIC_KEY' });
</script>
Below are step-by-step instructions for every major platform.
WordPress
- Go to your WordPress admin panel.
- Navigate to Appearance -> Theme File Editor -> footer.php (or use a plugin like Insert Headers and Footers).
- Paste the embed code just before the \</body\> tag.
- Click Update File.
- Clear any caching plugin (WP Super Cache, W3 Total Cache, etc.) and verify.
Shopify
- In Shopify admin, go to Online Store -> Themes -> Actions -> Edit Code.
- Open theme.liquid.
- Paste the embed code before \</body\>.
- Click Save.
Wix
- Go to Settings -> Custom Code in your Wix dashboard.
- Click + Add Custom Code.
- Paste the embed code, set placement to Body - End.
- Apply to All pages and click Apply.
Squarespace
- Go to Settings -> Advanced -> Code Injection.
- Paste the embed code in the Footer field.
- Click Save.
Custom HTML / Static Sites
Simply paste the embed code before the closing \</body\> tag in your HTML file. The widget script loads asynchronously and will not block page rendering.
React / Next.js
For React or Next.js projects, you can load the widget in your root layout or \<App\> component:
// app/layout.tsx (Next.js App Router example)
import Script from 'next/script';
export default function RootLayout({ children }) {
return (
<html>
<body>
{children}
<Script
src="https://cdn.conviro.io/widget/widget.iife.js"
strategy="afterInteractive"
/>
<Script id="conviro-init" strategy="afterInteractive">
{`cw('init', { publicKey: 'pk_YOUR_PUBLIC_KEY' });`}
</Script>
</body>
</html>
);
}
Verifying the Installation
- Open your website in a browser.
- You should see the Conviro chat bubble in the bottom-right (or bottom-left, depending on your settings).
- If it does not appear, check the Widget Not Showing troubleshooting article.