Skip to main content

What is SmartAI Assessment?

SmartAI Assessment lets you embed a fully-proctored, AI-generated assessment portal directly inside your own application. You install a backend package and a frontend package — the platform handles everything else.

How the flow works


Quick start

1. Get your API keys

Log into the SmartAI dashboard and copy your API key and Secret key.
  • Prefix VFN_TEST_test / staging environment
  • Prefix VFN_LIVE_live / production environment

2. Install backend package

3. Install frontend package


4. Add a session endpoint to your backend


5. Open the portal from your frontend

Add NEXT_PUBLIC_ASSESSMENT_API_KEY to your frontend .env.local:
Then in your component, call your backend first to get the token, then open the portal:

6. Poll for results in the background


Integration checklist

API key and secret key set as environment variables on your server
Backend session endpoint created and protected by your own auth middleware
Frontend calls your session endpoint before opening the portal
AssessmentPortal.open() receives the token from your backend
onDone and onError callbacks implemented
Background poller running getWebhookEvents() every 30 seconds
Results saved to your database with idempotent upsert on eventId
acknowledgeWebhookEvents() called after every successful save batch