Início rápido

Uma integração segue sempre o mesmo percurso: o seu ATS abre uma sessão de configuração, o recrutador define a avaliação num iframe e, depois, o seu ATS atribui essa avaliação aos candidatos. A Skillee conduz a conversa e devolve o resultado à sua ferramenta.

Antes de começar

Precisa do identificador da empresa (company_id) que a Skillee lhe entrega na ativação: 32 caracteres hexadecimais, por exemplo abc123def4567890abc123def4567890.

As chamadas são feitas para https://api-charlee2.skillee.ai. O endereço histórico https://api-charlie.skillee.ai serve a mesma aplicação: uma integração existente não tem nada a alterar.

Autenticação

Cada chamada inclui o identificador da empresa no cabeçalho Authorization:

Authorization: Bearer abc123def4567890abc123def4567890

Algumas rotas aceitam também company_id no corpo ou como parâmetro de consulta. Quando o identificador está presente nos dois sítios, os dois valores têm de ser idênticos; caso contrário, a chamada é recusada com 401. Um valor que não seja composto por 32 caracteres hexadecimais é recusado com 400.

Cuidado

O identificador da empresa é um segredo: chame a API apenas a partir do seu servidor, nunca a partir do navegador do recrutador.

O percurso

1. Abrir a sessão de configuração. O seu servidor envia a oferta à Skillee e recebe o endereço do iframe. A chamada é idempotente: a mesma oferta corresponde sempre ao mesmo recrutamento.

   curl https://api-charlee2.skillee.ai/partners/beetween/assessment-builder-sessions \
     -H "Authorization: Bearer $COMPANY_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "offerId": "OFFER-2026-001",
       "jobTitle": "Preparador de encomendas",
       "jobDescription": "Contrato sem termo em Lyon, horário diurno, experiência como operador de empilhador valorizada…"
     }'

   { "iframeUrl": "https://…" }

2. Apresentar o iframe. O recrutador escolhe o agente, o canal e as perguntas e, depois, valida. O iframe envia então à sua página o identificador da avaliação, o testId. Ver Iframe de configuração.

3. Guardar o testId com a oferta no seu ATS. Designa a avaliação em todas as atribuições futuras.

4. Atribuir a avaliação a um candidato. A Skillee contacta-o de imediato.

   curl https://api-charlee2.skillee.ai/partners/beetween/assessments \
     -H "Authorization: Bearer $COMPANY_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "assessmentId": "<testId>",
       "applicant": {
         "firstName": "Marie",
         "lastName": "Dupont",
         "email": "marie.dupont@example.com",
         "phone": "+33612345678"
       },
       "recruiter": { "email": "recrutador@empresa.pt" }
     }'

   { "id": "…" }

   Ver Atribuir candidatos para os lotes, a idempotência e os créditos.

Os resultados

A Skillee devolve ao seu ATS o progresso de cada candidato: pendente, respondido (com a pontuação e o relatório) ou em falha (com o motivo). Este retorno passa pela ligação que a nossa equipa configura consigo na ativação; não há nada a consultar do seu lado.

Sem iframe

Se construir o seu próprio ecrã de configuração, chame diretamente POST /partners/charlee/v2/list/assessments para ler as avaliações existentes de uma oferta e, depois, POST /partners/charlee/v2/create/interview para criar ou modificar uma. A resposta desta última inclui o interview_id, que desempenha o papel do testId. As duas rotas estão descritas na referência da API.

Saber mais

Iframe de configuração

Atribuir candidatos

Códigos de erro

Referência da API