Installation
Add the Yaplet widget to any website with a single code snippet, or follow a platform-specific guide for WooCommerce, Shopify, WordPress, and popular JavaScript frameworks.
Embed Code
Adding the widget to your site takes a single script tag. Paste it just above the closing </body> tag on every page where you want the widget to appear.
Find your embed code
In your Yaplet dashboard, go to Brand → Chat widget and open the Install tab, headed Put Yaplet on your website. The tab asks Where does your website run? If Yaplet recognized your platform when your brand was set up (WordPress, Shopify, Wix, Squarespace, Webflow, UNAS or Shoprenter), that button is already selected, with the line We think your site runs on followed by the platform's name. Anything it did not recognize starts on Other website. You can always pick another platform, and a platform you click yourself is remembered in this browser. The tab shows the code in the form the selected platform needs. The snippet shown there already has your widget's ID filled in, and the copy button puts it on your clipboard.
Above the steps, a light tells you where the install stands: a gray Waiting for your website… that turns green, Live on and your site's address, as soon as the chat first loads on your website.
Add it to your site
Insert the snippet into your website's HTML, just above the closing </body> tag:
<script>
!(function (Yaplet, t, i) {
if (!(Yaplet = window.Yaplet = window.Yaplet || []).invoked) {
var widgetId = "YOUR_WIDGET_ID";
for (
window.YapletActions = [],
Yaplet.invoked = !0,
Yaplet.methods = [
"identify",
"setEnvironment",
"setTags",
"attachCustomData",
"setCustomData",
"removeCustomData",
"clearCustomData",
"registerCustomAction",
"trackEvent",
"log",
"showSurvey",
"sendSilentCrashReport",
"startFeedbackFlow",
"startBot",
"setAppBuildNumber",
"setAppVersionCode",
"setApiUrl",
"setFrameUrl",
"isOpened",
"open",
"close",
"on",
"setLanguage",
"setOfflineMode",
"initialize",
"disableConsoleLogOverwrite",
"logEvent",
"hide",
"enableShortcuts",
"showFeedbackButton",
"destroy",
"getIdentity",
"isUserIdentified",
"clearIdentity",
"openConversation",
"openHelpCenterCollection",
"openHelpCenterArticle",
"openNewsArticle",
"isLiveMode",
"setFlowConfig",
"setAdminUrl",
"setWSApiUrl",
],
Yaplet.f = function (e) {
return function () {
var t = Array.prototype.slice.call(arguments);
window.YapletActions.push({ e: e, a: t });
};
},
t = 0;
t < Yaplet.methods.length;
t++
)
Yaplet[(i = Yaplet.methods[t])] = Yaplet.f(i);
((Yaplet.load = function (id) {
var t = document.getElementsByTagName("head")[0],
i = document.createElement("script");
((i.type = "text/javascript"), (i.async = !0), (i.src = "https://yaplet.com/api/sdk/loader?widgetId=" + encodeURIComponent(id)), t.appendChild(i));
}),
Yaplet.load(widgetId),
Yaplet.initialize(widgetId));
}
})();
</script>
<script> line and end with a </script> line; if what you copied starts with !function (Yaplet instead, type <script> on a new line before it and </script> on a new line after it. If you are copying the snippet from this page instead, replace YOUR_WIDGET_ID with the ID shown on the Install tab.Verify it works
Reload your website. You should see the Yaplet launcher button in the bottom-right corner, and the light on the Install tab turns green. Click the button to open the widget and confirm everything loads correctly.
Yaplet.identify() are rejected unless they carry a hash of the user's ID, signed on your server. The secret for that is on the same Install tab, under Identity verification. Set it up before you ship identify(), or your signed-in users will stay anonymous in the inbox.If Someone Else Runs Your Website
Under the code, My developer does this opens a box with three ways to pass the install on:
- Copy link — a link to a page made for your developer. They need no Yaplet login. It shows the steps for your platform, the code with a copy button and the same light as your Install tab, plus a Different platform? row in case the platform is wrong. The page is in Hungarian when your dashboard is on yaplet.hu.
- Copy message — a ready-made message to paste into any chat app or email: your website, the platform, the steps, the link, the code and the guide.
- Email — opens your own mail app with the same message, ready for you to add your developer's address.
The light on your Install tab turns green once the chat is live on your website, so you see it without asking.
Can't get to your site's code right now? Your chat link, at the bottom of the tab, is a page where visitors chat with you with nothing installed. Share it on your contact page, Instagram bio or Google profile, and use Copy to put it on your clipboard. Every workspace gets it, free ones too, and the page shows your brand's logo on a band in your brand color.
Framework-Specific Installation
If you're using a JavaScript framework, add the same script tag to your app shell or layout component:
Paste the embed code directly into your HTML file before </body>.
Add the script tag to your root layout file (app/layout.tsx or pages/_document.tsx), or load it in a useEffect hook on your top-level component.
Place the script in your app.vue or nuxt.config.ts via the app.head.script option.
Platform Guides
For specific platforms, follow the dedicated step-by-step guides:
WordPress
Install the official Yaplet – Live Chat & AI Chatbot plugin and enter your widget ID — no code to paste.