跳到正文

Embed SDK

Embed quickstart.

Run the candidate's interview inside your own careers page or portal, and follow its progress from the page.

最后更新于 2026年11月19日

开发者文档仅提供英文版。

How the embed works

The SDK is one small script. It puts the interview in an iframe on your page and passes you events as the candidate moves through it. The interview itself (branding, consent, microphone check, the room) is the same one candidates get from the email link.

  • A paid plan, and a company admin to allow your site.
  • An invitation link from the API (POST /v1/invitations). Each link is personal to one candidate.
  • Your page served over https (localhost works while you develop).

1. Allow your site

In the dashboard, open Integrations → Embed and add the origin of the page that embeds the interview, like https://careers.example.com: https, no path, up to 20 sites. The interview refuses to load in a frame on any other site. The Embed tab also shows the script's address for your company's data region: interview.testee.ai in the EU, where every company is today, and that region's host (interview.us.testee.ai for the US) elsewhere.

2. Create the invitation

On your server, create the invitation with the API (Invitations) and pass its link to the page. Never put the API key in the page itself.

3. Mount the interview

HTML
<div id="interview"></div><script src="https://interview.testee.ai/embed/v1.js"></script><script>  const embed = TesteeEmbed.mount({    container: "#interview",    link: invitationLink, // "link" from POST /v1/invitations    onEvent: (e) => console.log(e.type, e), // ready | login_required | started | completed | feedback_submitted | error  });</script>

That's all. The candidate signs in inside the frame with the one-time code sent to the address they were invited at (unless your company turned email verification off, or you created the invitation with skipSignIn because your page already signed them in), then takes the interview.

Size

The frame fills the container's width and is 720 px high unless you pass height; it never resizes itself to its content. Give it at least 1024 × 720 px for the desktop layout: narrower, the interview switches to its phone layout, and under about 740 px high its conversation panel shrinks. On phones, let the container fill the screen (height: 100dvh) and pass height: "100%".