Inicio rápido

Una integración sigue siempre el mismo recorrido: su ATS abre una sesión de configuración, el reclutador ajusta la evaluación en un iframe y, después, usted asigna esa evaluación a los candidatos. Skillee conduce el intercambio y devuelve el resultado a su herramienta.

Antes de empezar

Necesita el identificador de empresa (company_id) que Skillee le entrega en la activación: 32 caracteres hexadecimales, por ejemplo abc123def4567890abc123def4567890.

Las llamadas se realizan a https://api-charlee2.skillee.ai. El host histórico https://api-charlie.skillee.ai sirve la misma aplicación: una integración existente no tiene que cambiar nada.

Autenticación

Cada llamada lleva el identificador de empresa en la cabecera Authorization:

Authorization: Bearer abc123def4567890abc123def4567890

Algunas rutas aceptan también company_id en el cuerpo o como parámetro de consulta. Cuando el identificador está presente en ambos lugares, los dos valores deben ser idénticos; de lo contrario, la llamada se rechaza con un 401. Un valor que no esté formado por 32 caracteres hexadecimales se rechaza con un 400.

El recorrido

Abrir la sesión de configuración. Su servidor envía la oferta a Skillee y recibe la dirección del iframe. La llamada es idempotente: la misma oferta lleva siempre al mismo proceso de selección.

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 pedidos",
    "jobDescription": "Contrato indefinido en Madrid, horario diurno, se valora experiencia como carretillero…"
  }'

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

Mostrar el iframe. El reclutador elige el agente, el canal y las preguntas y, después, valida. El iframe envía entonces a su página el identificador de la evaluación, el testId. Consulte Iframe de configuración.
Guardar el testId junto con la oferta en su ATS. Designa la evaluación para todas las asignaciones futuras.

Asignar la evaluación a un candidato. Skillee lo contacta de inmediato.

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

{ "id": "…" }

Consulte Asignar candidatos para los lotes, la idempotencia y los créditos.

Los resultados

Skillee devuelve a su ATS el avance de cada candidato: pendiente, respondido (con la puntuación y el informe) o fallido (con el motivo). Este retorno pasa por la conexión que nuestro equipo configura con usted en la activación; no tiene que consultar nada por su parte.

Sin iframe

Si construye su propia pantalla de configuración, llame directamente a POST /partners/charlee/v2/list/assessments para leer las evaluaciones existentes de una oferta y, después, a POST /partners/charlee/v2/create/interview para crear o modificar una. La respuesta de esta última incluye el interview_id, que hace las veces de testId. Ambas rutas se describen en la referencia de la API.

Más información

Iframe de configuración

Asignar candidatos

Códigos de error

Referencia de la API