Installing the Widget
Installing via JavaScript Snippet
Add the Convot widget to any website by pasting a two-line snippet before the closing body tag.
The Convot widget works on any website that lets you add custom JavaScript. You paste one configuration object and one script tag, and the widget loads automatically.
The snippet
Find your snippet at Settings → Apps → [your app] → Setup. It looks like this:
<script>
window.Convot = { app_id: "app_YOUR_KEY_HERE" };
</script>
<script async src="https://app.convot.com/widget-loader.js"></script>
Paste both lines just before the closing </body> tag of your HTML. If you use a tag manager (Google Tag Manager, Segment, etc.), paste the combined block there instead.
Framework-specific notes
Plain HTML
Add the snippet to your layout file or every page where you want the widget.
React / Next.js (App Router)
Add the snippet to your root layout (app/layout.tsx) using next/script with strategy="afterInteractive", or add it as a raw <script> in a useEffect in your root component.
React / Next.js (Pages Router)
Add both tags to _document.js inside the <body>, or use next/script in _app.js.
Remix
Add the snippet to app/root.tsx inside the <body> tags rendered by your <Scripts /> component.
Webflow / Framer / static sites
Use the site-wide custom code section (usually under Settings → Custom code → Before </body> tag) to paste the snippet once.
Confirming the install
After publishing your change, open the page and look for the chat bubble in the corner. If it does not appear, see My widget isn’t showing.
The app_id is safe to include in client-side code - it’s a public identifier, not a secret.
Identifying users (optional but recommended)
If visitors are logged in to your product, call Convot.identify after the snippet has loaded to tie conversations to their user record:
<script>
Convot.identify({
email: "[email protected]",
external_id: "user_123",
name: "Jane Doe"
});
</script>
For full identify options and how to sign the call securely, see App key and identity secret.
Next steps
Was this article helpful?
Thanks for your feedback!