Asignar candidatos

Una vez configurada la evaluación, cada asignación pone en marcha el recorrido del candidato: el agente lo contacta por el canal elegido en el iframe.

Un 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": "reclutador@empresa.es" }
  }'

La respuesta 201 contiene el identificador de la sesión: { "id": "…" }.

Campo	Obligatorio	Descripción
`assessmentId`	sí	El `testId` recibido del iframe.
`applicant.email`	sí	Dirección de correo electrónico del candidato.
`applicant.phone`	sí	Número en formato internacional (E.164), por ejemplo `+33612345678`.
`applicant.firstName`, `applicant.lastName`	no	Nombre y apellidos, que se usan en los mensajes dirigidos al candidato.
`applicant.planning_date`	no	Fecha de llamada deseada, en formato ISO 8601.
`recruiter.email`	recomendado	El reclutador que origina la asignación.

El reclutador

Transmita siempre recruiter.email. Vincula el consumo a la empresa cliente, mientras que el identificador de empresa solo identifica su ATS. Para la programación de entrevistas y los correos electrónicos, Skillee utiliza también la agenda y el buzón de correo de este reclutador: si no los ha conectado, el envío se rechaza y se le devuelve el motivo.

Idempotencia

Asignar dos veces la misma evaluación al mismo candidato no crea un duplicado: mientras haya una sesión activa, la llamada responde 201 con la sesión existente. Por lo tanto, puede repetir una llamada cuya respuesta se haya perdido.

Un 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": "reclutador@empresa.es" }
  }'

El lote puede tener un éxito parcial: la respuesta 200 enumera, una junto a otra, las sesiones creadas (sessions) y los candidatos rechazados con su motivo (failed). Un candidato que ya tiene una sesión activa para esta evaluación aparece con el motivo DUPLICATE_ACTIVE_SESSION. Si no se ha podido crear ninguna sesión, la respuesta es un 422 que enumera los motivos; se detallan en los códigos de error.

Créditos

Cada recorrido consume créditos de la empresa cliente, tanto de forma unitaria como en lote. Sin créditos suficientes, la asignación se rechaza con un 402 y no se contacta al candidato.