Croma · desenvolvedores

API do Croma

Integre o Croma ao seu ATS, CRM ou fluxo interno: crie avaliações, acompanhe o status e receba os resultados por webhook assim que a pessoa concluir.

Autenticação

Gere sua chave em Área administrativa → API e webhook e envie em todas as chamadas:

Authorization: Bearer vero_sua_chave_aqui

Criar uma avaliação

POST https://pessoas.resultadosdesucesso.com/api/v1/assessments
Content-Type: application/json

{ "name": "Maria Silva", "email": "maria@empresa.com", "role": "Vendedora" }

→ 201
{ "token": "abc123", "assessmentUrl": "https://pessoas.resultadosdesucesso.com/a/abc123", "reportUrl": "https://pessoas.resultadosdesucesso.com/r/abc123" }

Envie o assessmentUrl para a pessoa responder. O reportUrl passa a funcionar após a conclusão.

Listar avaliações

GET https://pessoas.resultadosdesucesso.com/api/v1/assessments

→ 200
{ "data": [ { "token": "abc123", "name": "Maria Silva", "status": "submitted", ... } ] }

Consultar resultados

GET https://pessoas.resultadosdesucesso.com/api/v1/assessments/abc123

→ 200
{
  "status": "submitted",
  "results": {
    "profileCode": "ID",
    "disc": { "natural": { "D": 50, "I": 75, "S": 42, "C": 33 }, "adapted": { ... } },
    "jungType": "ENF",
    "bigfive": { "O": 71, "C": 38, "E": 75, "A": 62, "N": 21 },
    "qualitySeal": "alta"
  }
}

Acrescente ?full=1 para o modelo completo (competências, liderança, valores e checagens de qualidade).

Webhook

Configure a URL na mesma seção do admin. A cada avaliação concluída no seu espaço, o Croma envia um POST (timeout de 10s, sem retry):

{
  "event": "assessment.submitted",
  "token": "abc123",
  "personName": "Maria Silva",
  "personEmail": "maria@empresa.com",
  "profileCode": "ID",
  "jungType": "ENF",
  "qualitySeal": "alta",
  "submittedAt": "2026-08-23T14:00:00Z",
  "reportUrl": "https://pessoas.resultadosdesucesso.com/r/abc123"
}

Limites e escopo

Dúvidas ou precisa de um endpoint que não existe ainda? Fale com a gente.