Cet article explique comment configurer l’intégration Greenhouse avec Personio. Une fois la connexion établie, l’intégration Greenhouse configure automatiquement les nouveaux employés dans Personio lorsque le statut d’un candidat est défini sur « Embauché » ("Hired") dans Greenhouse. Cette intégration permet de synchroniser des attributs spécifiques dans Personio et Greenhouse. Personio peut ainsi importer les informations correspondantes dans votre compte.

Conditions requises pour une intégration réussie

Avant de lancer le processus d’intégration, vérifiez les points suivants :

• Vous disposez d’un rôle d’administrateur ou des droits de modification sur la Marketplace dans Personio via Paramètres > Personnel > Rôles > Droits d’accès > Configuration du compte > Intégration Marketplace.
• Vous avez accès au Dev Center (Autorisations du développeur) dans Greenhouse.
• La case Tray.io, Inc est cochée via Paramètres > Support > Abonnement et facturation > Informations sur la protection des données.
• Les attributs Prénom, Nom et Adresse e-mail sont renseignés dans Greenhouse pour un échange d’informations réussi.

Connexion et authentification Greenhouse

Configurez l’intégration Greenhouse directement dans le Marketplace de Personio à l’aide de l’assistant de configuration. Pour ce faire, vous devez générer dans Greenhouse une clé API que vous entrerez ensuite dans Personio. Procédez comme suit :

1. Dans Personio, accédez au Marketplace, puis recherchez et sélectionnez l’intégration Greenhouse.
2. Cliquez sur Connecter pour ouvrir l’assistant de configuration.
3. Connectez-vous à votre compte Greenhouse.
4. Créez une clé API dans la zone de gestion des identifiants API Greenhouse. Ces étapes sont décrites dans la première étape de l’assistant de configuration de Personio.
5. Une fois générée, saisissez la clé API dans la zone de texte Clé API Greenhouse de l’assistant de configuration de Personio.
6. Cliquez sur Suivant pour passer à la deuxième étape de l’assistant de configuration, Authentification Personio.

Remarque
Conservez votre clé API Greenhouse en lieu sûr. Si vous la perdez, vous devrez en créer une nouvelle.

Authentification Personio

Pour la deuxième étape de l’assistant de configuration, vous devez accorder à l’intégration Greenhouse l’accès aux données Personio nécessaires. Procédez comme suit :

1. Passez en revue les autorisations requises par l’intégration Greenhouse.
2. Cliquez sur Suivant pour passer à la troisième étape de l’assistant de configuration, Affecter les attributs.

Conseil
Vous pouvez consulter les autorisations accordées après le processus de configuration en vous rendant dans Paramètres > Intégrations > Identifiants API et en sélectionnant l’intégration Greenhouse.

Affecter les attributs

À la troisième étape de l’assistant de configuration, vous pouvez sélectionner les attributs Greenhouse qui doivent être synchronisés, ou alignés, avec Personio. Procédez comme suit :

1. Passez en revue tous les attributs et vérifiez que chaque attribut Personio est associé à l’attribut Greenhouse correspondant.
2. Cliquez sur Ajouter un nouvel attribut pour inclure d’autres attributs.
3. Cliquez sur Suivant pour passer à la quatrième étape de l’assistant de configuration, Créer un webhook.

Remarque
Si vous affectez des attributs de type Liste d’options ou Tags, vérifiez que les valeurs d’attribut sont identiques dans Personio et Greenhouse.

Créer un webhook

À la quatrième étape de l’assistant de configuration, vous devez créer un webhook en procédant comme suit :

1. Revenez dans la section Webhooks du Greenhouse Dev Center et suivez les instructions de la page Greenhouse.
2. Reportez-vous aux étapes décrites dans l’assistant de configuration de Personio pour obtenir des instructions supplémentaires.
3. Entrez l’URL du point de terminaison dans Greenhouse en cliquant sur le bouton Copier le lien situé sous les étapes de l’assistant de configuration. Collez le lien dans la zone URL du point de terminaison. 
4. Continuez à suivre les étapes de l’assistant de configuration pour terminer la création du webhook.
5. Cliquez sur Terminer. 
6. Revenez dans le Greenhouse Dev Center et activez le webhook.
   • Sous Modifier le webhook, cliquez sur l’icône en forme de crayon en face du webhook que vous souhaitez activer.
   • Sous Désactivé ?, sélectionnez Non.
   • Cliquez sur Mettre à jour le webhook.

La configuration de l’intégration est terminée.

Remarque
Si vous réactivez l'intégration Greenhouse, vous devrez créer un nouveau webhook. Le webhook précédent ne fonctionnera plus.