Documentation API Trimoji Softskills

Cette API vous permet d'intégrer les capacités d'évaluation de la personnalité de Trimoji directement dans votre plateforme de recrutement ou votre flux de travail.

Trimoji est une solution d'analyse de personnalité pour les recruteurs. Elle permet d'envoyer des questionnaires aux candidats, qui génèrent ensuite des résultats (PDF et web). Une fonctionnalité clé est le "Personi", qui représente le profil idéal pour un poste. Vous pouvez comparer le profil d'un candidat à un Personi pour obtenir un score de correspondance de 0 à 100.

Authentification

Toutes les requêtes API doivent être authentifiées via un partner_token dans l'en-tête Authorization.

La plupart des requêtes nécessitent également un customer_token dans le corps de la requête, identifiant le compte client Trimoji spécifique.

Variable	Type	Description
`base_url`	Chaîne	`https://integration.trimoji.fr/api/v1/softskills`
`partner_token`	Chaîne	Votre jeton unique partenaire.
`customer_token`	Chaîne	La clé API Trimoji de votre client.

Points de terminaison (Endpoints)

1. Récupérer les Campagnes

Récupère la liste des campagnes (offres d'emploi) créées par le client.

Méthode : POST /campaigns

Corps de la requête (JSON) :

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

2. Créer une Campagne Personi

Crée un nouveau Personi (profil idéal) lié à une nouvelle campagne.

Méthode : POST /create/campaign

Paramètres principaux :

campaign_infos: Configuration des tests (court, long, affichage des résultats).
job_offer: Détails du poste (titre, secteur, description, missions).
custom_id: Votre identifiant unique interne pour cette offre.

3. Créer un Personi (Standalone)

Crée un profil idéal sans l'associer directement à une campagne immédiate.

Méthode : POST /create/personi

4. Envoyer l'évaluation au candidat

Initie un processus d'évaluation. Génère un lien unique pour le candidat.

Méthode : POST /init

Paramètre	Description
`candidate_email`	Requis. Email du candidat.
`callback_url`	URL de Webhook pour recevoir les résultats automatiquement.
`is_trimoji_sending`	Si `true`, Trimoji envoie l'email. Sinon, vous gérez l'envoi du lien.

Webhook & Résultats

Une fois le test terminé, Trimoji envoie un POST au callback_url avec :

✅ score : Score de matching (0-100).
✅ grade : failed, passed, ou excelled.
✅ web_report : Lien vers l'analyse web complète.
✅ file_urls : Liens vers les PDF (Synthèse, Entretien, Onboarding, etc.).

5. Récupérer les résultats d'un processus

Récupère les détails d'une évaluation terminée via son ID.

Méthode : GET /profile/:process_id

6. Récupérer les Personis

Liste tous les profils idéaux (Personis) créés par le client.

Méthode : POST /personis

7. Matcher un processus à un Personi

Compare un candidat ayant déjà passé le test à un profil de poste spécifique pour obtenir un nouveau score.

Méthode : POST /matching

{
  "process_id": "ID_DU_TEST_CANDIDAT",
  "personi_id": "ID_DU_PROFIL_IDEAL"
}

Documentation Trimoji Softskills API - Mise à jour 2026

API Softskills