Este artículo explica cómo configurar la integración de Greenhouse con Personio. Cuando se conecta, la integración de Greenhouse configura automáticamente nuevos empleados en Personio una vez que el estado de un candidato en Greenhouse se marca como Contratado. La integración permite sincronizar atributos específicos en Personio y Greenhouse, para que Personio pueda importar la información correspondiente a tu cuenta.

Requisitos previos para una integración correcta

Antes de comenzar el proceso de integración, asegúrate de que exista lo siguiente:

• Tienes un rol de administrador o permisos de edición a través de tu rol de empleado para la integración con Marketplace y la API.
• Tienes acceso al Centro de desarrollo (Permisos de desarrollador) en Greenhouse.
• Los atributos Nombre, Apellido y Dirección de correo electrónico se completan en Greenhouse para un intercambio de información exitoso.

Conecta y autentica Greenhouse

Configura la integración de Greenhouse directamente en el Marketplace de Personio con el asistente de configuración. Esto requiere que generes una clave API en Greenhouse, que luego ingresas en Personio. Sigue estos pasos:

1. Ve a Marketplace en Personio, luego busca y selecciona la integración Greenhouse.
2. Haz clic en Conectar para abrir el asistente de configuración.
3. Inicia sesión en tu cuenta de Greenhouse.
4. Cree una clave API en el área de Gestión de credenciales API de Greenhouse. Estos pasos se describen en el paso uno del Asistente de configuración de Personio.
5. Una vez generada, ingresa la clave API en el cuadro de texto Clave API de Greenhouse en el asistente de configuración de Personio.
6. Haz clic en Siguiente para ir al paso dos del Asistente de configuración y Autenticar Personio.

Ten en cuenta que:
Debes guardar tu clave API de Greenhouse en un lugar seguro. Si la pierdes, tendrás que solicitar una nueva.

Autenticar Personio

El segundo paso del Asistente de configuración requiere que concedas a la integración de Greenhouse acceso a los datos necesarios de Personio. Sigue estos pasos:

1. Revisa los permisos que requiere la integración de Greenhouse.
2. Haz clic en Siguiente para continuar con el paso tres del Asistente de configuración y los atributos del mapa.

Consejo:
Puedes revisar los permisos otorgados después del proceso de configuración yendo a Ajustes > Seguridad e integraciones > Credenciales de la API y seleccionando la integración de Greenhouse.

Atributos de mapeo

En el paso tres del Asistente de configuración, puedes seleccionar qué atributos de Greenhouse deben sincronizarse o alinearse con Personio. Sigue estos pasos:

1. Revisa todos los atributos y asegúrate de que cada atributo de Personio coincida con el atributo de Greenhouse correspondiente.
2. Haz clic en Agregar nuevo atributo para incluir más atributos.
3. Haz clic en Siguiente para continuar con el paso cuatro del Asistente de configuración, Crear un webhook.

Ten en cuenta que:
Si estás asignando atributos del tipo Lista de opciones, asegúrate de que los valores de atributo sean idénticos en Personio y Greenhouse.

Notas importantes sobre la asignación de atributos

Si la integración crea un perfil del empleado, pero faltan algunos atributos, esto puede ser por problemas de asignación entre Greenhouse y Personio. Considera los siguientes casos comunes:

• Atributos de fecha: Personio requiere fechas en el formato DD.MM.AAAA. Si un atributo de fecha de Personio no se asigna directamente a un atributo de fecha de Greenhouse, es posible que los datos no se transfieran correctamente.
• Atributos monetarios/salariales: Greenhouse combina el valor y el tipo de moneda en un solo campo. Estos campos combinados no se pueden asignar a los campos de moneda separados de Personio.
• Atributos basados en números: Los tipos de atributos de selección múltiple de Greenhouse no son compatibles con los atributos enteros o decimales de Personio y no se pueden asignar.

Revisa las asignaciones de atributos para garantizar la compatibilidad y ajusta según sea necesario.

Crear un webhook

En el paso cuatro del Asistente de configuración, tienes que crear un webhook. Para crear un webhook, sigue estos pasos:

1. Regresa a la sección Web Hooks del Greenhouse Dev Center y sigue las instrucciones en la página de Greenhouse.
2. Consulta los pasos descritos en el Asistente de configuración de Personio para obtener instrucciones adicionales.
3. Ingresa la URL del endpoint en Greenhouse haciendo clic en el botón Copiar enlace debajo de los pasos del Asistente de configuración. Pega el enlace en el cuadro URL del endpoint. 
4. Continúa siguiendo los pasos del Asistente de configuración para terminar de crear el webhook.
5. Haz clic en Finalizar. 
6. Regresa al centro de desarrollo de Greenhouse y activa el webhook.
   • En Editar web hook, haz clic en el ícono de lápiz junto al web hook que deseas activar.
   • ¿En Desactivado?, selecciona No.
   • Haz clic en Actualizar webhook.

La configuración de integración está completa.

Ten en cuenta que:
Si reactivas la integración Greenhouse, tendrás que crear un nuevo webhook. El webhook anterior ya no funcionará.