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 (
localhostworks 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
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%".