Dokumentation – trønso HR

Überblick#

trønso HR ist eine SaaS-Plattform für digitale Bewerberauswahl. HR-Teams erstellen Tests mit verschiedenen Fragentypen, laden Kandidaten per E-Mail ein und erhalten nach dem Test automatisch ausgewertete Ergebnisse — ohne zusätzliche Software oder technisches Wissen.

Bereich	Beschreibung
Dashboard	Testerstellung, Kandidatenverwaltung, Ergebnisse, Einstellungen
Kandidatenseite	Öffentlicher Test-Link — kein Login für Bewerber nötig
Einladungslink	Persönlicher Einmal-Link per E-Mail an den Kandidaten
REST API	Programmatischer Zugriff (ab Premium)

Erste Schritte#

Registrierung#

Unter /register legst du ein Firmenprofil und deinen Admin-Account an. Danach bist du sofort einsatzbereit — kein Setup, kein Warteschlange.

Firmenname und E-Mail-Adresse eingeben
Sicheres Passwort wählen (mind. 8 Zeichen, Groß-/Kleinschreibung, Zahl oder Sonderzeichen)
E-Mail-Verifizierung abschließen
Fertig — du landest direkt im Dashboard

Der Free Plan ist dauerhaft kostenlos — keine Kreditkarte nötig.

Dashboard#

Das Dashboard ist deine Steuerzentrale. In der linken Sidebar findest du:

Bereich	Funktion
`Tests`	Alle Tests deiner Firma — erstellen, bearbeiten, aktivieren/deaktivieren
`Kandidaten`	Testübergreifende Übersicht aller Bewerber mit Ergebnissen
`Einstellungen`	Abo, Team, API-Keys, Profil

Tests erstellen#

Neuen Test anlegen#

Unter Tests → Neuen Test erstellen vergibst du einen Titel und liegst los. Danach öffnet sich der Test mit vier Tabs:

Tab	Inhalt
Kandidaten	Übersicht aller Einladungen und Versuche für diesen Test
Auswertung	Aggregierte Statistiken und Einzelergebnisse
Editor	Fragen anlegen, bearbeiten, per Drag & Drop sortieren
Einstellungen	Zeitlimit, Branding, Zugangskontrolle, Texte, Marketplace

Fragentypen#

trønso HR unterstützt neun Fragentypen:

Typ	Wann verwenden	Auswertung
Multiple Choice	Eine korrekte Antwort aus mehreren Optionen	Automatisch
Single Choice	Genau eine Antwort aus Dropdown	Automatisch
Offene Textfrage	Freitext — Musterantworten hinterlegbar	Automatisch (exakter Match)
Zahlenfrage	Numerische Antwort	Automatisch
Dropdown	Auswahl aus Liste, eine Antwort	Automatisch
Lineare Skala	Bewertung von 1–10 (oder custom)	Automatisch (Wertebereich)
Raster	Matrix: Zeilen × Spalten zuordnen	Automatisch
Code-Aufgabe	Code schreiben & gegen Testfälle prüfen	Automatisch (ab Basic)
Sortieraufgabe	Elemente in richtige Reihenfolge bringen	Automatisch

Die korrekten Antworten verlassen niemals den Client — die Auswertung findet ausschließlich serverseitig statt.

Bilder & Audio#

Zu jeder Frage können optional Medien hochgeladen werden:

Medium	Fragentypen	Plan
Bild zur Frage	Alle Typen	ab Basic
Bild zu Antwortoptionen	Multiple Choice, Single Choice, Dropdown	ab Basic
Audio zur Frage	Offene Textfrage, Multiple Choice, Single Choice	ab Pro

Dateien werden in den Supabase Storage-Bucket test-media hochgeladen und als öffentliche URL gespeichert. Erlaubte Audio-Formate: MP3, WAV, OGG. Kandidaten sehen einen eingebetteten Audio-Player direkt unter der Frage.

Test-Einstellungen#

Einstellung	Beschreibung
Zeitlimit	In Minuten (0 = kein Limit). Der Timer läuft auf der Kandidatenseite sichtbar.
Bestanden ab	Prozentualer Schwellenwert — erscheint als Badge im Ergebnis.
Score anzeigen	Ob der Kandidat seinen Score auf der Abschlussseite sieht.
Weiterleitung	URL, auf die der Kandidat nach Abschluss weitergeleitet wird.
Branding	Firmenfarbe und Logo — erscheint auf der Kandidatenseite.
Willkommenstext	Titel und Fließtext auf dem Start-Screen.
Regeln/Hinweise	Nummerierte Liste auf dem Start-Screen (eine Regel pro Zeile).
Abschlusstext	Titel und Text nach dem Einreichen.
Ansprechpartner	Name + E-Mail, erscheint auf dem Welcome-Screen.
Fragen randomisieren	Reihenfolge der Fragen wird pro Versuch zufällig gemischt.

Zugangskontrolle#

Im Tab Einstellungen → Zugang & Teilnahme steuerst du, wer den Test machen darf:

Modus	Verhalten
Offen (Standard)	Jede Person mit dem Test-Link kann teilnehmen.
Nur per Einladung	Nur E-Mail-Adressen, die aktiv eingeladen wurden (Einladung nicht abgelaufen), können starten.

Zusätzlich kannst du Mehrfachversuche deaktivieren — dann kann jede E-Mail-Adresse den Test nur einmal abschließen. Die Prüfung erfolgt serverseitig und kann nicht umgangen werden.

Bei Nur per Einladung müssen Kandidaten ihre E-Mail-Adresse im Welcome-Screen eingeben — diese wird gegen die Einladungsliste geprüft. Einladungen laufen nach 7 Tagen ab.

Kandidaten einladen#

Einladung versenden#

Im Tab Kandidaten eines Tests kannst du per E-Mail-Adresse einladen. Pro Einladung wird ein einzigartiger, 64-stelliger Token generiert und per E-Mail verschickt.

Test öffnen → Tab „Kandidaten"
E-Mail-Adresse eingeben → „Einladen" klicken
Kandidat erhält automatisch eine E-Mail mit persönlichem Link

Eigenschaft	Wert
Link-Format	/invite/[64-stelliger-hex-token]
Gültigkeit	7 Tage ab Erstellung
Einmaligkeit	Nach dem ersten Klick wird der Token als verwendet markiert
E-Mail-Versand	Über Resend (DSGVO-konform, Server in der EU)

Einladungsseite#

Beim Klick auf den Einladungslink gelangt der Kandidat auf /invite/[token]. Dort wird der Token geprüft:

Token ungültig oder unbekannt → Fehlermeldung
Token abgelaufen → Fehlermeldung
Token bereits verwendet → Fehlermeldung
Token valid → Weiterleitung zu /candidate/[testId]

Der Kandidat kann den Test auch direkt über /candidate/[testId] aufrufen — sofern der Zugangsmodus „Offen" ist oder die E-Mail-Adresse in der Einladungsliste steht.

Ergebnisse & Auswertung#

Score & Auswertung#

Sobald ein Kandidat den Test einreicht, wird der Score serverseitig berechnet und im Dashboard angezeigt. Die Auswertung erfolgt pro Frage:

Fragentyp	Auswertungslogik
Multiple Choice	Ausgewählte Option muss mit einer korrekten Option übereinstimmen
Single Choice / Dropdown	Exakt eine korrekte Antwort muss ausgewählt sein
Offene Textfrage	Freitext wird mit hinterlegten Musterlösungen verglichen (exakter Match, case-insensitive)
Zahlenfrage	Eingegebene Zahl muss exakt der korrekten Zahl entsprechen
Lineare Skala	Wert muss im definierten Zielbereich liegen
Raster	Alle Zeilen müssen der korrekten Spalte zugeordnet sein

Jede Frage kann unterschiedlich viele Punkte haben (konfigurierbar im Editor). Der Gesamtscore ist die Summe aller erreichten Punkte.

Anti-Cheat-System#

Das Anti-Cheat-System protokolliert verdächtiges Verhalten während des Tests. Jedes Ereignis wird mit Zeitstempel gespeichert und im Ergebnis-Detail angezeigt.

Feature	Beschreibung
Tab-Wechsel	Erkennt, wenn der Kandidat den Browser-Tab verlässt
Fensterfokus-Verlust	Erkennt Alt+Tab und Fenster-Wechsel
Copy & Paste	Blockt Einfügen in Textfelder und loggt Copy-Versuche
Vollbild verlassen	Optional: Test läuft im Vollbild, Verlassen wird geloggt
Maus verlassen	Erkennt, wenn die Maus das Browser-Fenster verlässt
DevTools	Erkennt das Öffnen der Browser-Entwicklertools

Jedes Feature lässt sich einzeln im Tab Proctoring & Überwachung des Tests aktivieren oder deaktivieren.

Proctoring — Kamera & Mikrofon#

Ab dem Pro-Plan kannst du während des Tests automatisch Kamera- und Mikrofon-Aufnahmen machen lassen. Der Kandidat muss vor dem Start explizit zustimmen und Berechtigungen im Browser erteilen.

Einstellung	Verhalten
Kamera aktiv	Alle 30–90 Sekunden wird ein Foto aufgenommen
Mikrofon aktiv	Alle 30–120 Sekunden wird ein 5-Sekunden-Ausschnitt aufgezeichnet
Speicherung	Aufnahmen werden in Supabase Storage gespeichert
Löschung	Automatisch nach 60 Tagen
Sichtbarkeit	Nur für das einladende Unternehmen (nicht für Kandidaten)

Proctoring erfordert die ausdrückliche Einwilligung des Kandidaten — die entsprechende Einwilligungserklärung erscheint automatisch auf dem Welcome-Screen. Stelle sicher, dass deine Datenschutzerklärung die Verarbeitung von Bild- und Tondaten abdeckt.

Team-Verwaltung#

Mitglieder einladen#

Unter Einstellungen → Team kannst du weitere Nutzer zu deiner Firma einladen. Der Eingeladene erhält eine E-Mail mit einem Registrierungslink, der ihn automatisch der Firma zuordnet.

Die Anzahl der Seats (Nutzer pro Firma) hängt vom Plan ab: Free = 1, Basic/Pro = 2, Premium = 5.

Rollen & Rechte#

Rolle	Rechte
Admin	Tests erstellen/bearbeiten, Kandidaten einladen, Team verwalten, Abo verwalten
Viewer	Ergebnisse und Kandidaten einsehen (nur lesen)

Pläne & Limits#

Feature	Free	Basic	Pro	Premium
Preis	0 €	39 €/Mo.	79 €/Mo.	179 €/Mo.
Tests	1	5	10	50
Kandidaten/Monat	5	20	50	200
Seats (Nutzer)	1	2	2	5
Fragen pro Test	5	20	50	150
Max. Antwortoptionen	4	8	15	25
Freitext (Musterlösungen)	300 Z.	1.000 Z.	3.000 Z.	10.000 Z.
Bilder in Fragen & Optionen	—	✓	✓	✓
Audio in Fragen	—	—	✓	✓
Eigenes Branding	—	✓	✓	✓
Proctoring (Kamera/Mikrofon)	—	—	✓	✓
Globale Benchmark-Tests	—	—	✓	✓
REST API & Webhooks	—	—	—	✓

Beim Jahresplan sparst du 20 % gegenüber der monatlichen Abrechnung. Details unter Preise.

REST API#

Die REST API ist ab dem ab Premium-Plan verfügbar und erlaubt die programmatische Integration in externe HR-Systeme und eigene Applikationen.

Authentifizierung#

Alle API-Anfragen werden per Bearer Token authentifiziert. API-Keys werden unter Einstellungen → API-Keys erstellt.

GET /api/v1/tests
Authorization: Bearer trhr_<dein-api-key>

Eigenschaft	Wert
Key-Format	trhr_ + 48 zufällige Hex-Zeichen
Speicherung	Nur der SHA-256-Hash wird in der DB gespeichert
Sichtbarkeit	Der Plaintext-Key wird nur einmal bei Erstellung angezeigt
Widerruf	Jederzeit in den Einstellungen möglich

Speichere deinen API-Key sofort nach der Erstellung — er wird danach nicht mehr angezeigt.

Endpunkte#

Methode	Pfad	Beschreibung
`GET`	/api/v1/tests	Alle Tests deiner Firma auflisten
`GET`	/api/v1/invitations	Einladungen auflisten (paginiert)
`POST`	/api/v1/invitations	Kandidat einladen + Einladungs-E-Mail senden
`GET`	/api/v1/candidates/:email	Kandidat abrufen mit allen Versuchen
`GET`	/api/v1/candidates/:email/results	Alle Ergebnisse eines Kandidaten
`GET`	/api/v1/results/:attemptId	Detailliertes Einzelergebnis mit Antworten

Beispiel: Kandidaten einladen

POST /api/v1/invitations
Authorization: Bearer trhr_...
Content-Type: application/json

{
  "email": "[email protected]",
  "test_id": "uuid-des-tests"
}

Rate Limiting#

Jeder API-Key ist standardmäßig auf 60 Anfragen pro Minute begrenzt. Bei Überschreitung wird HTTP 429 zurückgegeben.

Header	Bedeutung
`X-RateLimit-Limit`	Maximalanzahl an Anfragen pro Minute
`X-RateLimit-Remaining`	Verbleibende Anfragen im aktuellen Fenster
`Retry-After`	Sekunden bis zum Reset (nur bei 429)

Webhook#

Für automatisierte Einladungen steht ein dedizierter Webhook-Endpunkt bereit. Sobald ein Kandidat eine bestimmte Phase in deinem HR-System erreicht, wird automatisch eine trønso-Einladung verschickt.

POST /api/v1/webhook?api_key=trhr_...&test_id=<uuid>

Parameter	Beschreibung
`api_key`	Dein API-Key als Query-Parameter (kein Bearer-Header nötig)
`test_id`	UUID des Tests, zu dem eingeladen werden soll
`WEBHOOK_SECRET`	Optional: HMAC-Signaturprüfung via X-Webhook-Signature Header (sha256=<hmac>)

Bereits eingeladene Kandidaten (aktive Einladung noch vorhanden) werden beim Webhook-Aufruf übersprungen — kein doppelter Versand.

Zuletzt aktualisiert: März 2026

Frage nicht beantwortet? Kontakt →

trønso HR — Handbuch