Dit artikel licht toe hoe je de Greenhouse-integratie instelt in Personio. Na de verbinding, stelt de Greenhouse-integratie automatisch nieuwe medewerkers in Personio in zodra de status van een kandidaat in Greenhouse is gemarkeerd als Aangesteld. Dankzij de integratie kunnen specifieke attributen in Personio en Greenhouse worden gesynchroniseerd, zodat Personio de informatie in je account kan importeren.
Vereisten voor een geslaagde integratie
Voordat je het integratieproces start, moet je voor het volgende zorgen:
- Je beschikt over een rol als beheerder of bewerkingsrechten voor de Marketplace in Personio via Instellingen > Medewerkers > Medewerkersrollen > Toegangsrechten > Accountconfiguratie > Marketplace-integratie.
- Je hebt toegang tot het Dev Center (Developer Permissions) in Greenhouse.
- Het selectievakje Tray.io, Inc is geactiveerd via Instellingen > Support > Abonnement & Facturering > Informatie over gegevensbescherming.
- De attributen Voornaam, Achternaam en E-mailadres worden in Greenhouse aangevuld voor de correcte uitwisseling van informatie.
Greenhouse verbinden en authenticeren
Stel de Greenhouse-integratie rechtstreeks in via de Marketplace van Personio met de configuratiewizard. Hiervoor moet je een API-sleutel genereren in Greenhouse, die je vervolgens invoert in Personio. Volg deze stappen:
- Ga naar Marketplace in Personio, en zoek en selecteer vervolgens de Greenhouse-integratie.
- Klik op Verbinding maken om de configuratiewizard te openen.
- Log in op je Greenhouse-account.
- Maak een API-sleutel in het gebied API Credential Management in Greenhouse. Deze stappen worden beschreven in stap één van de configuratiewizard in Personio.
- Voer de gegenereerde API-sleutel in, in het tekstvak Greenhouse API-sleutel in de Personio-configuratiewizard.
- Klik op Volgende om naar stap twee van de configuratiewizard te gaan en Personio te verifiëren.
Opmerking
Sla je API-sleutel voor Greenhouse veilig op. Als je de sleutel kwijtraakt, moet je een nieuwe aanmaken.
Personio authenticeren
Stap twee van de configuratiewizard vereist dat je Greenhouse toegang verleent tot de benodigde Personio-gegevens. Volg deze stappen:
- Bekijk de voor de Greenhouse-integratie vereiste machtigingen.
- Klik op Volgende om door te gaan naar stap drie van de configuratiewizard en wijs attributen toe.
Tip
Je kunt de verleende machtigingen na afloop van het installatieproces bekijken door naar Instellingen > Integraties > API-referenties te gaan en de Greenhouse-integratie te selecteren.
Attributen toewijzen
In stap drie van de configuratiewizard kun je selecteren welke Greenhouse-attributen moeten worden gesynchroniseerd of afgestemd met Personio. Volg deze stappen:
- Controleer alle attributen en zorg ervoor dat elk Personio-attribuut overeenkomt met het corresponderende Greenhouse-attribuut.
- Klik op Nieuw attribuut toevoegen om meer attributen op te nemen.
- Klik op Volgende om door te gaan naar stap vier van de configuratiewizard: Een webhook aanmaken.
Opmerking
Als je attributen van het type Lijst met opties of Tags toewijst, zorg dan dat de attribuutwaarden in Personio en Greenhouse identiek zijn.
Een webhook aanmaken
In stap vier van de configuratiewizard moet je een webhook aanmaken. Volg deze stappen:
- Keer terug naar de Web Hooks-sectie van het Greenhouse Dev Center en volg de instructies op de Greenhouse-pagina.
- Raadpleeg de stappen in de configuratiewizard van Personio voor aanvullende instructies.
- Voer de Endpoint URL in Greenhouse in door op de knop Link kopiëren te klikken onder de stappen in de configuratiewizard. Plak de link in het vak Endpoint URL .
- Blijf de stappen in de configuratiewizard volgen om het aanmaken van de webhook te voltooien.
- Klik op Voltooien.
- Keer terug naar het Greenhouse Dev Center en schakel de webhook in.
- Klik onder Edit Web Hook op het potloodpictogram naast de webhook die je wilt inschakelen.
- Onder Deactivated?, selecteer je No.
- Klik op Update Web Hook.
Het instellen van de integratie is voltooid.
Opmerking
Als je de Greenhouse-integratie opnieuw activeert, moet je een nieuwe webhook aanmaken. De vorige webhook zal niet meer werken.