Skip to main content

​
Overview

The Orova widget is a self-contained JavaScript file that adds a floating chat/voice/video button to any website. It handles all the UI, WebRTC connections, and API communication.

​
Installation

<script
  src="https://app.orova.ai/widget/orova-widget.js"
  data-api-key="YOUR_API_KEY"
  data-agent-id="AGENT_ID"
  data-server-url="https://app.orova.ai"
  data-mode="voice"
  data-title="Acme Support"
  data-theme="light"
  data-primary-color="#312E56"
  data-position="bottom-right"
  data-subtitle="We typically reply instantly"
></script>

​
Full attribute reference

AttributeRequiredDefaultDescription
data-api-keyYes—Orova API key
data-agent-idYes—Agent ID
data-server-urlYes—API server URL
data-modeNochatchat, voice, video, multi
data-positionNobottom-rightbottom-right, bottom-left
data-themeNolightlight, dark
data-primary-colorNo#111111Brand color (hex)
data-titleNoOrovaHeader title
data-subtitleNoWe typically reply instantlyHeader subtitle
data-greetingNo(auto)Custom greeting (overrides agent’s first message)

​
Modes

​
chat — Text only

Simple chat interface with message input and streaming responses.

​
voice — Chat + Voice picker

Shows a selection screen where users choose between text chat and voice call.

​
video — Video call

Video call with a realistic avatar. Includes mute, camera toggle, and end call controls.

​
multi — Voice + Video picker

Shows a selection screen where users choose between voice call and video call.

​
Styling

The widget creates its own shadow DOM and doesn’t conflict with your site’s CSS. The data-primary-color controls all accent colors including:
  • Floating action button
  • User message bubbles
  • Header background
  • Send button
  • Active states

​
Browser support

  • Chrome 80+
  • Firefox 80+
  • Safari 14+
  • Edge 80+
WebRTC voice calls require microphone permission. Video calls load the required SDK automatically.