Integración con ATS vía API: evaluaciones dentro de tu proceso

Permite que tu ATS, portal de empleo o sistema interno de reclutamiento envíe evaluaciones y reciba los resultados sin que el reclutador salga de su pantalla. En la práctica: cuando una postulación avanza de etapa en el ATS, el sistema llama a Coodesh, el candidato recibe la invitación, responde la evaluación en Coodesh, y el resultado vuelve a la tarjeta de la postulación con la nota, el detalle por pregunta, el enlace del informe y el resumen de integridad. El reclutador deja de exportar planillas, copiar enlaces de invitación y revisar dos pantallas. La lógica del proceso sigue en el ATS; Coodesh se encarga solo de la evaluación.

Son tres llamadas y un webhook. Primero, tu sistema lista las evaluaciones disponibles en el área de trabajo, para que el reclutador elija cuál enviar. Segundo, crea un intento para el candidato, informando nombre, correo, los identificadores del candidato y de la vacante en tu sistema, la URL a la que vuelve el candidato al terminar y la URL de tu webhook; la respuesta trae el identificador del intento y el enlace para que el candidato comience. Tercero, en cada cambio de estado del intento, Coodesh llama a tu webhook con los datos de ese estado. Si lo necesitas, tu sistema también puede consultar el resultado de un intento en cualquier momento por su identificador. La documentación completa, con ejemplos de solicitud y respuesta, está en coodesh.com/docs.

La integración de Coodesh se hace mediante una API abierta, lo que significa que cualquier ATS o sistema propio puede conectarse con los mismos tres endpoints, sin depender de un conector específico. Esto aplica a las plataformas del mercado y al sistema interno que tu empresa haya construido. Para saber si tu ATS ya tiene una conexión configurada por otro cliente o por el proveedor, o para coordinar una implementación conjunta con el equipo de tu ATS, habla con el equipo de Coodesh; la mayoría de las integraciones toma pocos días porque el contrato de la API es pequeño y estable.

La autenticación se hace con una clave de integración, enviada en el header de cada solicitud. La clave se genera dentro de la plataforma, por área de trabajo, y solo da acceso a las evaluaciones e intentos de esa área. Es el modelo adecuado para una integración de servidor a servidor: no hay inicio de sesión de usuario involucrado, la clave queda guardada en tu backend y puede revocarse y generarse de nuevo en cualquier momento sin afectar a los usuarios. La recomendación es una clave por sistema integrado, nunca compartida entre entornos, y rotarla cada vez que alguien con acceso salga del equipo.

La puntuación general, el tipo de puntuación, las fechas de invitación, inicio y finalización, el detalle por prueba, un enlace al informe completo en Coodesh y un texto listo en lenguaje natural con el resumen del desempeño, pensado para pegarse en un comentario o tarjeta del ATS. También incluye un resumen de integridad: cantidad de dispositivos y ubicaciones, salidas de pestaña y de pantalla completa, eventos de copiar y pegar, navegador y sistema operativo, y la categoría de severidad del intento. Esto permite que el reclutador priorice la revisión sin abrir Coodesh, con el detalle completo a un clic.

Coodesh llama a la URL de webhook informada al crear el intento en cada cambio de estado: iniciado, cuando el candidato comienza; expirado, cuando el plazo termina sin finalizar; y finalizado, cuando el resultado está disponible. El webhook de finalizado trae el resultado completo, así que tu sistema no necesita hacer una segunda llamada. Como buena práctica, trata el webhook como una señal y no como única fuente: responde rápido, procesa de forma asíncrona y mantén la consulta del resultado por identificador como conciliación, por si tu endpoint no está disponible en el momento del envío.

El candidato hace la evaluación en Coodesh, con la misma experiencia que cualquier otro candidato: navegador, celular cuando el formato lo permite y recursos de integridad según la configuración de la evaluación. La invitación puede enviarse por el correo estándar de Coodesh o, si tu ATS ya se comunica con el candidato, desactivas el correo al crear el intento y entregas el enlace por donde prefieras. Al terminar, el candidato es redirigido a la URL que informó tu sistema y vuelve al portal de empleo o a la página de confirmación de la empresa.

Crea una evaluación corta de prueba en tu área de trabajo, genera una clave de integración y usa el propio flujo con un correo de tu equipo: lista las evaluaciones, crea un intento con el correo desactivado, abre el enlace, responde y observa cómo llegan los webhooks en cada estado. Como los intentos de prueba consumen resultados como cualquier otro, coordina con el equipo de Coodesh el volumen de pruebas durante la implementación. La documentación trae ejemplos de solicitud y respuesta para cada endpoint y los códigos de error esperados. Documentación: https://coodesh.com/docs

Entre algunos días y dos semanas, dependiendo más de tu ATS que de Coodesh. El contrato de la API tiene tres endpoints y un webhook, así que el trabajo del lado de Coodesh es pequeño. El tiempo se va en el mapeo en tu sistema: en qué etapa disparar, dónde guardar el resultado, cómo mostrar el enlace del informe y qué hacer con la categoría de integridad. Un desarrollador backend con experiencia en APIs REST y webhooks lo resuelve. Si tu ATS es de un tercero, el camino suele ser el equipo de integraciones del proveedor con soporte de Coodesh.

Tu sistema envía a Coodesh el nombre, el correo y los identificadores internos del candidato y de la vacante; Coodesh devuelve el resultado, el informe y el resumen de integridad. Tu empresa es la responsable del tratamiento y Coodesh, la encargada, lo que debe reflejarse en el acuerdo de tratamiento de datos. Dos cuidados de implementación: el enlace del informe que viene en el resultado da acceso al informe sin iniciar sesión, así que trátalo como dato sensible en tu sistema, con acceso restringido al equipo de reclutamiento; y los identificadores que envías deben ser los de tu sistema, no un número de documento de identidad, porque la API no los necesita para funcionar.