Polyguard PreScreen para Greenhouse¶
| Producto | Polyguard PreScreen |
| ATS | Greenhouse (Job Board API + Harvest v3, OAuth de partner) |
| Consola | console.polyguard.ai |
| Tiempo de configuración | aproximadamente 15 minutos |
| Contacto | [email protected] |
1. Descripción general¶
PreScreen condiciona cada solicitud a una Trust Check de Polyguard: una breve comprobación, que el candidato completa en su teléfono, que confirma que quien se postula es una persona real. Los candidatos no verificados se retienen en la primera etapa de su pipeline; los verificados avanzan automáticamente, con la verificación registrada en la solicitud.
Cómo funciona¶
Las solicitudes llegan a Greenhouse de dos maneras, y PreScreen cubre ambas.
| Dónde se postula el candidato | Cómo se condiciona | |
|---|---|---|
| Solicitud alojada | Su sitio de empleo de Polyguard | El formulario retiene el envío hasta que la Trust Check se supera y luego envía a Greenhouse con la verificación adjunta |
| Solicitud directa | Greenhouse mismo, a través de LinkedIn, Indeed o una referencia | Greenhouse notifica a Polyguard, que envía al candidato una Trust Check por correo y lo retiene en la primera etapa hasta que la completa |
La mayoría de las solicitudes llegan por la segunda vía, por eso la conexión con Greenhouse de la Sección 5 no es opcional: conectar es lo que registra el webhook que avisa a Polyguard de cada nueva solicitud.
Lo que configurará¶
- Una app de PreScreen en la Consola de Polyguard, con su propio nombre de host
- Una clave de API Job Board, usada para enviar las solicitudes alojadas a Greenhouse
- Un campo personalizado de solicitud que registra la verificación
- Una etapa
Human Verificationen cada empleo protegido - La conexión con Greenhouse: una autorización de partner que se hace una sola vez, permite a Polyguard mover solicitudes y registra el webhook de solicitudes por usted
Quién hace qué¶
Los pasos marcados (Polyguard) necesitan una cuenta del personal de Polyguard. Todo lo demás puede hacerlo un administrador de la cuenta.
2. Requisitos previos¶
| Requisito | Detalles |
|---|---|
| Acceso a Greenhouse | Un usuario que pueda administrar el Dev Center (normalmente Site Admin), editar planes de entrevista y aprobar la app de partner de Polyguard para su cuenta de Greenhouse |
| Cuenta de Polyguard | Acceso a la Consola en console.polyguard.ai con el rol de administrador |
| Recursos de marca | Logotipo, colores de marca exactos y el nombre comercial para el sitio de empleo |
| Un empleo de prueba | Un empleo abierto al que pueda postularse de extremo a extremo antes de salir a producción |
Los secretos se muestran una sola vez
Greenhouse muestra la clave de API Job Board exactamente una vez, y la Consola de Polyguard la almacena en modo solo escritura, mostrando después únicamente los últimos 4 caracteres. Cópiela en la Consola en el momento en que la cree. Es el único secreto de Greenhouse que usted maneja: la conexión con Greenhouse de la Sección 5 guarda sus tokens en el servidor de Polyguard.
3. Recopile sus valores de Greenhouse¶
La clave de API Job Board está en Configure (⚙️) → Dev Center. El campo personalizado y la etapa del pipeline están en otras partes de Configure.

Recorra de 3a a 3d y tenga los valores a mano. Los pegará en la Consola en la Sección 4.
3a. Clave de API Job Board¶
-
Abra API Credential Management en la barra lateral del Dev Center.

-
Haga clic en Create new API credentials, arriba a la derecha.

-
Complete:
- API Type:
Job Board - Partner:
Polyguardsi aparece en la lista; de lo contrario,Unlisted vendor - Description:
Polyguard: Job Board
- API Type:
- Haga clic en Manage permissions y conceda:
- el permiso POST Submit Application
- Copie la clave y luego haga clic en I have stored the API Key.
Modo demo
Dejar esto en blanco más adelante mantiene el sitio de empleo en modo demo: muestra exactamente lo que habría enviado, sin publicar en Greenhouse. Es útil para un ensayo antes de salir a producción.
3b. Token del tablero¶
El identificador en la URL pública de su tablero, job-boards.greenhouse.io/<your-board-token>. Confirme que devuelve sus puestos activos. No se necesita clave, estos endpoints son públicos:
curl -s "https://boards-api.greenhouse.io/v1/boards/<your-board-token>/jobs" | head -c 300
3c. Campo personalizado para el token de verificación¶
Un campo para toda la organización, creado una sola vez. Consulte Create a new custom application field de Greenhouse.
- Abra Configure → Custom Options → Application → Add Field.
- Complete:
- Name:
Polyguard Verification Token - Field type:
Short textbox
- Name:
- Guarde, vuelva a abrir el campo y anote la clave de campo generada, por ejemplo
polyguard_verification_token.
3d. La etapa Human Verification¶
- Abra un empleo → Job Setup → Interview Plan → Add stage → Create a custom stage.
- Complete:
- Stage name:
Human Verification, escrito exactamente así - Position: segunda, inmediatamente después de la primera etapa
- Stage name:
- Guarde.
Greenhouse no permite una primera etapa personalizada. Las solicitudes llegan a la primera etapa, los candidatos no verificados se retienen ahí, y PreScreen los avanza a Human Verification cuando la superan.
Cada empleo protegido necesita la etapa
Los equipos cuyos pipelines nombran estas etapas de otra forma pueden listarse en Pipeline stages by team, en la tarjeta Candidate verification de la página de configuración de PreScreen, con sus propios nombres de etapa inicial y verificada.
La etapa debe existir, con el mismo nombre y en segunda posición, en todos los empleos que quiera proteger. Use Edit job stage in bulk para desplegarla en los empleos abiertos.
4. Configurar la app en Polyguard¶
4a. Crear la app de PreScreen (Polyguard)¶
Consola → Create App → tipo de app PreScreen.

Al crearla se reserva un nombre de host de la forma {account-slug}.prescreen.polyguard.ai. Un segundo inquilino en la misma cuenta recibe -2, -3, y así sucesivamente.
4b. Comprobar el nombre de host (Polyguard lo cambia)¶
Settings → Hostnames muestra el host desde el que se sirve este inquilino. Los administradores de la cuenta pueden leerlo; solo el personal de Polyguard puede cambiarlo.

Importa más allá de la barra de direcciones: la dirección a la que Polyguard entrega los resultados de verificación se construye a partir de él, y también el endpoint por defecto del webhook que Polyguard registra en la Sección 5.
Nota
El nombre reservado no es un sitio activo hasta que Polyguard lo asocia al despliegue del inquilino. Esa es una tarea de Polyguard y no bloquea el resto de esta guía.
4c. Conexión con el ATS¶
Settings → ATS connection. En Provider, elija Greenhouse (Harvest v3). Los campos aparecen bajo Greenhouse Parameters.

| Campo | Valor | De |
|---|---|---|
| Board token | el identificador de su tablero | 3b |
| Job Board API key | la clave Job Board; en blanco mantiene los envíos en modo demo | 3a |
| Gate stage name | ya contiene Human Verification; cámbielo solo si su etapa tiene otro nombre | 3d |
| Polyguard field key | ya contiene polyguard_verification_token; cámbielo si Greenhouse generó una clave distinta | 3c |
| Webhook endpoint URL | opcional; la dirección en gris es la que Polyguard registra cuando el campo está en blanco | Sección 5 |
| Manual source names | opcional, por defecto Internal Applicant | orígenes a los que nunca se envía una Trust Check |
Haga clic en Save ATS configuration. Los secretos se borran del formulario al guardar y después muestran sus últimos 4 caracteres; dejar un secreto en blanco conserva el valor almacenado en lugar de borrarlo.
4d. Vencimiento de las Trust Checks enviadas por correo¶
En la tarjeta Candidate verification, bajo Auto-archive. La tarjeta muestra estos ajustes una vez guardada la configuración del ATS.
| Campo | Valor |
|---|---|
| Trust Check expiry (days) | de 1 a 7; 3 si no se define |
| Rejection reason id | opcional; se usa el valor por defecto de Greenhouse si está en blanco |
| Reject application on expiry | márquelo para rechazar en Greenhouse una solicitud cuya Trust Check enviada por correo vence; sin marcar, la solicitud permanece retenida en la primera etapa |
Haga clic en Save switches.
5. Conectar Greenhouse¶
Greenhouse notifica a Polyguard cada vez que un candidato envía una solicitud, y Polyguard mueve a los candidatos verificados y registra el token de verificación a través de la API de Greenhouse. Ambas cosas pasan por la app de partner de Polyguard, autorizada una sola vez desde la Consola. No hay nada que crear en el Dev Center: ni clave Harvest, ni web hook, ni secreto.
5a. Elegir el usuario que autoriza¶
Greenhouse atribuye cada acción que realiza Polyguard (mover una solicitud a Human Verification, escribir el token de verificación en el campo personalizado, rechazar una solicitud vencida) al usuario que aprueba la conexión. Inicie sesión en Greenhouse como un usuario dedicado de operaciones de reclutamiento o como un Integration System User, en lugar de una cuenta personal, para que la atribución no cambie cuando cambie el personal. Ese usuario debe poder editar y mover solicitudes en los empleos protegidos.
5b. Conectar¶
- Connect Greenhouse está al final de la tarjeta ATS connection, debajo de Save ATS configuration. Hasta que se guarden el proveedor y sus campos, el botón no está disponible y la nota a su lado dice Save these settings before connecting. Una vez guardados, el estado a su lado dice Partner OAuth: not connected.
- Haga clic en Connect Greenhouse. Se le envía a Greenhouse; inicie sesión si se le pide y apruebe la app de partner de Polyguard.
- Vuelve a la Consola con el aviso Greenhouse connected and webhook registered. El estado ahora dice Partner OAuth: connected. y el botón pasa a ser Reconnect Greenhouse.

El icono de información junto al botón resume lo que ocurre: conectar autoriza a Polyguard con su cuenta de Greenhouse y registra automáticamente el webhook de solicitudes; los tokens permanecen en el servidor.
Lo que concede la conexión¶
| Permiso | Por qué PreScreen lo necesita |
|---|---|
| Listar, crear, actualizar y eliminar webhooks | Registrar el webhook de solicitudes y mantenerlo actualizado |
| Listar solicitudes | Leer el estado y el origen de la solicitud |
| Mover solicitudes | Avanzar a un candidato verificado a Human Verification |
| Actualizar solicitudes | Escribir el token de verificación en el campo personalizado |
| Rechazar solicitudes | Rechazar una solicitud cuya Trust Check venció, cuando esa opción está activada |
| Listar etapas de entrevista de los empleos | Encontrar la etapa de control en el pipeline de un empleo |
Polyguard registra webhooks para el evento Candidate has submitted application y para los cambios de empleos y publicaciones de empleo. No hay que crear ni editar nada en Dev Center → Web Hooks.
Los tokens se renuevan automáticamente
Polyguard renueva su token de acceso por sí mismo. Si la Consola vuelve a mostrar Partner OAuth: not connected., haga clic en Connect Greenhouse y apruebe la app de nuevo.
6. Verificación¶
Ejecute las cuatro antes de salir a producción.
6.1 Listados¶
Abra el sitio de empleo en su nombre de host. Sus puestos activos de Greenhouse deberían aparecer, con su marca.
6.2 Solicitud alojada¶
- Postúlese a través del sitio de empleo y complete la Trust Check en un teléfono.
- En Greenhouse, confirme que el candidato aparece, está en Human Verification y tiene el campo Polyguard Verification Token completado.
6.3 Solicitud directa¶
- Postúlese a través de su tablero público de Greenhouse, usando una dirección de correo distinta a la de 6.2.
- Confirme que llega el correo de Trust Check.
- Complétela y confirme que la solicitud avanza a Human Verification.
Use un correo distinto
Reutilizar el de 6.2 coincide con la verificación ya almacenada en caché para ese empleo, por lo que la solicitud avanza de inmediato y la ruta por correo nunca se ejercita.
6.4 Anulación manual¶
Advanced → Manual verification, con el id de enlace de un candidato que haya confirmado por otro medio, avanza esa solicitud. Un uso por enlace.
7. Uso de PreScreen¶
Día a día¶
Nada que hacer. Las solicitudes llegan, los candidatos se verifican y los verificados avanzan a Human Verification con el token registrado en la solicitud. Los candidatos que nunca se verifican permanecen en la primera etapa hasta que vence su Trust Check.
Herramientas del operador¶
| Ubicación en la Consola | Qué hace |
|---|---|
| Advanced → Manual verification | Avanzar a un candidato verificado por otro medio |
| Verification → Test email | Enviarse una Trust Check para confirmar la entrega |
| Analytics | Embudo de Trust Checks de la cuenta |
| Settings → Branding | Nombre de la empresa, colores, logotipo y tema |
Añadir un empleo más adelante¶
Los empleos nuevos necesitan la etapa Human Verification en segunda posición (3d). Todo lo demás es de toda la cuenta y ya está configurado.
8. Solución de problemas¶
Nada llega a Polyguard¶
La conexión con Greenhouse no está establecida, así que no hay ningún webhook registrado y las solicitudes directas nunca se ven. Abra Settings → ATS connection y lea el estado junto al botón Connect Greenhouse, al final de la tarjeta. Si dice Partner OAuth: not connected., haga clic en Connect Greenhouse (Sección 5); el webhook se registra de nuevo como parte de la conexión.
El candidato avanza pero el campo del token queda vacío¶
El usuario de Greenhouse que aprobó la conexión no puede editar solicitudes en ese empleo. La escritura del token se rechaza mientras el cambio de etapa sí se realiza, así que nada parece roto. Haga clic en Reconnect Greenhouse y apruebe la app como un usuario que pueda editar solicitudes (5a).
Un cambio en la Consola no ha tenido efecto¶
La configuración se almacena en caché durante 60 segundos. Espere un minuto y vuelva a intentarlo. La marca es la excepción: vea más abajo.
Los cambios de marca no aparecen en el sitio de empleo¶
Dele hasta una hora. El índice de empleo y las páginas de puestos se renderizan por adelantado y se actualizan cada hora, así que un cambio de marca se recoge en la siguiente actualización y no en la siguiente carga de página.
Un campo dejado en blanco en la Consola recurre a la configuración propia del despliegue, y un valor que el sitio rechaza por inseguro (un logotipo o URL de sitio que no sea https://, un color que no sea un color CSS válido) recurre a lo mismo, así que revise el valor si un campo conserva la marca anterior mientras el resto se actualiza.
El correo de invitación a la Trust Check sigue tomando su nombre de empresa de la configuración del despliegue, no de estos campos.
El sitio de empleo no muestra puestos¶
O el token del tablero es incorrecto (3b), o el proveedor seleccionado en la Consola no coincide con el que ejecuta el despliegue. La discrepancia es silenciosa: la configuración de la Consola simplemente se ignora.
A un candidato nunca se le envió una Trust Check por correo¶
Las solicitudes sin origen, o con un origen listado en Manual source names, se tratan como entradas de reclutadores y deliberadamente nunca reciben correo. Un reclutador que añade un candidato a mano ya ha decidido que pertenece al pipeline.
9. Soporte¶
- Correo: [email protected]
- Consola: console.polyguard.ai
- Envío de correos de Trust Check desde su propio dominio: Envío desde su dominio
Documentación de Greenhouse¶
- Crear una clave de API de job board para una integración
- Crear un nuevo campo personalizado de solicitud
- Descripción general del plan de entrevistas
- Editar etapas de empleo en bloque
- Job Board API
Para problemas de la plataforma Greenhouse no relacionados con Polyguard, contacte a su administrador de Greenhouse o al soporte de Greenhouse.