Skip to main content

​
Install

Paste this just before </body> on every page. Your Workspace ID is already filled in on Integrations → Website chat, which everyone on your team can open.
That’s all you need for live chat. Everything below is optional.

​
Check it worked

  • Open Integrations → Website chat and leave it open. The Install tab checks by itself and turns green within seconds of your site loading the chat.
  • On localhost it says Testing. It turns green once a real website loads it.
  • Nothing? Open your browser’s console. A wrong Workspace ID shows as an error starting with [Frictionless].

​
Options

Colour, button corner, chat size, opening on page load and the WhatsApp button are set without code in Settings → Website chat. Anything you pass to init() wins over those settings on that website.
​
string
How big the chat is when open. "normal" is the default window by the button, "half" takes one side of the screen, "full" takes the whole screen. On phones, all three fill the screen.
​
boolean
true opens the chat when the page loads, on every page, until the visitor closes it. After that it stays closed for the rest of their visit. It never opens by itself on phones, where it would cover your site.
​
boolean
false hides the chat button, so you can open the chat from your own.
​
string
"left" or "right": which corner the button sits in.
​
string
A hex colour, like "#001F3E".
​
string
Header text. Defaults to your business name.
​
string
The number for the Continue on WhatsApp button, like "2348012345678".
​
boolean
false turns off the chime when a reply arrives.

​
WordPress, Shopify and site builders

Install a plugin that adds code to the footer, such as WPCode, and paste the two lines into the footer section.
Using Next.js or React? See Next.js and React.