Trimoji Soft Skills API

Met deze API integreer je de persoonlijkheidsevaluatiemogelijkheden van Trimoji rechtstreeks in jouw recruitmentplatform of workflow.

Trimoji is een oplossing voor persoonlijkheidsanalyse voor recruiters. Hiermee kun je vragenlijsten naar kandidaten sturen, die vervolgens resultaten (PDF en web) genereren. Een belangrijke functie is de "Personi", die het ideale profiel voor een functie vertegenwoordigt. Je kunt het profiel van een kandidaat vergelijken met een Personi om een matching score van 0 tot 100 te verkrijgen.

Authenticatie

Toegangssleutels

Alle API-verzoeken moeten worden geauthenticeerd via een partner_token in de Authorization header.

De meeste verzoeken vereisen ook een customer_token in de request body, die het specifieke Trimoji-klantaccount identificeert.

Variabele	Type	Beschrijving
`base_url`	String	`https://integration.trimoji.fr/api/v1/softskills`
`partner_token`	String	Jouw unieke partner token.
`customer_token`	String	De Trimoji API key van jouw klant.

API Referentie

Endpoints

1. Campagnes ophalen

Haalt de lijst met campagnes (vacatures) op die door de klant zijn aangemaakt.

Methode: POST /campaigns

Request body (JSON):

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

2. Campagne Personi aanmaken

Creëert een nieuwe Personi (ideaal profiel) gekoppeld aan een nieuwe campagne.

Methode: POST /create/campaign

Hoofdparameters:

campaign_infos: Configuratie van de tests (kort, lang, weergave resultaten).
job_offer: Vacature details (titel, sector, omschrijving, missies).
custom_id: Jouw unieke interne identificatie voor dit aanbod.

3. Personi (zelfstandig) aanmaken

Creëert een ideaal profiel zonder deze direct te koppelen aan een specifieke campagne.

Methode: POST /create/personi

4. Evaluatie naar kandidaat sturen

Initieert een evaluatieproces. Genereert een unieke link voor de kandidaat.

Methode: POST /init

Parameter	Beschrijving
`candidate_email`	Vereist. E-mailadres van de kandidaat.
`callback_url`	Webhook URL om automatisch resultaten te ontvangen.
`is_trimoji_sending`	Als `true`, stuurt Trimoji de e-mail. Anders beheert u de verzending van de link.

Webhook & Resultaten

Zodra de test is voltooid, stuurt Trimoji een POST naar de callback_url met:

score: Matching score (0-100).
grade: failed, passed, of excelled.
web_report: Link naar de volledige webanalyse.
file_urls: Links naar de PDF's (Samenvatting, Sollicitatiegesprek, Onboarding, etc.).

5. Resultaten van een proces ophalen

Haalt de details van een voltooide evaluatie op via zijn ID.

Methode: GET /profile/:process_id

6. Personi's ophalen

Maakt een lijst van alle ideale profielen (Personi's) die door de klant zijn aangemaakt.

Methode: POST /personis

7. Proces matchen met een Personi

Vergelijkt een kandidaat die de test al heeft afgelegd met een specifiek functioprofiel om een nieuwe score te verkrijgen.

Methode: POST /matching

{
  "process_id": "ID_VAN_DE_KANDIDAATTEST",
  "personi_id": "ID_VAN_HET_IDEALE_PROFIEL"
}

Trimoji Softskills API Documentatie - Update 2026