Saltar al contenido

Cómo conectar las entrevistas con IA a tu ATS, tu API o tu página de empleo.

Una integración de entrevistas con IA con tu ATS, la API pública con webhooks o la entrevista insertada en tu página de empleo: qué hace cada opción, cómo elegir y cómo configurarla y probarla.

Actualizado el 17 de noviembre de 2026 · 9 min de lectura

En esta página

En resumen

  • Tres formas de conectarte: una conexión nativa con el ATS, la API pública con webhooks o la entrevista insertada en tu página de empleo. Puedes usar más de una.
  • ATS: vincula una vacante y una etapa de Workable, Greenhouse, Teamtailor, Recruitee o Breezy HR a una entrevista publicada. Cada candidato que pase a esa etapa recibe una sola invitación, y los resultados vuelven como una nota.
  • API: crea candidatos e invitaciones desde tus propios sistemas con una clave de API con permisos acotados, y entérate de lo que pasó mediante webhooks firmados.
  • Inserción: ejecuta la entrevista dentro de tu propio sitio con un solo script, desde los sitios que permitas.
  • Primero prueba: envía un evento de prueba de webhook, lleva a un candidato de prueba por la etapa y revisa los registros de entrega y de actividad antes de salir en vivo.

Tres formas de conectar las entrevistas con IA

Una integración de entrevistas con IA con el ATS les ahorra a tus reclutadores copiar y pegar: los candidatos reciben la invitación desde el sistema que ya usas y los resultados vuelven a él. Si tu ATS no tiene conexión nativa, o contratas a través de tu propio portal, la API pública y la inserción hacen el mismo trabajo con algo de código.

  • Conexión nativa con el ATS. Workable, Greenhouse, Teamtailor, Recruitee y Breezy HR. Sin código: pega una clave, vincula una vacante y una etapa, y al pasar a un candidato a esa etapa se envía la invitación.
  • API pública y webhooks. Tu sistema crea candidatos e invitaciones mediante REST y obtiene los resultados; los webhooks le avisan cuando ocurre algo.
  • Embed SDK. Un script ejecuta la entrevista en un marco dentro de tu página de empleo. Necesita un enlace de invitación, así que se usa junto con la API.
Videotutorial, 3:16. Conectar Greenhouse y vincular la etapa de un puesto con una entrevista; después, Slack, una clave de API y un webhook. En inglés, con subtítulos.

Las tres requieren un plan de pago y un administrador de la empresa. La entrevista es la misma que reciben los candidatos por un enlace en el correo, incluida la opción de escribir en lugar de hablar.

Cómo elegir entre el ATS, la API y la inserción

Conexión nativa con el ATSAPI pública y webhooksEmbed SDK (con la API)
Ideal paraEquipos que usan uno de los cinco ATS compatiblesCualquier otro ATS o tu propio flujo de trabajoUna página de empleo o un portal que controlas
Código necesarioNingunoLlamadas a la API y un receptor de webhooksUnas pocas líneas en la página, más la API
Qué envía la invitaciónPasar a un candidato a la etapa vinculadaTu llamada a la APITu llamada a la API; el enlace se monta en tu página
Los resultados vuelven comoUna nota sobre el candidato en el ATSResultados que obtienes tras el webhook de resultadosLo mismo; la página solo sabe que el candidato terminó

Empieza por la conexión nativa si tu ATS la tiene. Elige la API cuando necesites controlar a quién se invita y cuándo. Agrega la inserción cuando los candidatos deban quedarse en tu sitio.

Configura una integración de entrevistas con IA con tu ATS

Conecta un ATS y vincula una vacante

  1. Publica la entrevista. Solo una entrevista publicada se puede vincular a una vacante.
  2. Abre Integraciones → ATS y pulsa Conectar ATS. Pega las credenciales del ATS (dónde encontrarlas). testee las prueba con el ATS antes de guardarlas, luego las almacena cifradas y solo muestra una pista enmascarada.
  3. Configura el webhook. Workable y Breezy HR no necesitan nada: testee lo registra. Para Greenhouse, Teamtailor y Recruitee, agrega un webhook en el ATS con la dirección de la tarjeta Webhook de la conexión e intercambia el secreto como indica la tarjeta.
  4. Vincula una vacante. La pestaña Vacantes muestra las vacantes abiertas del ATS. Abre una, elige la entrevista publicada y la etapa que envía la invitación, y guarda.
  5. Marca las vacantes de Nueva York en el vínculo, para que las invitaciones incluyan tu aviso de la Local Law 144 y se abran 10 días hábiles después.
Una conexión con Workable: su configuración, el webhook y los puestos vinculados a entrevistas.
Una conexión con Workable: su configuración, la tarjeta del webhook y las vacantes, cada una vinculada a una entrevista publicada.

Qué pasa con cada candidato

  • Una sola invitación, sin importar cuántas veces el ATS envíe el evento. Los eventos de vacantes o etapas que no vinculaste se ignoran.
  • Campos fijos: el correo y el nombre del candidato, la vacante y la etapa, y la referencia del ATS. No hay ningún mapeo que configurar.
  • Resultados como nota: la puntuación de cobertura (para revisar, no una decisión de contratación), el resumen y un enlace a los resultados. Puedes desactivar este envío de vuelta en cada conexión.
  • Fallos: una caída se reintenta durante unas ocho horas; un rechazo, como quedarse sin minutos de entrevista, aparece en el registro.
  • El tiempo extra para un candidato que lo pidió se configura en la página de la invitación en el panel, hasta que empiece.

Pausar retiene las invitaciones y las notas hasta que reanudes. Si el ATS rechaza la clave más adelante, la conexión muestra «Hay que volver a conectar» y las notas esperan.

Usa la API y los webhooks de entrevistas con IA

La API REST pública hace lo mismo que un reclutador en el panel: listar entrevistas publicadas, crear candidatos, invitarlos y obtener resultados. La referencia está en la documentación de la API de entrevistas con IA.

Claves de API

  • Crea una clave en Integraciones → Claves de API. El secreto (aik_live_…) se muestra una sola vez y se envía como token bearer, nunca en una URL.
  • Alcances: dale a cada clave solo los permisos que usa su sistema, como invitations:write y results:read.
  • Lista de IP permitidas: hasta 50 direcciones o rangos, como las direcciones de salida de tus servidores.
  • Vencimiento: 30 días, 90 días (el valor predeterminado), 1 año, una fecha de hasta 2 años o nunca. La lista avisa con 7 días de antelación.
  • Límite de solicitudes: 120 solicitudes por minuto por clave.
La pestaña Claves de API con claves activas y revocadas, sus permisos y sus reglas de IP.
La pestaña Claves de API: los permisos y reglas de IP de cada clave, con las claves revocadas guardadas como registro.

Invita a un candidato desde tu sistema

  1. GET /v1/interviews lista tus entrevistas publicadas.
  2. POST /v1/candidates con el nombre y el correo. Un segundo candidato con el mismo correo se rechaza, así que guarda el id.
  3. POST /v1/invitations con ambos ids. La respuesta incluye el enlace, que se muestra una sola vez; testee también se lo envía por correo al candidato.
  4. Envía un encabezado Idempotency-Key en cada POST. Un reintento con la misma clave tras un tiempo de espera agotado no crea nada dos veces (las claves duran 24 horas).
Campo opcional de la invitaciónQué hace
externalIdTu propio id (el de la postulación, por ejemplo). Vuelve en la invitación y en cada webhook
returnUrlAl terminar, el candidato ve un botón para volver a esta dirección https (no dentro de la inserción)
extraTime25, 50 o 100 por ciento más de tiempo para un candidato que lo pidió; una entrevista dura como máximo 60 minutos, con el tiempo extra incluido. La API nunca lo devuelve ni se envía en los webhooks
nycNoticeEl candidato vive en Nueva York: el correo incluye tu aviso y la entrevista se abre 10 días hábiles después
skipSignInTu sitio ya inició la sesión del candidato: el enlace por sí solo abre la entrevista (consulta la inserción)

Webhooks

Agrega un endpoint en Integraciones → Webhooks: una URL https pública y sus eventos, que son invitation.created, invitation.opened, invitation.resent, invitation.revoked, invitation.expired, session.started, session.completed, results.failed, review.decision_changed, candidate.erased y results.ready. Los payloads solo llevan ids y tu externalId, nunca nombres ni puntuaciones; con results.ready, obtén GET /v1/sessions/{id}/results.

  • Verifica cada firma: un HMAC-SHA256 de la marca de tiempo y el cuerpo sin procesar, con el secreto del endpoint como clave. Compara en tiempo constante y rechaza marcas de tiempo de más de 5 minutos (código en la documentación de webhooks).
  • Responde 2xx en menos de 10 segundos. Los fallos se reintentan con backoff durante unas 24 horas.
  • Espera repeticiones y cualquier orden: omite un id de evento que ya procesaste y lee el estado actual desde la API.

Inserta la entrevista en tu página de empleo

Insertar la entrevista en tu página de empleo mantiene a los candidatos en tu sitio: un script coloca la entrevista en un marco e informa lo que hace el candidato (documentación del Embed SDK).

Inserta la entrevista

  1. Permite tu sitio en Integraciones → Integración web: un origen https sin ruta, hasta 20. La entrevista no se cargará en un marco en ningún otro lugar.
  2. Crea la invitación en tu servidor y pasa su enlace a la página. La clave de API nunca va en la página.
  3. Móntala con TesteeEmbed.mount: un contenedor, el enlace y una función onEvent. La pestaña Integración web del panel muestra el fragmento de código.
  4. Gestiona los eventos: ready, login_required, started, completed, feedback_submitted y error, cada uno solo con ids.

Omitir el código de inicio de sesión

De forma predeterminada, el candidato inicia sesión dentro del marco con un código de 6 dígitos que recibe por correo; tu página nunca lo ve. Si tu sitio ya inició la sesión del candidato, crea la invitación mediante la API con skipSignIn, y el enlace por sí solo abre la entrevista. El panel no permite configurarlo.

  • La contrapartida: el enlace se convierte en la única llave, así que cualquiera que lo tenga puede hacer la entrevista. Limita el vencimiento a uno o dos días, crea la invitación justo antes de que el candidato empiece y muéstrala solo detrás de tu propio inicio de sesión.
  • En el registro: la invitación muestra «Inicio de sesión omitido» y los resultados indican que el sitio de tu empresa verificó la identidad.

Prueba antes de salir en vivo

Una prueba completa

  1. Usa un candidato de prueba con un correo que puedas leer; las vistas previas de los miembros del equipo no envían webhooks.
  2. Envía un evento de prueba de webhook desde el menú del endpoint: un test.ping firmado, que también comprueba tu código de firma.
  3. Revisa el registro de entregas en la página del endpoint. Reenviar vuelve a enviar una entrega con el mismo id, lo que comprueba que omites las repeticiones.
  4. Pasa al candidato a la etapa vinculada y revisa la pestaña Actividad de la conexión con el ATS: cada evento, invitación y nota aparece como completado, en reintento, fallido o ignorado.
  5. Haz la entrevista y comprueba que llegó results.ready, o que la nota apareció en el ATS. Las soluciones a problemas comunes están en la documentación de solución de problemas del ATS.

Notas de seguridad

  • Las claves se quedan en el servidor, una por sistema, solo con los alcances que necesita, una lista de IP permitidas y un vencimiento. Revoca cualquier clave que sospeches que se filtró.
  • Primero verifica, luego confía: rechaza los webhooks cuya firma o marca de tiempo no sea válida, y lee los datos desde la API.
  • Permite solo tus propios sitios para la inserción.
  • Los enlaces de invitación son personales: nunca los registres ni los compartas, sobre todo con skipSignIn.

Notificaciones de Slack

En Integraciones → Slack, conéctate con Agregar a Slack o un webhook entrante, elige qué notificaciones publicar, como resultados listos, y envía un mensaje de prueba (documentación de Slack).

Resumen

  • Si usas uno de los cinco ATS compatibles, usa la conexión nativa: vincula cada vacante y etapa a una entrevista publicada.
  • Si no, usa la API con claves de permisos acotados y con vencimiento, encabezados Idempotency-Key, y verifica cada webhook.
  • Para que los candidatos se queden en tu sitio, agrega la inserción y omite el código de inicio de sesión solo detrás de tu propio inicio de sesión.
  • Antes de salir en vivo, haz una prueba completa con un candidato de prueba.

Preguntas y respuestas

¿testee se integra con Greenhouse o Workable?

Sí, de forma nativa, y también con Teamtailor, Recruitee y Breezy HR. Vinculas una vacante y una etapa a una entrevista publicada; cada candidato que pase a esa etapa recibe una sola invitación, y los resultados vuelven como una nota.

¿Hay una API de entrevistas con IA?

Sí. La API REST crea candidatos e invitaciones, informa su estado y devuelve resultados, informes en PDF y exportaciones CSV. Los webhooks firmados avisan a tu sistema cuando ocurre algo.

Mi ATS no es compatible. ¿Puedo conectarlo de todos modos?

Sí, mediante la API: crea la invitación cuando el candidato llegue a la etapa correcta, guarda en ella tu externalId y obtén los resultados cuando llegue results.ready.

¿Los candidatos pueden hacer la entrevista en nuestra página de empleo?

Sí, con el Embed SDK: permite tu sitio en Integraciones → Integración web, crea la invitación con la API y móntala en tu página.

¿El resultado hace avanzar a los candidatos en el ATS?

No. testee nunca mueve ni rechaza a un candidato. La nota incluye la puntuación de cobertura, marcada como apoyo para la revisión y no como una decisión de contratación; decide una persona.

¿Qué debe incluir una lista de verificación de integración con el ATS?

Qué vacantes y etapas envían invitaciones, quién es responsable de las claves, cómo se verifican los webhooks, qué vuelve al ATS, cómo se detectan los fallos, cómo se gestionan los candidatos de Nueva York y las solicitudes de ajustes, y una prueba completa.

Fuentes

  1. Documentación para desarrolladores de testee: integraciones con ATS
  2. Documentación para desarrolladores de testee: API REST
  3. Documentación para desarrolladores de testee: webhooks
  4. Documentación para desarrolladores de testee: Embed SDK
  5. Documentación para desarrolladores de testee: Slack
  6. Especificación Standard Webhooks
  7. RFC 2104, HMAC: Keyed-Hashing for Message Authentication

Pruébaloen tu próxima vacante.

Crea en minutos una entrevista estructurada con IA a partir de tu descripción del puesto.14 días gratis, sin tarjeta.