Reclee

Gestionar el pipeline

Suma candidatos a una vacante, muévelos de etapa uno a uno o en lote, etiquétalos, coméntalos, descalifícalos y calcula su match score.

Esta guía trabaja sobre el pipeline de una vacante ya publicada: suma personas del talent pool, lista el pipeline, mueve candidatos entre etapas, los etiqueta y comenta, los descalifica o los restaura, y calcula su match score.

Necesitas el jobPostId de una vacante en estado ACTIVE (ver Publicar una vacante) y los profileId de personas de tu pool (GET /talent/pool o la acción search_talent).

export RECLEE_API="https://app.reclee.com/api/v1"
export RECLEE_API_KEY="rcl_..."
export JOB_POST_ID="3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90"

Lee las etapas de la vacante

Cada movimiento pide el stageId de destino. Las etapas salen de GET /job-posts/{jobPostId}/pipeline, en orden; su name es null hasta que alguien las renombra, así que identifícalas por templateKey (SOURCED, SCREENING, INTERVIEW, SHORTLIST, HIRED).

curl -s "$RECLEE_API/job-posts/$JOB_POST_ID/pipeline" \
  -H "Authorization: Bearer $RECLEE_API_KEY"
{
  "stages": [
    { "id": "a1c3e5f7-1b2d-4e6f-8a9b-0c1d2e3f4a51", "name": null, "templateKey": "SOURCED", "position": 1, "isLocked": true, "qualified": 0, "disqualified": 0, "withdrawn": 0 },
    { "id": "b2d4f6a8-2c3e-4f7a-9b0c-1d2e3f4a5b62", "name": null, "templateKey": "SCREENING", "position": 2, "isLocked": true, "qualified": 0, "disqualified": 0, "withdrawn": 0 },
    { "id": "c3e5a7b9-3d4f-4a8b-8c1d-2e3f4a5b6c73", "name": "Entrevista técnica", "templateKey": "INTERVIEW", "position": 3, "isLocked": false, "qualified": 0, "disqualified": 0, "withdrawn": 0 }
  ],
  "candidates": [],
  "activeRun": null,
  "openGuaranteePlacementId": null
}

(Extracto.)

Suma candidatos

add_to_job_post agrega personas del pool, por profileIds o por linkedinUrls (URL o handle de alguien que tu pool ya tiene), hasta 200 en total. Siempre entran QUALIFIED en la primera etapa y nunca llaman al proveedor de datos.

curl -s -X POST "$RECLEE_API/actions/add_to_job_post" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5c2e8a14-7d3b-4f9a-8e6c-1b2d3f4a5c60" \
  -d '{
    "jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90",
    "profileIds": ["6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52", "7b9d1f3a-8c0e-4f2a-9b4d-6e8f0a2b4c63"],
    "linkedinUrls": ["https://www.linkedin.com/in/lucia-ferrer-dev"]
  }'
{
  "data": {
    "added": 2,
    "already": 0,
    "unknown": 0,
    "blocked": 1,
    "applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85"],
    "linkedin": [{ "linkedinUrl": "https://www.linkedin.com/in/lucia-ferrer-dev", "profileId": null }],
    "notInPool": ["https://www.linkedin.com/in/lucia-ferrer-dev"]
  },
  "links": [ … ],
  "next": {
    "missing": [],
    "suggestions": [
      { "tool": "enrich_profile", "input": { "linkedinUrls": ["https://www.linkedin.com/in/lucia-ferrer-dev"] } },
      { "tool": "run_match_score", "input": { "jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90", "applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85"] } },
      { "tool": "list_applications", "input": { "jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90" } }
    ]
  }
}
  • applicationIds son las postulaciones recién creadas: son los ids que usan los pasos siguientes.
  • already cuenta a quienes ya estaban en el pipeline; unknown, perfiles que tu workspace no ve.
  • blocked cuenta a personas marcadas como No contactar: nunca se agregan.
  • notInPool lista las URLs que no están en tu pool. next sugiere traerlas con enrich_profile, que sí consume uso.

Errores en este paso

  • 409 JOB_POST_DRAFT: la vacante sigue en borrador; trae missing con lo que le falta para publicarse.
  • 404 NOT_FOUND: ninguna de las personas está en tu pool; sugiere enrich_profile.

Lista el pipeline

GET /job-posts/{jobPostId}/applications devuelve una página de postulaciones, de la más nueva a la más vieja. Filtros: stageId, status (QUALIFIED, DISQUALIFIED, WITHDRAWN), origin (SOURCED, MANUAL, CAREER_SITE), labels (nombres separados por coma; la fila tiene que llevarlos todos), minScore (0 a 100) y search (nombre).

curl -s "$RECLEE_API/job-posts/$JOB_POST_ID/applications?status=QUALIFIED&stageId=a1c3e5f7-1b2d-4e6f-8a9b-0c1d2e3f4a51&page=1&pageSize=50" \
  -H "Authorization: Bearer $RECLEE_API_KEY"
{
  "rows": [
    {
      "applicationId": "8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74",
      "profileId": "6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52",
      "name": "Martina Ocampo",
      "stageId": "a1c3e5f7-1b2d-4e6f-8a9b-0c1d2e3f4a51",
      "status": "QUALIFIED",
      "origin": "MANUAL",
      "appliedAt": "2026-10-22T14:20:00.000Z",
      "score": null,
      "labels": []
    }
  ],
  "total": 2,
  "page": 1,
  "pageSize": 50,
  "unmatchedLabels": []
}

unmatchedLabels lista los nombres del filtro labels que no existen en tu workspace; si hay alguno, la página viene vacía. Un parámetro que la ruta no conoce contesta 400 INVALID. Ver Paginación.

Mueve un candidato de etapa

move_application_stage mueve una postulación QUALIFIED a otra etapa de la misma vacante:

curl -s -X POST "$RECLEE_API/actions/move_application_stage" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74",
    "stageId": "b2d4f6a8-2c3e-4f7a-9b0c-1d2e3f4a5b62"
  }'
{
  "data": { "stage": "SCREENING" },
  "links": [ { "kind": "application", "id": "8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "label": "Martina Ocampo", "href": "https://app.reclee.com/..." } ]
}

Algunas etapas tienen condiciones. Las negativas que vas a ver:

CódigoStatusQué pasa
INVALID400El candidato no está QUALIFIED, ya está en esa etapa, o mandaste hire a una etapa que no es la última.
SCREENING_PENDING409Hay una respuesta de screening eliminatoria esperando revisión.
REPORT_REQUIRED409Para llegar a la shortlist el candidato necesita un informe.
SHORTLIST_FIRST409Solo se contrata desde la etapa anterior a la última.
HIRE_TERMS_REQUIRED400La última etapa contrata: manda hire con salary y startDate. Ver CRM: del lead al placement.
DO_NOT_CONTACT409La persona está marcada como No contactar.

Mueve varios a la vez

move_applications_stage mueve hasta 200 postulaciones de una vacante a la misma etapa. Cada candidato se decide por separado: los que no pasan una condición vuelven en refused y el resto se mueve igual. Quien ya está en esa etapa, ya no está QUALIFIED o está marcado «No contactar» no se mueve; si nadie de la selección se puede mover, la acción contesta esa negativa en lugar de escribir.

curl -s -X POST "$RECLEE_API/actions/move_applications_stage" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90",
    "applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85"],
    "stageId": "c3e5a7b9-3d4f-4a8b-8c1d-2e3f4a5b6c73"
  }'
{
  "data": {
    "moved": 1,
    "refused": [{ "applicationId": "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85", "error": "SCREENING_PENDING" }]
  },
  "links": [ … ]
}

La última etapa (contratación) no se ofrece en lote: contesta 400 INVALID. Cada contratación va por move_application_stage con hire.

Etiqueta a los candidatos

Los labels marcan en qué punto está cada candidato dentro de la vacante («Esperando respuesta», «Pidió más sueldo»). Las acciones solo usan labels que ya existen en el workspace: léelos con GET /ats/labels (por MCP, con la tool list_labels).

curl -s "$RECLEE_API/ats/labels" -H "Authorization: Bearer $RECLEE_API_KEY"
{
  "rows": [ { "id": "0e2a4c6d-1f3b-4c5d-8e7a-9b1c3d5e7f96", "name": "Esperando respuesta", "color": "amber", "systemKey": null, "applicationCount": 4 } ],
  "total": 1,
  "page": 1,
  "pageSize": 50
}

Para uno, add_application_label (y remove_application_label para sacarlo). Para varios, set_applications_labels, que pone y saca en una sola llamada:

curl -s -X POST "$RECLEE_API/actions/set_applications_labels" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90",
    "applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74", "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85"],
    "add": ["Esperando respuesta"]
  }'
{
  "data": { "labeled": 2, "labels": ["Esperando respuesta"], "refused": [] },
  "links": [ … ]
}

Un nombre que no existe contesta 404 LABEL_NOT_FOUND. Las acciones no crean labels; si necesitas uno nuevo, créalo con POST /ats/labels ({ "name": "…" }). Un label no se borra: se archiva con update_label.

Comenta

add_application_comment deja una nota para el equipo, con sentiment opcional (GOOD, NEUTRAL, BAD). Sin stageId, el comentario queda en la etapa actual del candidato.

curl -s -X POST "$RECLEE_API/actions/add_application_comment" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74",
    "body": "Muy buena llamada inicial, tiene disponibilidad en noviembre.",
    "sentiment": "GOOD"
  }'
{ "data": { "commentId": "1f3b5d7e-2a4c-4d6e-9f8b-0c2d4e6f8a07" }, "links": [ … ] }

Los comentarios de una postulación se leen con GET /ats/applications/{applicationId}/comments (paginado). Para responder, reply_to_comment con el commentId de un comentario raíz; una respuesta no se puede responder.

Descalifica o restaura

disqualify_application saca a un candidato del pipeline con un motivo: NOT_RESPONSIVE, WITHDREW, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE u OTHER. La etapa no cambia: el embudo conserva hasta dónde llegó.

curl -s -X POST "$RECLEE_API/actions/disqualify_application" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85",
    "reason": "COMPENSATION_MISMATCH",
    "comment": "Pide 30% más que el rango del cliente."
  }'
{ "data": { "status": "DISQUALIFIED", "reason": "COMPENSATION_MISMATCH" }, "links": [ … ] }

Para deshacerlo, restore_application con un comment: el cliente lo lee en el informe como excepción al screening, así que tiene que ser el motivo que dio la persona. Quien cortó puede devolver sin comentario poco después del corte; si no, la acción contesta 400 COMMENT_REQUIRED. Un candidato que no está descalificado contesta 400 INVALID.

curl -s -X POST "$RECLEE_API/actions/restore_application" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "9d1f3b5c-0e2a-4b4c-9d6f-8a0b2c4d6e85",
    "comment": "El cliente amplió el rango salarial."
  }'

Para muchos a la vez, set_applications_status: DISQUALIFIED necesita reason, y volver a QUALIFIED a alguien descalificado puede necesitar comment (si falta, ese candidato vuelve en refused con COMMENT_REQUIRED). Los rechazados vuelven en refused (por ejemplo HIRED_IS_FINAL para alguien ya contratado).

Calcula el match score

run_match_score mide a los candidatos contra los criterios de sourcing de la vacante (ver Hacer sourcing de candidatos). Con applicationIds mide exactamente esos; sin ellos, a todos los QUALIFIED cuyo score falta o quedó viejo.

Consume uso de IA

Cada cálculo consume uso de IA del mes. La respuesta trae cost con lo que gastó esa llamada. Ver Créditos y uso.

curl -s -X POST "$RECLEE_API/actions/run_match_score" \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 2a4c6e8f-3b5d-4e7f-8a9c-1d3e5f7a9b18" \
  -d '{
    "jobPostId": "3f6c2a9e-8b1d-4c7a-9e2f-5d4b1a7c8e90",
    "applicationIds": ["8c0e2a4b-9d1f-4a3b-8c5e-7f9a1b3c5d74"]
  }'
{
  "data": { "scored": 1, "skipped": 0, "failed": 0, "remaining": 0, "unscorable": [] },
  "links": [ … ],
  "next": { "missing": [], "suggestions": [] },
  "cost": { "aiUsagePct": 0.002, "teamUsagePct": 0, "credits": 0, "billedLater": false }
}

Si alguien no tiene datos para medirse, vuelve en unscorable y next sugiere enrich_profile con sus profileIds. El score queda en cada fila de GET /job-posts/{jobPostId}/applications (score.scorePct de 0 a 100, con coveragePct), y puedes filtrar con minScore.

CódigoStatusQué pasa
NO_SOURCING_CRITERIA409La vacante no tiene criterios de sourcing.
NOTHING_TO_SCORE409No hay nadie para medir en el alcance pedido.
NOT_RESCORABLE409Algún applicationId no es de esta vacante.
USAGE_EXHAUSTED402Se agotó el uso del mes; lo que no se midió queda en remaining.

Siguientes pasos

En esta página