API Soft Skills Trimoji
Esta API permite integrar as capacidades de avaliação de personalidade da Trimoji diretamente em sua plataforma de recrutamento ou fluxo de trabalho.
Trimoji é uma solução de análise de personalidade para recrutadores. Ela permite enviar questionários aos candidatos, que geram resultados (PDF e web). Uma funcionalidade chave é o "Personi", que representa o perfil ideal para uma vaga. Você pode comparar o perfil de um candidato com um Personi para obter um score de correspondência de 0 a 100.
Chaves de Acesso
Todas as requisições de API devem ser autenticadas via um partner_token no cabeçalho Authorization.
A maioria das requisições também requer um customer_token no corpo da requisição, identificando a conta de cliente Trimoji específica.
| Variável | Tipo | Descrição |
|---|---|---|
base_url |
String | https://integration.trimoji.fr/api/v1/softskills |
partner_token |
String | Seu token de parceiro único. |
customer_token |
String | A chave de API Trimoji do seu cliente. |
Endpoints
1. Recuperar Campanhas
Recupera a lista de campanhas (vagas de emprego) criadas pelo cliente.
Método: POST /campaigns
Corpo da requisição (JSON):
{
"customer_token": "{{customer_token}}",
"query": "test" (opcional)
}2. Criar Campanha Personi
Cria um novo Personi (perfil ideal) vinculado a uma nova campanha.
Método: POST /create/campaign
Parâmetros principais:
campaign_infos: Configuração dos testes (curto, longo, exibição dos resultados).job_offer: Detalhes da vaga (título, setor, descrição, missões).custom_id: Seu ID interno único para esta vaga.
3. Criar um Personi (Autônomo)
Cria um perfil ideal sem associá-lo diretamente a uma campanha imediata.
Método: POST /create/personi
4. Enviar avaliação para o candidato
Inicia um processo de avaliação. Gera um link único para o candidato.
Método: POST /init
| Parâmetro | Descrição |
|---|---|
candidate_email |
Requerido. E-mail do candidato. |
callback_url |
URL de Webhook para receber os resultados automaticamente. |
is_trimoji_sending |
Se true, Trimoji envia o e-mail. Caso contrário, você gerencia o envio do link. |
Webhook & Resultados
Após o teste ser concluído, Trimoji envia um POST para o callback_url com:
- score: Score de correspondência (0-100).
- grade:
failed,passed, ouexcelled. - web_report: Link para a análise web completa.
- file_urls: Links para os PDFs (Síntese, Entrevista, Onboarding, etc.).
5. Recuperar resultados de um processo
Recupera os detalhes de uma avaliação concluída através do seu ID.
Método: GET /profile/:process_id
6. Recuperar Personis
Lista todos os perfis ideais (Personis) criados pelo cliente.
Método: POST /personis
7. Match de um processo com um Personi
Compara um candidato que já passou no teste com um perfil de vaga específico para obter um novo score.
Método: POST /matching
{
"process_id": "ID_DO_TESTE_DO_CANDIDATO",
"personi_id": "ID_DO_PERFIL_IDEAL"
}