ORAM.AI Chatbot

Secure, voice-enabled, and multi-tenant chatbot — add it with a single script tag.

Check our DEMO

Step 1: Add the loader

Copy-paste the snippet below just before the closing </body> tag of your page. The loader will securely request the authorized widget for your domain.

<!-- ORAMA Chat Loader (authorized delivery) -->
<script
  id="orama-chat-loader"
  src="https://orama.applied-ai.gr/embed/chat-loader.js"
  data-api-key="test_api_key_123"
  data-user-key="user-123"
  data-chat-ui-lang="en"
  data-theme="light"
  data-stealth-mode="off"
  data-chat-mic-btn="on"
  data-chat-speaker="on"
  data-chat-conversation="on"
  data-fullscreen="off"
></script>

Configuration attributes

You can customize the widget using the data-* attributes on the loader tag. The loader passes these to the widget after authorization.

Required

src

Loader URL. In development it’s usually https://orama.applied-ai.gr/embed/chat-loader.js.

data-api-key

Your tenant API key. This authorizes both the widget delivery and the chat/history API calls.

Example: data-api-key="test_api_key_123"

⚠️ Important: Your domain must be allowlisted for this API key, or the widget will not load.

data-user-key

Your user identifier on your site/app. It can be a pseudonymous token. The widget uses this to scope history.

Example: data-user-key="user-123"

Optional

data-chat-ui-lang

Widget UI language.

Options: "en" (English), "el" (Greek)

Default: "en"

data-theme

Theme appearance. Not working for now.

Options: "light" or "dark"

Default: "light"

data-stealth-mode

Privacy mode. When on, no messages are stored on the server; history is kept in the browser session only.

Options: "on" or "off"

Default: "off"

data-chat-mic-btn

Show the one-tap microphone button for single-utterance recording.

Options: "on" or "off" (default "on")

data-chat-speaker

Auto-speak the assistant’s replies using TTS.

Options: "on" or "off" (default "on")

data-chat-conversation

Hands-free conversation loop (listen → transcribe → reply → speak → listen...).

Options: "on" or "off" (default "on")

data-fullscreen

Enable fullscreen mode for the chat widget.

Options: "on" or "off" (default "off")

Examples

Example 1: Minimal (required only)

<script
  src="https://orama.applied-ai.gr/embed/chat-loader.js"
  data-api-key="test_api_key_123"
  data-user-key="user-123"
></script>

Example 2: Voice + auto-speak (recommended)

<script
    src="https://orama.applied-ai.gr/embed/chat-loader.js"
    data-api-key="test_api_key_123"
    data-user-key="user1234"
    data-stealth-mode="off"
    data-theme="light"
    data-chat-conversation="on"
    data-chat-speaker="on"
    data-chat-mic-btn="on"
    data-chat-ui-lang="en"
></script>

Example 3: Stealth mode (no server storage)

<script
  src="https://orama.applied-ai.gr/embed/chat-loader.js"
  data-api-key="test_api_key_123"
  data-user-key="user-123"
  data-stealth-mode="on"
  data-chat-ui-lang="en"
></script>

Security & Access Control

⚠️ Important:

© 2025 ORAM.AI Chatbot