Skip to main content

Script tag

Add this to your HTML, just before the closing </body> tag:
<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"
></script>

Required attributes

AttributeDescription
data-api-keyYour Orova API key
data-agent-idThe agent ID to connect to
data-server-urlYour Orova API server URL
All three required attributes must be set or the widget won’t load.

React / Next.js

export default function Layout({ children }) {
  return (
    <html>
      <body>
        {children}
        <script
          src="https://app.orova.ai/widget/orova-widget.js"
          data-api-key={process.env.NEXT_PUBLIC_OROVA_API_KEY}
          data-agent-id="AGENT_ID"
          data-server-url={process.env.NEXT_PUBLIC_OROVA_SERVER_URL}
          data-mode="voice"
        />
      </body>
    </html>
  );
}

Vue

<template>
  <div id="app">
    <router-view />
  </div>
</template>

<script>
export default {
  mounted() {
    const script = document.createElement('script');
    script.src = 'https://app.orova.ai/widget/orova-widget.js';
    script.setAttribute('data-api-key', 'YOUR_API_KEY');
    script.setAttribute('data-agent-id', 'AGENT_ID');
    script.setAttribute('data-server-url', 'https://app.orova.ai');
    script.setAttribute('data-mode', 'voice');
    document.body.appendChild(script);
  }
}
</script>

WordPress

Add the script tag to your theme’s footer.php or use a plugin like “Insert Headers and Footers” to add it site-wide.

Verify installation

Open your browser’s developer console. You should see:
[Orova Widget] Initialized
If you see Missing required attributes, check that all three required attributes are set.