Reclee

Conceptos

El vocabulario de Reclee que aparece en la API y el MCP, con los valores exactos de cada estado.

Reclee modela el trabajo de una agencia de reclutamiento: clientes que piden búsquedas, vacantes que se cubren con candidatos, y un talent pool que crece con cada búsqueda. Esta página explica cada pieza tal como aparece en la API, con los valores exactos de sus estados. Los nombres de campo están en inglés; los valores de los enums son siempre en MAYÚSCULAS.

Workspace

El workspace es la cuenta de una agencia: sus vacantes, su talent pool, su CRM, su plan y su equipo. Todo dato pertenece a un workspace y nada cruza de uno a otro. Una API key trabaja en un solo workspace: el de la membresía con la que se creó.

Cada workspace tiene un plan (FREE, STARTER, PRO, SCALE) que define cuántos asientos tiene, cuánto uso de IA trae por mes y cuántos créditos.

Miembros y roles

Un miembro es una persona dentro de un workspace, con un rol:

RolQué puede hacer
OWNERTodo, incluida la facturación, los miembros y la configuración de la cuenta. Tiene asiento.
RECRUITERTodo el trabajo de reclutamiento, incluido lo que gasta uso o créditos. Tiene asiento.
COLLABORATOREscribe lo que no gasta (comentarios, notas, movimientos). Sin asiento.
VIEWERSolo lee. Sin asiento.

El asiento es lo que paga un plan, y es también lo que habilita la API y el MCP: solo las keys de OWNER y RECRUITER funcionan. Ver Autenticación.

Un miembro tiene dos ids que no son intercambiables: el memberId (su membresía en este workspace, el que piden por ejemplo los responsables y suscriptores de una vacante) y el userId (la persona, el que piden los entrevistadores). Cada campo dice cuál espera.

Vacante (job post)

La vacante es el puesto a cubrir y el contenedor de casi todo lo demás: su pipeline, sus criterios, su sourcing y sus candidatos.

Estado (status)Qué significa
DRAFTBorrador. No recibe candidatos ni corridas de sourcing. Se completa y se publica.
ACTIVEPublicada y en búsqueda. Puede aparecer en el sitio de empleo del workspace.
CLOSEDCerrada, a mano (con su motivo si no se cubrieron todos los puestos) o porque se cubrió. Se puede reabrir.

Otros campos que conviene conocer: openings (cuántos puestos), seniority, employmentType, workplaceType (REMOTE, HYBRID, ON_SITE), el rango salarial con su moneda y salaryPeriod (HOURLY, DAILY, MONTHLY, YEARLY), contentLocale (el idioma en que la vacante le habla a quien está afuera: el sitio de empleo, el screening y el informe para el cliente) y handle (su dirección en el sitio de empleo).

Las vacantes no se borran: se cierran. La única excepción es un borrador en el que nadie trabajó. Ver Borrados.

Pipeline y etapas

Cada vacante tiene su propio pipeline: una lista ordenada de etapas (entre 3 y 12). Una vacante nueva arranca con cinco, que vienen de una plantilla:

Etapa de la plantillaPara qué
SOURCEDEncontrados: la primera etapa, donde entra todo candidato agregado.
SCREENINGFiltro inicial. Aquí entran también las postulaciones del sitio de empleo.
INTERVIEWEntrevistas.
SHORTLISTLos finalistas que se le presentan al cliente.
HIREDContratado. La última etapa contrata.

Cada etapa tiene un id propio (el que usan las acciones de mover) y un name opcional: mientras sea null, la etapa conserva el nombre de la plantilla y se muestra traducida; si alguien le pone nombre, se muestra tal cual. Se pueden agregar, renombrar y reordenar etapas; las dos primeras y las dos últimas no se renombran.

Algunas etapas tienen compuertas: pasar más allá del screening exige que ninguna pregunta excluyente esté fallada o esperando revisión; entrar a la anteúltima etapa (la shortlist) exige un informe del candidato; y entrar a la última (contratar) exige venir de la anteúltima y los términos de la contratación (salario y fecha de inicio). Nadie marcado como «no contactar» avanza. Una compuerta cerrada contesta un 409 con su código (SCREENING_PENDING, SCREENING_FAILED, REPORT_REQUIRED, SHORTLIST_FIRST, PLACEMENT_REQUIRED, DO_NOT_CONTACT).

Postulación (application)

Una postulación es una persona dentro del pipeline de una vacante: une un perfil con una vacante, y está siempre en una etapa. La etapa dice hasta dónde llegó; el estado dice si sigue en carrera:

Estado (status)Qué significa
QUALIFIEDEn carrera. Solo un candidato QUALIFIED se mueve de etapa.
DISQUALIFIEDDescartado, con un motivo. Se queda en la etapa donde lo cortaron, para que el embudo lo cuente.
WITHDRAWNSe bajó del proceso.

Motivos de descalificación (reason): FAILED_CRITERION, INSUFFICIENT_DATA, NOT_RESPONSIVE, LOW_EVALUATION_SCORE, COMPENSATION_MISMATCH, AVAILABILITY_MISMATCH, CLIENT_REJECTED, HIRED_ELSEWHERE, FAILED_SCREENING, WITHDREW, OTHER. Algunos los pone solo el sistema; cada acción dice cuáles acepta.

Origen (origin): SOURCED (vino del sourcing o una búsqueda), MANUAL (lo agregó alguien del equipo) o CAREER_SITE (se postuló en el sitio de empleo).

Las postulaciones llevan etiquetas (labels: un catálogo del workspace para marcar candidatos dentro de un pipeline), comentarios del equipo y su historial. Contratar es final: un candidato contratado no se mueve ni se descalifica (HIRED_IS_FINAL).

Perfil y talent pool

Un perfil (profile) es una persona: su nombre, su trayectoria (experiencia, educación, skills, idiomas), sus links y sus contactos. El talent pool es el conjunto de perfiles que el workspace conserva, estén o no en alguna vacante.

Una persona entra al pool de varias formas, que quedan en su origen: SOURCED (una búsqueda o el sourcing), MANUAL (cargada a mano o por planilla), CV (leída de un CV) o APPLIED (se postuló en el sitio de empleo). Una búsqueda solo muestra gente: nadie entra al pool hasta que se guarda, se suma a una lista o se agrega a una vacante.

En el pool viven también:

  • Tags: palabras del vocabulario del workspace para clasificar personas en todo el pool (distintas de las etiquetas, que son de un pipeline).
  • Notas del equipo sobre la persona, que cruzan todas las vacantes.
  • No contactar: una marca por workspace. Quien la tiene no se agrega a vacantes, no avanza en el pipeline y no se revelan sus datos de contacto.
  • Contactos: email laboral (EMAIL_WORK), email personal (EMAIL_PERSONAL) y teléfono (PHONE). Se cargan a mano o se revelan con un proveedor de datos, lo que consume créditos.
  • Enriquecer: traer el registro público completo de la persona (experiencia, educación, skills) desde su LinkedIn. Consume uso de IA.
  • Duplicados: cuando dos perfiles parecen la misma persona, Reclee abre un caso para fusionarlos o descartarlo.

Sacar a alguien del pool no lo borra: lo archiva para el workspace.

Listas (bookmarks)

Una lista (bookmark) es una carpeta de perfiles armada a mano: «Backend senior LATAM», «Para el cliente X». Nace privada (solo la ve quien la creó) y se puede compartir con el workspace. Agregar a alguien a una lista también lo guarda en el pool. Las listas sí se pueden borrar.

Sourcing

El sourcing es la búsqueda de candidatos fuera del workspace, organizada alrededor de una vacante. Sus piezas, en el orden en que se definen:

PiezaQué es
Criterios de sourcingContra qué se califica a cada persona encontrada. Son de la vacante, ordenados por importancia (el orden define el peso). Un criterio puede ser excluyente: si no se cumple, la persona queda descalificada. Hasta 10.
ICP de talentoEl perfil ideal: un retrato de a quién se busca (títulos y variantes, países, empresas, seniority, idiomas, skills, anti-perfil). No puntúa: dirige dónde buscar. Estados: NEEDS_REVIEW (propuesta sin aprobar), ACTIVE, DISCARDED.
Definiciones de búsquedaLas consultas concretas que salen del ICP. Varias por ICP, porque no se sabe cuál rinde hasta probarla. Estados: NEEDS_REVIEW, READY, ACTIVE, PAUSED, EXHAUSTED.
Corrida (run)La ejecución del sourcing: recorre las definiciones página por página, enriquece y puntúa a cada persona, y rota hacia la definición que mejor rinde. Avanza sola en segundo plano y puede pausarse esperando una decisión.
LonglistEl resultado de una corrida: las personas que calificaron, ordenadas. Se congela al cerrar. Estados: OPEN (la corrida sigue), CLOSED_COMPLETE (llegó al objetivo), CLOSED_PARTIAL (se cerró antes).

Una corrida se lanza con un objetivo de calificados (targetSize) y un tope de perfiles evaluados (profileCap), que acotan cuánto uso de IA puede gastar. Se cierra por llegar al objetivo, por el tope, por bajo rendimiento, por sequía (ninguna definición encuentra a nadie) o porque alguien la frenó; el motivo queda en la longlist.

Aparte del sourcing existe la búsqueda de talento (talent search): una búsqueda puntual de personas fuera del workspace, de a 20 por página, sin criterios ni longlist.

Match score

El match score dice cuánto encaja una persona con los criterios de sourcing de una vacante, como porcentaje (scorePct, de 0 a 100). Cada criterio se resuelve en un nivel (GOOD_FIT, FIT, BAD_FIT o NO_DATA, cuando el perfil no tiene evidencia), y el score pondera esos niveles por el peso de cada criterio. Lo acompaña la cobertura (coveragePct, de 0 a 100): qué parte del peso de los criterios tenía evidencia en el perfil.

Cada cálculo termina en un veredicto: QUALIFIED (supera el umbral de la vacante y pasa los excluyentes), BELOW_THRESHOLD o DISQUALIFIED (falló un excluyente). Se calcula en el sourcing, al postularse alguien si la vacante lo tiene activado, o a pedido (run_match_score), y cada cálculo es una versión nueva. Calcularlo consume uso de IA.

Entrevistas, scorecard e informe

  • Entrevista: se agenda o se registra para una postulación, con un tipo, un entrevistador y una fecha. El workspace tiene tipos de sistema (SCREENING, DEEP_DIVE, TECHNICAL, FINAL) y puede crear los suyos. Una entrevista puede llevar preguntas (generadas con IA o escritas), una transcripción y respuestas extraídas de ella.
  • Criterios de evaluación: lo que las entrevistas tienen que averiguar, cada uno con un peso HIGH, MEDIUM o LOW. Son de la vacante y no son excluyentes (lo excluyente va en el screening).
  • Preguntas de screening: lo que cada candidato contesta sobre sí mismo al postularse. Una pregunta excluyente puede terminar la postulación sola.
  • Scorecard: la evaluación de un candidato, un puntaje y un comentario por criterio de evaluación, con una recomendación. La IA puede proponerla a partir de las entrevistas, pero solo cuenta lo que el evaluador adopta.
  • Consideraciones: lo que el cliente tiene que saber de un candidato (una brecha, un riesgo, una excepción a un requisito, compensación, un punto fuerte).
  • Informe (report): el documento para el cliente sobre un candidato, armado desde la scorecard, las consideraciones, las condiciones y el perfil. Tiene versiones, se puede traducir y descargar. La IA propone textos; ninguno llega al cliente hasta que alguien lo adopta.
  • Shortlist compartida: un link público para que el cliente vea los finalistas de una vacante, sin cuenta en Reclee. Se revoca y no se reactiva.

CRM

El CRM lleva la relación comercial con los clientes de la agencia:

PiezaQué es
Lead (empresa)Una empresa cliente o potencial cliente. Recorre un embudo comercial de cuatro etapas, que solo avanza: PROSPECTING → QUALIFIED → MEETING → CLIENT. Las tres primeras se eligen a mano; a CLIENT entra sola cuando uno de sus requests pasa a IN_PROGRESS. Lleva sus condiciones comerciales por defecto (fee y garantía). Se archiva, no se borra.
ContactoUna persona del lado del cliente (no un candidato), dentro de un lead: su email, LinkedIn, si decide, y cuál es el contacto principal.
ActividadEl registro de lo que pasó con un lead: notas, llamadas, emails, reuniones.
RequestUna búsqueda que pide un cliente: el rol, cuántos puestos, el rango salarial y el fee. Nace DRAFT y pasa por SENT, IN_PROGRESS (empieza la búsqueda), y termina CLOSED o CANCELLED. Se vincula a una vacante, que es la que se trabaja.
PlacementUna contratación concretada: quién, salario, fee, fecha de inicio, días de garantía y estado de cobro (PENDING, INVOICED, PAID, WAIVED, CANCELLED).

El fee puede ser PERCENTAGE (un porcentaje del salario), FIXED (un monto) o MIXED (ambos). Pasa de la empresa al request y del request al placement, y en cada nivel se puede cambiar. La garantía es el período durante el cual, si la persona contratada se va, la agencia repone el puesto sin cobrar un fee nuevo: activarla reabre la vacante y la próxima contratación es un reemplazo.

Créditos y uso

Lo que tiene costo se mide de dos formas:

  • Uso de IA: lo consume todo lo que llama a un modelo o a un proveedor de datos (buscar y enriquecer personas, el sourcing, el match score, leer CVs, cada propuesta generada). Se mide como fracción del uso del mes que trae el plan, y además hay una ventana de 5 horas por persona. Nunca se expresa en dinero.
  • Créditos: los consume revelar contactos; cada tipo de dato tiene su precio en créditos según el plan. El plan trae créditos por mes y se pueden comprar más desde la app. Cuando el uso de IA del mes se agota, los créditos comprados también lo cubren.

Quedarse sin uso o sin créditos contesta 402 con el detalle de qué se agotó y cuándo vuelve. Ver Créditos y uso.

Ask Reclee y las familias de acciones

Ask Reclee es el asistente dentro de la app. Usa el mismo catálogo de operaciones que publican la API (POST /actions/<tool>) y el MCP, agrupadas en familias:

FamiliaQué hace
READLee. Por REST son rutas GET; por MCP, tools de solo lectura.
DOEscribe datos del workspace (vacantes, pipeline, pool, listas…).
CRMEscribe en el CRM.
GENERATELa IA escribe una propuesta o un borrador que una persona revisa en la app. Consume uso de IA.
PROVIDERLlama a un proveedor externo de datos (buscar, enriquecer, revelar, sourcing). Consume uso de IA o créditos.

Ver Acciones.

En esta página