Skip to main content

Embedding the Clara widget

In plain words

The widget is a small chat bubble for your website. Your customers ask questions, Clara answers with all of its safety checks in place, and every conversation leaves a record you can look up later. Installing it is one line of code, and it only works on the websites you approve.

This page is for developers, with an operator checklist your admin can follow.

Install: one script tag​

Configure the assistant in the portal: give it a persona and knowledge, list the allowed website addresses, and set its status to live. Then paste this on your page:

<script
  src="https://embed.clara.paresium.com/v1/widget.js"
  data-assistant="ast_your_assistant_id">
</script>

Beta host, same worker: https://embed.dev.clara.paresium.com/v1/widget.js.

What happens when a customer chats​

The customer sees a floating Clara button that opens a chat panel. While Clara works, progress updates stream into the panel. The finished answer shows a Governed by Clara badge and the record id for that conversation.

How it stays safe​

  • Only your websites. Sessions are only granted to page addresses you list on the assistant. Every other website is refused on our servers, not just in the browser, so it cannot be faked.
  • Anonymous visitors, short sessions. Your customers never sign in. Their session lasts 15 minutes and renews automatically while they chat. Spend comes out of your organisation's credits.
  • Everything recorded. Each conversation produces a record. Open it from the portal's Activity page, or look up the id the widget shows.

Operator checklist​

  1. Portal, then your assistant, then Deploy and Web widget: add the exact page address (https://..., no path on the end).
  2. Flip the assistant's status to live. Draft assistants refuse to chat.
  3. Paste the snippet on a page whose address matches your list.
  4. Prove the lock works: load the snippet from a different address and confirm it is refused with origin_not_allowed.
Beta

Conversations run against the beta environment with test-mode billing. Your allowed-address list is enforced on our servers.