Skip to main content

​
Introduction

Embedded lets you drop a fully-featured Alcamine Agent into any web page with a single line of HTML. The UI, networking and state-management are all handled for you – just supply the URL of the Agent you want to surface.

​
When to choose Embedded

  • You want the fastest time-to-value and are happy with a ready-made UI.
  • You prefer not to deal with auth, network calls or edge-cases – we manage all of that for you.
  • You still need full access to the JavaScript SDK and low-level Components later on. Start simple, evolve when you need to.
If you would rather design your own chat experience, jump straight to our Components and JS SDK docs.

​
Quick Start

  1. Navigate to the Agent detail page in your workspace.
  2. Click the Share button and copy the generated URL – it will look something like:
https://acme.alcamine.com/acme-sales-assistant
  1. Drop an <iframe> into your site and paste the URL into the src attribute:
<iframe
  class="h-[600px] w-full rounded-lg border shadow-sm"
  src="https://acme.alcamine.com/acme-sales-assistant"
  allow="microphone; camera;"
  loading="lazy"
  style="background: transparent;"
/>
That’s it – refresh the page and your Agent is live.
Permission Note The iframe must include allow="microphone; camera;" so that users can record voice or video messages. You can add additional permissions as your use-case requires.

​
Going further

  • Custom UI Prefer to craft your own look & feel? Head over to Components and JS SDK for granular control.
  • Different embed styles We’re exploring new layouts (floating widgets, side-bars, full-screen modals…). Have a creative use-case? Reach out – we’d love to hear about it.
  • Theming A public theming API is coming soon. Until then, let us know your brand requirements and we’ll help you tailor the experience manually.

​
Next steps

• Read the Components guide to learn how each building block works. • Browse the JS SDK reference to interact with Agents programmatically. • Check the API Reference if you need server-side integration. Happy embedding!