Trimoji Soft Skills API

Diese API ermöglicht es Ihnen, die Persönlichkeitsbewertungsfähigkeiten von Trimoji direkt in Ihre Rekrutierungsplattform oder Ihren Workflow zu integrieren.

Trimoji ist eine Persönlichkeitsanalyse-Lösung für Recruiter. Sie ermöglicht das Versenden von Fragebögen an Kandidaten, die dann Ergebnisse (PDF und Web) liefern. Eine Schlüsselfunktion ist der "Personi", der das ideale Profil für eine Stelle darstellt. Sie können das Profil eines Kandidaten mit einem Personi vergleichen, um einen Übereinstimmungs-Score von 0 bis 100 zu erhalten.

Authentifizierung

Zugangsschlüssel

Alle API-Anfragen müssen über ein partner_token im Authorization-Header authentifiziert werden.

Die meisten Anfragen erfordern zusätzlich ein customer_token im Request-Body, das das spezifische Trimoji-Kundenkonto identifiziert.

Variable	Typ	Beschreibung
`base_url`	String	`https://integration.trimoji.fr/api/v1/softskills`
`partner_token`	String	Ihr eindeutiger Partner-Token.
`customer_token`	String	Der Trimoji API-Schlüssel Ihres Kunden.

Referenz-API

Endpunkte (Endpoints)

1. Kampagnen abrufen

Ruft die Liste der vom Kunden erstellten Kampagnen (Stellenangebote) ab.

Methode: POST /campaigns

Request Body (JSON):

{
  "customer_token": "{{customer_token}}",
  "query": "test" (optional)
}

2. Personi-Kampagne erstellen

Erstellt einen neuen Personi (ideales Profil), der mit einer neuen Kampagne verknüpft ist.

Methode: POST /create/campaign

Hauptparameter:

campaign_infos: Konfiguration der Tests (kurz, lang, Anzeige der Ergebnisse).
job_offer: Details der Stelle (Titel, Sektor, Beschreibung, Aufgaben).
custom_id: Ihre interne eindeutige Kennung für dieses Angebot.

3. Personi erstellen (Autonom)

Erstellt ein ideales Profil, ohne es direkt mit einer sofortigen Kampagne zu verknüpfen.

Methode: POST /create/personi

4. Bewertung an Kandidaten senden

Initiiert einen Bewertungsprozess. Generiert einen eindeutigen Link für den Kandidaten.

Methode: POST /init

Parameter	Beschreibung
`candidate_email`	Erforderlich. E-Mail des Kandidaten.
`callback_url`	Webhook-URL zum Empfangen von Ergebnissen per Push.
`is_trimoji_sending`	Wenn `true`, sendet Trimoji die E-Mail. Andernfalls verwalten Sie den Linkversand.

Webhook & Ergebnisse

Sobald der Test abgeschlossen ist, sendet Trimoji eine POST-Anfrage an die callback_url mit:

score: Matching-Score (0-100).
grade: failed, passed, oder excelled.
web_report: Link zur vollständigen Web-Analyse.
file_urls: Links zu den PDFs (Zusammenfassung, Interview, Onboarding etc.).

5. Ergebnisse eines Prozesses abrufen

Ruft die Details einer abgeschlossenen Bewertung anhand ihrer ID ab.

Methode: GET /profile/:process_id

6. Personis abrufen

Listet alle vom Kunden erstellten idealen Profile (Personis) auf.

Methode: POST /personis

7. Prozess mit Personi abgleichen

Vergleicht einen Kandidaten, der den Test bereits absolviert hat, mit einem spezifischen Stellenprofil, um einen neuen Score zu erhalten.

Methode: POST /matching

{
  "process_id": "ID_DES_KANDIDATEN_TESTS",
  "personi_id": "ID_DES_IDEALPROFILS"
}

Trimoji Softskills API Dokumentation - Update 2026

API Soft Skills