Este artículo explica cómo configurar la integración de Greenhouse con Personio. Cuando se conecta, la integración con Greenhouse crea automáticamente un perfil del empleado en Personio si un candidato está marcado como contratado en Greenhouse. La integración sincroniza atributos específicos entre Personio y Greenhouse, de modo que Personio pueda importar la información correspondiente a la cuenta.

Requisitos previos para una integración correcta

Antes de comenzar el proceso de integración, comprueba que se cumpla 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.
• Rellena los atributos Name (Nombre), Last name (Apellidos) y Email address (Correo electrónico) en Greenhouse, ya que la integración los necesita para intercambiar la información correctamente.

Conexión con Greenhouse

Configura la integración de Greenhouse directamente en el Marketplace de Personio con el asistente de configuración. Sigue estos pasos:

1. Ve a Marketplace en Personio. Busca y selecciona la integración de Greenhouse.
2. Haz clic en Conectar para abrir el asistente de configuración. 
3. Haz clic en Autenticar Greenhouse para comenzar.
4. En la pantalla de autorización de Greenhouse, introduce el correo electrónico que utilizas en Greenhouse y haz clic en Iniciar sesión en Greenhouse.
5. En la segunda pantalla de autorización, selecciona opcionalmente Autorizar mediante una cuenta de servicio. Esto se recomienda para entornos de producción, ya que establece una conexión para la organización que se mantiene si cambia tu cuenta personal.
6. Haz clic en Autorizar para completar la conexión y continuar con el siguiente paso.

Autenticar Personio

El segundo paso del asistente de configuración requiere que otorgues 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. Otorga a la integración acceso para escribir los datos de los empleados. Personio necesita este acceso para crear perfiles de los empleados a partir de los candidatos contratados.
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 en la integración de Greenhouse, en Ajustes > Seguridad e integraciones > Credenciales de la API.

Atributos de mapeo

En el paso tres del asistente de configuración, puedes seleccionar qué atributos de Greenhouse quieres que se sincronicen con Personio. Sigue estos pasos:

1. Revisa todos los atributos y comprueba 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.

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 en Greenhouse.

Notas importantes sobre la asignación de atributos

Si la integración crea un perfil del empleado, pero faltan algunos atributos, se puede deber a 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.  No se pueden asignar estos campos combinados a campos de divisa individuales 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 la asignación de atributos para comprobar si son compatibles y ajústala según sea necesario.

Crear un webhook

En el paso cuatro del asistente de configuración, tienes que crear un webhook en Greenhouse. Sigue estos pasos:

1. En el asistente de configuración de Personio, copia la URL del endpoint. Tienes que introducirla en Greenhouse en el siguiente paso.
2. En Greenhouse, ve a Configure (Configurar) > Dev Center (Centro de desarrollo) > Webhooks > Create A New Webhook (Crear un webhook).
3. Introduce estos datos en el formulario:
   • Nombre: introduce un nombre descriptivo del webhook. Recomendamos “Integración con Personio”.
   • Cuándo: se ha contratado al candidato.
   • URL del endpoint: pega la URL copiada del asistente de configuración de Personio.
   • Clave secreta: una clave única de tu preferencia.
   • Colaborador asociado: selecciona Personio.
   • ¿Desactivado? Deja esta opción en Sí de momento. Una vez que completes los pasos restantes en Personio, tendrás que cambiarlo para activar el webhook. 
4. Haz clic en Crear webhook.
5. Vuelve a Personio y haz clic en Finalizar. 
6. Vuelve a Greenhouse, busca el webhook que has creado y, en Desactivado, cambia de Sí a No para activarlo.