interlocute.ai beta
Create a node

Website Embedding

Drop an AI chat widget onto any website with a single code snippet. Publishable API keys and domain allowlists make embedding secure and effortless.

Try Interlocute Read the docs

What is website embedding?

Website embedding lets you add an AI chat interface to any web page. Interlocute provides two embedding methods: a lightweight iframe snippet for zero-dependency integration, and a JavaScript widget for customizable floating chat. Both connect directly to your node's endpoint.

Secure by default

Embedded chat uses publishable API keys — keys that are safe to include in client-side code because they are scoped to specific domains and capabilities. You configure a domain allowlist so the key only works on your approved domains, preventing unauthorized use.

Two integration paths

The iframe embed is a single HTML tag that renders a chat interface inside your page. The JavaScript widget adds a floating chat bubble with customizable positioning and theming. Both methods support streaming responses and inherit all of your node's capabilities.

Production-ready

Embedded chat inherits all node features: memory, RAG, tool use, and guardrails. Usage is tracked per publishable key, so you can monitor and control embedded chat independently from API usage.

Frequently Asked Questions

Website Embedding

How do I embed an Interlocute chat on my website?
Interlocute provides two options: an iframe snippet (a single HTML tag) or a JavaScript widget (a script tag). Both connect to your node's endpoint and render a chat interface on your page. Setup takes minutes.
Is it safe to put an API key in client-side code?
Yes, when you use a publishable API key. Publishable keys are specifically designed for client-side use — they are scoped to specific domains via an allowlist and restricted to chat interactions. They cannot access management APIs or other nodes.
What is a domain allowlist?
A domain allowlist restricts which websites can use your publishable API key. If someone copies your embed code to a different domain, the key will be rejected. This prevents unauthorized use of your node through embedded chat.
Can I customize the appearance of the chat widget?
The JavaScript widget supports customizable positioning, theming, and behavior. The iframe embed renders a clean interface that adapts to its container. Both support streaming responses for a responsive user experience.
Does embedded chat support memory and RAG?
Yes. Embedded chat connects to the same node endpoint as API calls, so it inherits all configured features including memory, RAG, tool use, and guardrails. The experience is identical to interacting with the node via the API.
How is embedded chat usage tracked?
Usage is tracked per publishable key and per node. You can monitor embedded chat usage independently from API usage, making it easy to understand the cost and volume of your website chat integration.

Documentation

Embed via IFrame JavaScript Widget

Related Features

Addressable Nodes

Every node is a stable, named endpoint with its own identity, API keys, and usage history. Address your AI like you address a web page.

Guardrails & Governance

Control what your AI can do with granular policies — token quotas, refusal semantics, access restrictions, and execution boundaries.

Agent Deployment

Deploy AI agents as stable, addressable endpoints in seconds. No infrastructure to manage, no containers to orchestrate.

Ready to build with Website Embedding?

Deploy your node in seconds and start using Website Embedding today.

Try Interlocute Read the docs