Atribuir candidatos

Depois de configurada a avaliação, cada atribuição desencadeia o percurso do candidato: o agente contacta-o pelo canal escolhido no iframe.

Um candidato

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" }
  }'

A resposta 201 inclui o identificador da sessão: { "id": "…" }.

Campo	Obrigatório	Descrição
`assessmentId`	sim	O `testId` recebido do iframe.
`applicant.email`	sim	Endereço de e-mail do candidato.
`applicant.phone`	sim	Número no formato internacional (E.164), por exemplo `+33612345678`.
`applicant.firstName`, `applicant.lastName`	não	Nome próprio e apelido, utilizados nas mensagens dirigidas ao candidato.
`applicant.planning_date`	não	Data de chamada pretendida, no formato ISO 8601.
`recruiter.email`	recomendado	O recrutador que está na origem da atribuição.

O recrutador

Transmita sempre recruiter.email. Associa o consumo à empresa cliente, ao passo que o identificador da empresa só identifica o seu ATS. Para a marcação de entrevistas e os e-mails, a Skillee utiliza também a agenda e a caixa de correio deste recrutador: se não as tiver ligado, o envio é recusado e o motivo é-lhe devolvido.

Idempotência

Atribuir duas vezes a mesma avaliação ao mesmo candidato não cria duplicados: enquanto houver uma sessão ativa, a chamada responde 201 com a sessão existente. Pode, portanto, repetir uma chamada cuja resposta se tenha perdido.

Um lote de candidatos

curl https://api-charlee2.skillee.ai/partners/charlee/v2/launch/interview \
  -H "Authorization: Bearer $COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "interview_id": "<testId>",
    "applicants": [
      { "firstName": "Marie", "lastName": "Dupont", "email": "marie.dupont@example.com", "phone": "+33612345678" },
      { "firstName": "Karim", "lastName": "Benali", "email": "karim.benali@example.com", "phone": "+33698765432" }
    ],
    "recruiter": { "email": "recrutador@empresa.pt" }
  }'

O lote pode ter êxito parcial: a resposta 200 lista lado a lado as sessões criadas (sessions) e os candidatos recusados com o respetivo motivo (failed). Um candidato que já tenha uma sessão ativa para esta avaliação aparece com o motivo DUPLICATE_ACTIVE_SESSION. Se não tiver sido possível criar nenhuma sessão, a resposta é um 422 que enumera os motivos; estes estão detalhados nos códigos de erro.

Créditos

Cada percurso consome créditos da empresa cliente, tanto individualmente como em lote. Sem créditos suficientes, a atribuição é recusada com 402 e o candidato não é contactado.