Skip to main content
The embed widget runs an intervyo.ai interview inside your own product or job page — your branding, your domain. Results report back to your backend over webhooks. The flow has three parts: a one-time embed token for your account, a snippet on the page, and a register call that creates the participant when someone starts.
1

Generate an embed token

In the dashboard, go to Developer → Embed and generate your embed secret + token. The token is account-scoped (signed with your account’s embed secret), not per-candidate — so you mint it once and reuse it.To generate it programmatically from a signed-in session instead:
curl -X POST "https://www.intervyo.ai/api/embed-config/token" \
  -H "Content-Type: application/json" \
  -d '{ "accountSlug": "your-team-slug" }'
# → { "token": "<embed-token>" }
The embed token authorizes participant registration for your account. Keep the embed secret server-side; rotate it from the dashboard to invalidate issued tokens.
2

Register the candidate

When a candidate starts, register them against a template (or program). This creates the participant and returns the interview to load:
curl -X POST "https://www.intervyo.ai/api/embed/register" \
  -H "Content-Type: application/json" \
  -d '{
    "accountSlug": "your-team-slug",
    "accountId": "<account-uuid>",
    "templateId": "ce1cd564-...",
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "token": "<embed-token>"
  }'
Provide exactly one of templateId or programId.
3

Drop the snippet

Mount the widget on the page where the candidate takes the interview:
<div id="intervyo-root"></div>
<script async src="https://cdn.intervyo.ai/widget.js"
        data-token="EMBED_TOKEN_HERE"
        data-mount="#intervyo-root"></script>
The widget handles mic permissions, voice setup, and end-of-call cleanup.
4

Receive results

The widget posts no scores to the browser. Listen for session.completed / session.scored on your webhook endpoint and route the scorecard wherever it needs to go.
The embed widget is in active rollout. Get in touch for the production snippet URL and a full integration guide for your stack.
Last modified on June 2, 2026