Chat
Website widget
Install a branded, streaming chat bubble on your website with one script tag.
Install
Paste before </body>
<script src="https://katexs.com/widget.js" data-assistant="YOUR_PUBLIC_ID" async></script>Find the snippet with your agent's public id in Website widget.
Branding options
- brandNamestring
- Up to 80 characters. Default "Assistant". Shown in the widget header.
- logoUrlhttps URL
- Your logo. Must be an
https://image URL. - colorhex
- Accent color,
#RRGGBB. Default#34D399. - themeenum
dark(default) orlight.- positionenum
bottom-right(default) orbottom-left.- greetingstring
- Up to 500 characters. Default "Hi! How can I help you today?"
- quickRepliesstring list
- Up to 6 buttons, each up to 100 characters.
- prechatobject
- Ask for
name,emailand/orphonebefore the chat starts. Each is off by default.
Allowed origins
The widget only works on origins you list. Each entry is an origin: protocol, host and optional port, with no path, for example https://www.example.com. Requests from anywhere else are refused with "This website is not authorized for this assistant."
Behavior
- Renders in a shadow DOM, isolated from your site's CSS and scripts.
- Streams replies token by token.
- Keeps the visitor's session for 30 days in an HttpOnly, Secure cookie scoped to the chat endpoint.
- Phone numbers in the pre-chat form must be in international format, for example
+15125550123. - When the agent isn't live, shows "Chat is being set up. Please check back soon." When the platform is unavailable, shows "Chat is temporarily offline. Please try again later."
Last updated November 2026 · Found a problem? Email support@katexs.com
