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
| Attribute | Description |
|---|
data-api-key | Your Orova API key |
data-agent-id | The agent ID to connect to |
data-server-url | Your 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.