Introduction
Embed Trueyy's live interview-integrity monitoring directly into your own ATS or hiring product.
The Trueyy SDK lets you embed live interview-integrity monitoring - real-time AI-tool detection, transcript analysis, and risk scoring - directly into your own ATS or hiring product. Your interviewers and candidates never leave your app.
Two packages, one integration
Trueyy ships as a small set of packages. A full integration uses two of them: one on your backend, one on your frontend.
@trueyy-sdk/node
Backend. Holds your tk_live_ API key, creates interviews and rounds, mints short-lived browser tokens, verifies webhooks, and pulls reports.
@trueyy-sdk/web
React frontend. Drop-in <TrueyyMonitor>, <TrueyyJoin>, and <TrueyyReplay> components plus hooks for a fully custom UI.
@trueyy-sdk/web-core
Advanced. Framework-agnostic browser client + Helper bridge. Use directly only for non-React or vanilla-JS integrations.
Which do I install?
Building a normal React integration? Install @trueyy-sdk/node on your server and @trueyy-sdk/web on your frontend. @trueyy-sdk/web-core is pulled in automatically as a dependency of @trueyy-sdk/web - you only install it directly for non-React frontends.
How it fits together
- Your backend (
@trueyy-sdk/node) creates an interview and its rounds, then mints a short-lived (5-minute) browser token per round and role. - Your frontend (
@trueyy-sdk/web) takes that token, opens a secure WebSocket to Trueyy Cloud, and renders the live monitoring UI. - Trueyy streams risk pulses, transcript segments, and window analysis to the interviewer in real time, and delivers webhooks to your backend as the session progresses.
- After the round, your backend pulls the final report.
Your master tk_live_ API key never touches the browser - see Architecture for the full token-flow diagram and security model.
Get started
Quickstart
A complete backend-to-frontend integration in about 60 seconds of reading.
Authentication
API keys, plan requirements, and how browser tokens are minted.
Requirements
- Backend: Node.js ≥ 18 (native
fetch,AbortController,crypto). - Frontend: React 17+ and an evergreen browser (Chrome, Edge, Firefox, Safari - last 2 versions).
- A Trueyy plan that includes SDK access (Growth, annual Starter, or Enterprise). See Authentication.
Support
- Source, issues, and discussions: github.com/Anti-Cheating/trueyy-sdk
- Dashboard: app.trueyy.com