API Soft Skills Trimoji

Questa API consente di integrare le capacità di valutazione della personalità di Trimoji direttamente nella Sua piattaforma di recruiting o nel Suo flusso di lavoro.

Trimoji è una soluzione di analisi della personalità per i recruiter. Permette di inviare questionari ai candidati, che generano poi risultati (PDF e web). Una funzionalità chiave è il "Personi", che rappresenta il profilo ideale per una posizione. Lei può confrontare il profilo di un candidato con un Personi per ottenere un punteggio di corrispondenza da 0 a 100.

Autenticazione

Chiavi di Accesso

Tutte le richieste API devono essere autenticate tramite un partner_token nell'header Authorization.

La maggior parte delle richieste richiede anche un customer_token nel corpo della richiesta, che identifica lo specifico account cliente Trimoji.

Variabile	Tipo	Descrizione
`base_url`	Stringa	`https://integration.trimoji.fr/api/v1/softskills`
`partner_token`	Stringa	Il Suo token partner unico.
`customer_token`	Stringa	La chiave API Trimoji del Suo cliente.

Riferimento API

Endpoint

1. Recuperare le Campagne

Recupera l'elenco delle campagne (offerte di lavoro) create dal cliente.

Metodo: POST /campaigns

Corpo della richiesta (JSON):

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

2. Creare una Campagna Personi

Crea un nuovo Personi (profilo ideale) collegato a una nuova campagna.

Metodo: POST /create/campaign

Parametri principali:

campaign_infos: Configurazione dei test (breve, lungo, visualizzazione dei risultati).
job_offer: Dettagli della posizione (titolo, settore, descrizione, missioni).
custom_id: Il Suo identificativo univoco interno per questa offerta.

3. Creare un Personi (Autonomo)

Crea un profilo ideale senza associarlo direttamente a una campagna immediata.

Metodo: POST /create/personi

4. Inviare la valutazione al candidato

Inizia un processo di valutazione. Genera un link unico per il candidato.

Metodo: POST /init

Parametro	Descrizione
`candidate_email`	Richiesto. Email del candidato.
`callback_url`	URL di Webhook per ricevere i risultati automaticamente.
`is_trimoji_sending`	Se `true`, Trimoji invia l'email. Altrimenti, Lei gestisce l'invio del link.

Webhook & Risultati

Una volta completato il test, Trimoji invia una richiesta POST al callback_url con:

score : Punteggio di matching (0-100).
grade : failed, passed, o excelled.
web_report : Link all'analisi web completa.
file_urls : Link ai PDF (Sintesi, Colloquio, Onboarding, ecc.).

5. Recuperare i risultati di un processo

Recupera i dettagli di una valutazione completata tramite il suo ID.

Metodo: GET /profile/:process_id

6. Recuperare i Personi

Elenca tutti i profili ideali (Personi) creati dal cliente.

Metodo: POST /personis

7. Effettuare il matching di un processo con un Personi

Confronta un candidato che ha già sostenuto il test con uno specifico profilo di posizione per ottenere un nuovo punteggio.

Metodo: POST /matching

{
  "process_id": "ID_DEL_TEST_DEL_CANDIDATO",
  "personi_id": "ID_DEL_PROFILO_IDEALE"
}

Documentazione API Softskills Trimoji - Aggiornamento 2026