API Soft Skills Trimoji

Esta API le permite integrar las capacidades de evaluación de personalidad de Trimoji directamente en su plataforma de contratación o flujo de trabajo.

Trimoji es una solución de análisis de personalidad para reclutadores. Permite enviar cuestionarios a los candidatos, que luego generan resultados (PDF y web). Una característica clave es el "Personi", que representa el perfil ideal para un puesto. Puede comparar el perfil de un candidato con un Personi para obtener una puntuación de coincidencia de 0 a 100.

Autenticación

Claves de Acceso

Todas las solicitudes API deben ser autenticadas a través de un partner_token en la cabecera Authorization.

La mayoría de las solicitudes también requieren un customer_token en el cuerpo de la solicitud, que identifica la cuenta de cliente Trimoji específica.

Variable	Tipo	Descripción
`base_url`	Cadena	`https://integration.trimoji.fr/api/v1/softskills`
`partner_token`	Cadena	Su token de socio único.
`customer_token`	Cadena	La clave API de Trimoji de su cliente.

Referencia API

Puntos de Terminal (Endpoints)

1. Obtener Campañas

Recupera la lista de campañas (ofertas de empleo) creadas por el cliente.

Método: POST /campaigns

Cuerpo de la solicitud (JSON):

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

2. Crear una Campaña Personi

Crea un nuevo Personi (perfil ideal) asociado a una nueva campaña.

Método: POST /create/campaign

Parámetros principales:

campaign_infos: Configuración de las pruebas (corta, larga, visualización de resultados).
job_offer: Detalles del puesto (título, sector, descripción, misiones).
custom_id: Su identificador interno único para esta oferta.

3. Crear un Personi (Autónomo)

Crea un perfil ideal sin asociarlo directamente a una campaña inmediata.

Método: POST /create/personi

4. Enviar la evaluación al candidato

Inicia un proceso de evaluación. Genera un enlace único para el candidato.

Método: POST /init

Parámetro	Descripción
`candidate_email`	Requerido. Correo electrónico del candidato.
`callback_url`	URL de Webhook para recibir los resultados automáticamente.
`is_trimoji_sending`	Si es `true`, Trimoji envía el correo electrónico. De lo contrario, usted gestiona el envío del enlace.

Webhook y Resultados

Una vez completada la prueba, Trimoji envía un POST a la callback_url con:

score: Puntuación de coincidencia (0-100).
grade: failed, passed, o excelled.
web_report: Enlace al análisis web completo.
file_urls: Enlaces a los PDF (Resumen, Entrevista, Onboarding, etc.).

5. Obtener los resultados de un proceso

Recupera los detalles de una evaluación completada a través de su ID.

Método: GET /profile/:process_id

6. Obtener Personis

Lista todos los perfiles ideales (Personis) creados por el cliente.

Método: POST /personis

7. Coincidir un proceso con un Personi

Compara un candidato que ya ha realizado la prueba con un perfil de puesto específico para obtener una nueva puntuación.

Método: POST /matching

{
  "process_id": "ID_DE_LA_PRUEBA_DEL_CANDIDATO",
  "personi_id": "ID_DEL_PERFIL_IDEAL"
}

Documentación API Softskills Trimoji - Actualización 2026