ivrig
09/25/2025, 6:24 PMVapi Support Bot
09/25/2025, 6:25 PMhtml
<!-- Example: Embed the widget on a secure (https) Framer page -->
<script src="https://unpkg.com/@vapi-ai/client-sdk-react/dist/embed/widget.umd.js" async type="text/javascript"></script>
<vapi-widget public-key="your-public-key" assistant-id="your-assistant-id" mode="voice"></vapi-widget>
Publish your Framer site and test the widget on the live HTTPS URL to resolve the loading error.
For more, see the [Vapi widget requirements](https://docs.vapi.ai/chat/web-widget).
Source:
- [Web widget documentation](https://docs.vapi.ai/chat/web-widget)ivrig
09/25/2025, 6:55 PMChiranjeet Mishra
09/29/2025, 5:52 PMhtml
<script src="https://unpkg.com/@vapi-ai/client-sdk-react/dist/embed/widget.umd.js" async type="text/javascript"></script>
2. **Add the widget to your HTML**:
html
<vapi-widget
public-key="your-public-key"
assistant-id="your-assistant-id"
mode="chat"
theme="light"
></vapi-widget>
React/TypeScript
1. Install the Vapi SDK if not installed:
bash
npm install @vapi-ai/client-sdk-react
2. **Use the VapiWidget component in your React app**:
jsx
import { VapiWidget } from '@vapi-ai/client-sdk-react';
function App() {
return (
<VapiWidget
publicKey="your-public-key"
assistantId="your-assistant-id"
mode="chat"
/>
);
}
For detailed customization including voice mode, you can follow the [Web widget documentation](https://docs.vapi.ai/chat/web-widget) which provides guidance on configuring interaction modes, appearance, and handling events. If you're encountering display issues like overlay or clipping elements in a site builder such as Framer, consider using floating script-tag widgets or adjusting iframe sizes to avoid interference with your site layout.