Install
Place the script and the custom element on the pages where the agent should appear.
<script src="https://ceronica.duvi.ai/scripts/chat-bot-widget.js" defer></script>
<digiiq-chatbot agent-id="YOUR_AGENT_ID"></digiiq-chatbot>The widget on this site
Ceronica, the assistant available across this website, is a live Duvi agent delivered through this widget. It is the same public integration shown above.
Attributes
| Attribute | Required | What it does |
|---|---|---|
agent-id | Yes | Names the agent that opens the conversation. |
variables | No | A JSON object of non-sensitive page context. |
Page variables
variables must be valid JSON whose top level is an object. Names use 1 to 64 letters, digits or underscores. Values may be strings, numbers or booleans, and Duvi drops anything else. Invalid JSON is ignored with a console warning. Changing the attribute reconnects the widget.
<digiiq-chatbot
agent-id="YOUR_AGENT_ID"
variables='{"page":"pricing","plan":"pro"}'
></digiiq-chatbot>Conversation threads
A visitor can hold several conversation threads. The widget keeps the current thread and lets the visitor return to earlier ones without merging their histories.
Text and voice
The agent response mode can be text, voice or both. Voice also requires a configured transcriber and voice on the agent. The widget does not override those choices locally.
Ratings
The widget can collect a rating on the conversation. Duvi attaches the result to that conversation, where it appears in the conversation browser.
Frames and style isolation
The widget isolates its UI in a shadow root, so host-page styles do not leak into it. It refuses to render inside an iframe unless the frame element carries data-digiiq-allow-widget, and it marks itself so screen control ignores the widget’s own interface.