# Integración con su ATS — Criterio Talent > Su ATS sigue siendo el sistema que manda: Criterio Talent recibe la vacante y el candidato, entrevista y devuelve el reporte por API, sin exportar ni volver a teclear. URL: https://criteriotalent.com/integraciones/ --- **Integraciones** # El proceso no se detiene para entrevistar. El ATS que su equipo ya opera sigue siendo el sistema que manda. Criterio Talent recibe la vacante y el candidato, conduce la entrevista y devuelve el reporte por donde usted lo espera — sin que nadie exporte, pegue ni vuelva a teclear nada. Aquí está exactamente qué viaja, en qué dirección, y qué pasa cuando el otro lado no responde. La integración de cada empresa vive dentro de su propio perímetro. ## Las operaciones que existen hoy Son cinco, y están pensadas para el recorrido completo de una candidatura: sincronizar la vacante, pedir la entrevista, consultarla, recuperar su reporte y conocer el catálogo de perfiles de entrevistador disponibles. La petición que crea una entrevista acepta una clave de idempotencia, así que un reintento por una red que se cayó a medias no produce dos entrevistas para la misma persona. Las cinco viven bajo una ruta versionada: la versión está en la dirección, no en una cabecera que se olvida. | Operación | Qué hace | Sincronizar una vacante | Deja la vacante del sistema del cliente reflejada en la instancia, con su guion asociado. | Pedir una entrevista | Emite el enlace individual para una persona sobre una vacante ya sincronizada. | Consultar una entrevista | Devuelve en qué punto está: emitida, abierta, en curso, terminada o rechazada. | Recuperar el reporte | Devuelve la valoración por competencia con la evidencia que la sustenta. | Catálogo de perfiles | Lista los perfiles de entrevistador disponibles en esa instancia. ## Los avisos que salen, y cómo se comprueba que son nuestros La integración no tiene que estar preguntando. Ocho avisos recorren la vida de una entrevista: se emitió el enlace, la persona lo abrió, empezó, terminó, no aceptó, falló, el reporte está listo, y una prueba de conexión para verificar el receptor antes de que pase nada real. Cada aviso viaja firmado con HMAC-SHA256 sobre el cuerpo exacto, con la marca de tiempo dentro del mensaje firmado. Quien lo recibe debe comparar en tiempo constante y rechazar una marca que se aparte más de cinco minutos de su reloj: con la marca fuera de la firma, un aviso viejo se puede reenviar cambiando la hora. Los avisos y su cabecera de firma están declarados en la propia especificación, no sólo descritos en una página. Un evento que sólo vive en la documentación se queda atrás en cuanto el código cambia. ## Autenticación y llaves - Las llaves se emiten y se revocan desde la consola de la propia instancia, dentro del dominio del cliente. - Una llave inválida recibe una respuesta con su identificador de petición, para que un problema de integración se pueda rastrear sin adivinar. - Las llaves son de la instancia, así que nunca cruzan de una empresa a otra. ## ATS y HRIS La API es el mecanismo; la conexión con un ATS o un HRIS concreto es un proyecto, y se define como tal: qué campos viajan, en qué dirección, con qué frecuencia y qué pasa cuando el otro lado no responde. Se define por escrito antes de empezar, porque una integración que se descubre sobre la marcha es la forma más cara de descubrir que dos sistemas entendían distinto la misma palabra. ## Identidad corporativa La identidad de la plataforma es propia y trae segundo factor obligatorio para el personal autorizado. Eso es lo que opera hoy. El inicio de sesión contra el directorio corporativo del cliente forma parte del alcance que se define por proyecto. ## Lo que se define con usted Cada integración se diseña con el ATS que su equipo opera de verdad, con sus campos y sus estados, en vez de instalar un conector de catálogo que casi encaja. Eso cuesta una conversación al principio y ahorra la peor de las sorpresas: descubrir en la tercera semana que dos sistemas entendían distinto la misma palabra. De esa conversación sale por escrito qué campos viajan, con qué frecuencia, qué avisos escucha su lado y quién responde cuando uno de los dos no contesta. La consola de llaves y la especificación de su instancia quedan en sus manos desde el primer día. **Siguiente paso** ## Véalo con una vacante suya sobre la mesa. Treinta minutos: se define una entrevista a partir de su job post, se recorre como la ve el candidato y se lee un reporte con su evidencia.