TalentApproved

3 Llamadas API para Entregar Puntuaciones de Evaluación ATS para RRHH e Ingeniería

3 Llamadas API para Entregar Puntuaciones de Evaluación ATS para RRHH e Ingeniería

Utiliza una API de evaluación nativa cuando tu sistema de seguimiento de candidatos la ofrezca. Cuando no sea así, recurre a una integración de sistema de registro o a una API de evaluación unificada. De cualquier manera, planifica tres acciones fundamentales: listar los paquetes de pruebas disponibles, activar una evaluación para un candidato y sincronizar los resultados de vuelta mediante webhooks. Las funciones más avanzadas o el acceso a la integración en general pueden estar detrás de un nivel de pago o de socio.

En resumen:

  • Las APIs de evaluación nativas ofrecen la mejor experiencia para los reclutadores, ya que permiten filtrar y clasificar candidatos según puntuaciones estructuradas dentro del ATS.
  • Cuando no hay una API de evaluación disponible, las integraciones alternativas adjuntan los resultados como notas o archivos, lo que limita la capacidad de filtrar u ordenar los resultados de los candidatos.
  • La secuencia de integración recomendada implica listar paquetes, activar evaluaciones y capturar resultados mediante webhooks, con especial atención a la identificación segura y al manejo adecuado de los códigos de respuesta.
  • Los empleadores deben validar y documentar las herramientas de evaluación en cuanto a imparcialidad y cumplimiento legal antes de su implementación, asegurándose de que los resultados se almacenen con una pista de auditoría y de que el consentimiento quede registrado.
  • Probar la integración a fondo en un entorno de pruebas y hacer seguimiento del éxito de los webhooks ayuda a prevenir errores y resultados huérfanos en el proceso de contratación en producción.
Talent Approved
Evalúa habilidades más allá del CV
Talent Approved ayuda a los empleadores a crear evaluaciones de habilidades personalizadas, revisar resultados estructurados y tomar decisiones de contratación más informadas.
Explorar Talent Approved

Tabla de contenidos

APIs nativas, integraciones alternativas y APIs de evaluación unificadas

Tres patrones de integración cubren casi todas las pilas de contratación, y cada uno cambia lo que los reclutadores ven dentro del ATS.

Una API de evaluación nativa es la opción más limpia. Expone los paquetes de pruebas, los pedidos y los resultados estructurados directamente dentro del registro del ATS, lo que significa que los reclutadores pueden filtrar y clasificar candidatos por puntuación de la misma manera que filtran por etapa o fuente. La documentación para desarrolladores de Ashby describe esta como la forma estándar: listar paquetes, iniciar una evaluación y escribir los resultados de vuelta mediante un webhook.

Cuando el ATS no tiene endpoints de evaluación dedicados, los equipos recurren a escuchas de cambio de etapa y adjuntan los resultados como notas, enlaces o archivos cargados. Esto preserva una cobertura básica, pero elimina las puntuaciones estructuradas, por lo que los reclutadores pierden la capacidad de ordenar o filtrar por resultado dentro del ATS, según la guía de integración de Kombo.

Una API de evaluación unificada se sitúa entre las dos. Estandariza los paquetes, los webhooks de pedidos y la retroescritura de resultados en muchas plataformas ATS a la vez, de modo que un proveedor se integra una sola vez y llega a decenas de sistemas en lugar de construir y mantener un conector separado para cada uno, tal como se describe en la descripción general de la API de evaluación unificada.

  • API nativa: la mejor experiencia para el reclutador, vinculada a un solo ATS.
  • Integración alternativa: mayor cobertura, puntuación dentro del ATS más débil.
  • API unificada: menor mantenimiento a largo plazo para los proveedores que sirven a múltiples ATS.

Creación de la integración: una lista de verificación paso a paso

Antes de escribir cualquier código, confirma que el ATS expone realmente una API de evaluación y descarga la documentación para desarrolladores. Muchas plataformas solo publican endpoints generales de candidatos o solicitudes, y tratarlos como endpoints de evaluación es un error temprano muy común.

  1. Mapea los identificadores primero. Utiliza el ID de solicitud o el UUID del candidato en cada llamada para que los resultados se asocien al registro correcto en lugar de quedar huérfanos, un error señalado en la guía de integración de JobCannon.
  2. Elige un patrón de autenticación. La mayoría de las plataformas utilizan claves API, claves de socio u OAuth, y cada una requiere su propia política de almacenamiento seguro y rotación.
  3. Sigue la secuencia estándar de llamadas. Lista los paquetes con assessment.list, activa la prueba con assessment.start y luego escucha un webhook que se dispare al completarse y escribe el resultado de vuelta.
  4. Gestiona los códigos de respuesta documentados. La referencia de la API de Ashby para assessment.start enumera 200, 409 y 422 como respuestas típicas, y tu integración necesita un comportamiento definido para cada una.
  5. Define el payload de resultados. Planifica para puntuaciones globales, subpuntuaciones, marcas de tiempo, archivos adjuntos y cualquier atributo personalizado por el que tu equipo quiera filtrar posteriormente.
  6. Planifica los límites de velocidad. Solicita aumentos de cuota antes de los períodos de contratación de gran volumen para que una ráfaga de invitaciones a candidatos no genere errores 429 a mitad de campaña.

Consejo profesional: Almacena el ID de solicitud junto con cada payload de entrada y salida, incluso en los registros, para que un webhook fallido sea fácil de rastrear hasta un candidato específico.

Los empleadores, no los proveedores, cargan con el peso legal de las pruebas de empleo. La orientación de la EEOC sobre pruebas de empleo y procedimientos de selección deja claro que las herramientas de selección deben estar validadas y relacionadas con el puesto de trabajo, y que los empleadores siguen siendo responsables del impacto dispar incluso cuando un tercero creó la prueba. Solicita a cualquier proveedor de evaluación la documentación de validación antes de integrar su herramienta en un proceso de contratación activo. Nuestro propio artículo sobre las directrices de pruebas de la EEOC explica con más detalle los requisitos UGESP.

  • Solicita documentación de validación e impacto adverso a cualquier proveedor de evaluación antes de la puesta en marcha.
  • Almacena los resultados de las evaluaciones con una pista de auditoría clara y un período de retención definido, no indefinidamente.
  • Pregunta a los proveedores cómo registran el consentimiento para la supervisión mediante proctoring o cámara web, y si aplica una evaluación de impacto en la protección de datos.
  • Documenta tu revisión de validación, realiza una verificación piloto de imparcialidad en los primeros resultados y conserva esa evidencia en el archivo.

Nuestro manual de pruebas de impacto adverso explica cómo realizar ese análisis piloto y qué corregir cuando los números muestran desequilibrios.

Elegir entre integración nativa, API unificada y desarrollo personalizado

Antes de comprometer tiempo de ingeniería, repasa una breve lista de verificación con tus responsables de RRHH e ingeniería juntos.

  • Confirma qué funciones admite el ATS de forma nativa frente a cuáles requieren una solución alternativa.
  • Pregunta a cualquier proveedor de evaluación si ya admite tu ATS, y si la incorporación como socio conlleva una tarifa o un requisito de suscripción, ya que algunas plataformas ponen los módulos de integración detrás de niveles superiores, según la comparación de integraciones de plataformas de evaluación de Coderbyte.
  • Verifica que la retroescritura incluya puntuaciones estructuradas, no solo un enlace o archivo adjunto, para que los reclutadores puedan filtrar por resultado.
  • Define de antemano las expectativas de fiabilidad y reintento de webhooks, y designa quién se encarga del monitoreo en ambos lados.
  • Confirma que el proveedor puede proporcionar documentación de validación, controles antitrampa y un acuerdo de procesamiento de datos.

Consejo profesional: Solicita un entorno sandbox antes de firmar cualquier cosa. Un proveedor que no puede demostrar el disparo de un webhook de prueba de extremo a extremo no está listo para tu pipeline de producción.

Pruebas de integración de extremo a extremo y detección temprana de fallos

Un entorno de pruebas debe simular el ciclo de vida completo antes de que cualquier candidato real lo utilice: crea un pedido de prueba, activa el webhook manualmente y confirma que el resultado se muestra correctamente dentro de la interfaz de usuario del ATS, no solo en un registro de base de datos.

  1. Realiza pruebas en el entorno de pruebas que cubran la lista de paquetes, la creación de pedidos y la retroescritura de resultados con datos de muestra realistas.
  2. Haz seguimiento de las tasas de éxito de los webhooks y las tendencias de errores, y construye un informe de reconciliación que señale los resultados huérfanos antes de que se acumulen.
  3. Utiliza IDs de correlación en cada solicitud para que un ticket de soporte pueda rastrearse en ambos sistemas en minutos, no en horas.
  4. Construye lógica de reintento idempotente para que un webhook reenviado nunca cree un resultado duplicado, y mantén un script de relleno listo para cualquier evento perdido.
  5. Redacta un breve manual operativo que indique quién recibe las alertas en caso de fallo de un webhook y cómo volver a ejecutar de forma segura un pedido bloqueado.

Dónde encaja Talent Approved en una integración con ATS

La plataforma de Talent Approved incluye una función que genera evaluaciones específicas para cada puesto a partir de descripciones de trabajo o listas de habilidades, junto con monitoreo antitrampa y resúmenes generados por IA que aceleran la revisión. En cuanto a la integración, Talent Approved sigue el mismo ciclo de vida de listar, activar y retroescribir descrito anteriormente, y mapear el ID de solicitud o el UUID del candidato en cada llamada mantiene los resultados correctamente vinculados al registro ATS correcto. El modelo de precios es de pago por uso, una tarifa de $5 por candidato completado, sin suscripción requerida. Los equipos que implementen la integración también pueden consultar nuestra guía sobre cómo funcionan las evaluaciones instantáneas y nuestros recursos de cumplimiento con la EEOC para obtener detalles sobre implementación y validación.

Dónde encaja Talent Approved en una integración con ATS — diagrama general

Qué hacen mal los equipos de RRHH en la integración con ATS

Qué hacen mal los equipos de RRHH en la integración con ATS — diagrama general

La mayoría de los equipos tratan todas las APIs de ATS de la misma manera y luego se sorprenden cuando su "integración de evaluación" resulta ser un escucha de cambio de etapa sin puntuación estructurada adjunta. La solución no es invertir más horas de ingeniería. Es verificar, desde el primer día, si existe realmente una API de evaluación.

Comienza con un pequeño piloto en un solo puesto vacante antes de tocar todo tu pipeline de contratación. Observa dos cosas a la vez: si los reclutadores realmente utilizan el filtrado por puntuación, y si los primeros resultados muestran alguna brecha de imparcialidad entre los grupos de candidatos. Cuando una API de evaluación nativa o una API unificada comprobada esté disponible, elige esa opción. Tanto la experiencia del reclutador como la defensa legal dependen de resultados estructurados y filtrables, no de una solución alternativa añadida a una API de propósito general.

— Jimmie

Documentación para desarrolladores y orientación de cumplimiento que merece la pena guardar

Ten siempre a mano la documentación de integración de evaluaciones de Ashby, la descripción general de la API de evaluación unificada y la orientación de pruebas de la EEOC. Para el soporte de ingeniería en el lado de la integración, empresas como Ampersand se especializan en la implementación de API y webhooks.

Fuentes

Preguntas frecuentes

¿Qué significa la integración con ATS?

La integración con ATS significa conectar un sistema de seguimiento de candidatos a otra herramienta, como una plataforma de evaluación, para que los datos se muevan automáticamente entre ellas en lugar de copiarse manualmente. En el caso específico de las evaluaciones, eso implica listar los paquetes de pruebas, activar una prueba para un candidato y escribir la puntuación de vuelta en el registro del candidato en el ATS.

¿Cuáles son los principales sistemas ATS?

No existe un ranking oficial único de las mejores plataformas ATS, y la elección correcta depende del tamaño de la empresa, el volumen de contratación y las integraciones requeridas. En lugar de nombrar proveedores específicos, los equipos de RRHH deberían evaluar cualquier ATS según si expone una API de evaluación documentada, tal como se describe en la documentación para desarrolladores de Ashby, en lugar de basarse en listas de popularidad generales.

¿Cuál es la diferencia entre un ATS y un CRM?

Un ATS gestiona el flujo de trabajo de contratación para los puestos vacantes, haciendo seguimiento de los candidatos desde la solicitud hasta la oferta. Un CRM de reclutamiento, en cambio, gestiona las relaciones a largo plazo con candidatos potenciales, incluidas personas que no están aplicando activamente, lo cual es una función diferente a la de hacer seguimiento de los solicitantes activos a través de un pipeline.

¿Qué significa ATS?

ATS significa sistema de seguimiento de candidatos (en inglés, applicant tracking system), el software que los equipos de RRHH utilizan para publicar empleos, recopilar solicitudes y mover candidatos a través de las etapas de contratación. Cuando admite una API de evaluación dedicada, también puede activar pruebas de habilidades y recibir resultados estructurados directamente en el registro del candidato, según el ciclo de vida de integración descrito en la referencia de la API de Ashby.