The website voice widget lets visitors talk to your agent from your site. Create a widget key for the agent, list the domains allowed to use it, and paste the one-line script tag before your site's closing </body> tag. The key only works on the domains you list, so copying the snippet to another site does not let it place calls on your account.
At a glance#
| Item | Value |
|---|---|
| Key | A widget key scoped to one agent, shown masked after creation (wk_****_...) |
| Domain whitelist | Comma-separated list; * wildcards allowed, for example *.example.com |
| Branding | Primary colour and company name |
| Embed | One <script> tag |
| Manage | Owners and admins create and edit keys; members can view them |
| Billing | Calls use your workspace credits at the agent's per-minute rate |
Set it up#
- Open the agent and go to the Widget section.
- Click to create a key. Give it a name, such as "Production website".
- Under Allowed Domains, enter your domains, for example
example.com, *.example.com. - Copy the generated snippet.
- Paste it before
</body>on every page where the widget should appear. - Open your site and test a call.
<script
src="https://voice-agent.edesy.in/widget/voice-widget.js"
data-api-key="YOUR_WIDGET_KEY"
async
></script>
Domain whitelist tips#
| Entry | Matches |
|---|---|
example.com |
Only example.com |
*.example.com |
Subdomains such as www.example.com and shop.example.com |
localhost |
Local testing |
Add your staging domain to a separate key so you can switch it off later without touching production.
FAQs#
Is the widget key secret?
It is visible in your page source, which is why it is tied to an allowed-domains list and to one agent. Never put a server vp_ API key in a web page.
Can I have several widgets? Yes. Create one key per site or environment.
Can I turn a widget off? Yes. Deactivate its key; the snippet stops working straight away.
What about a page I don't control? Use a share link instead.