In diesem Artikel erklären wir, wie Sie die Integration von Greenhouse mit Personio einrichten. Sobald eine Verbindung hergestellt ist, erstellt die Greenhouse-Integration automatisch ein neues Mitarbeitendenprofil in Personio, wenn eine sich bewerbende Person in Greenhouse als Eingestellt markiert wird. Die Integration synchronisiert bestimmte Attribute zwischen Personio und Greenhouse, sodass Personio die entsprechenden Informationen in Ihren Account importieren kann.
Voraussetzungen für eine erfolgreiche Integration
Vergewissern Sie sich vor der Integration, dass Folgendes der Fall ist:
- Sie verfügen über eine Admin-Rolle oder Bearbeitungsberechtigungen über Ihre Mitarbeitendenrolle für die Marketplace Integration und API.
- Sie haben Zugriff auf das Dev Center (Entwicklungsberechtigungen) in Greenhouse.
- Füllen Sie die Attribute Vorname, Nachname und Adresse in Greenhouse aus, da die Integration sie für einen erfolgreichen Informationsaustausch benötigt.
Verbindung zu Greenhouse herstellen
Richten Sie die Greenhouse-Integration mit dem Konfigurationsassistenten direkt im Personio Marketplace ein. Befolgen Sie diese Schritte:
- Gehen Sie zu Marketplace in Personio. Suchen Sie nach der Greenhouse-Integration und wählen Sie sie aus.
- Klicken Sie auf Verbinden, um den Konfigurationsassistenten zu öffnen.
- Klicken Sie auf Greenhouse authentifizieren, um zu beginnen.
- Geben Sie auf dem Greenhouse-Autorisierungsbildschirm Ihre Greenhouse-E-Mail-Adresse ein und klicken Sie auf Bei Greenhouse einloggen.
- Wählen Sie auf dem zweiten Autorisierungsbildschirm optional Mit einem Service-Account autorisieren aus. Das empfiehlt sich für Produktionsumgebungen, da dadurch eine Verbindung auf Organisationsebene hergestellt wird, die auch dann bestehen bleibt, wenn sich Ihr persönlicher Account ändert.
- Klicken Sie auf Autorisieren, um die Verbindung abzuschließen und mit dem nächsten Schritt fortzufahren.
Authentifizieren Sie Personio
In Schritt zwei des Konfigurationsassistenten müssen Sie der Greenhouse-Integration Zugriff auf die erforderlichen Personio Daten gewähren. Befolgen Sie diese Schritte:
- Überprüfen Sie die Berechtigungen, die für die Greenhouse-Integration erforderlich sind. Gewähren Sie der Integration Schreibzugriff auf Mitarbeitendendaten. Personio benötigt diesen Zugriff, um Mitarbeitendenprofile für eingestellte Bewerbende zu erstellen.
- Klicken Sie auf Weiter, um mit Schritt drei des Konfigurationsassistenten und Zuordnung der Attribute fortzufahren.
Tipp:
Sie können die gewährten Berechtigungen nach der Einrichtung überprüfen, indem Sie in der Greenhouse-Integration zu Einstellungen > Sicherheit & Integrationen > API-Zugriffsdaten gehen.
Attribute zuordnen
Im dritten Schritt des Konfigurationsassistenten können Sie auswählen, welche Greenhouse-Attribute mit Personio synchronisiert werden sollen. Befolgen Sie diese Schritte:
- Überprüfen Sie alle Attribute und vergewissern Sie sich, dass jedes Personio Attribut dem entsprechenden Greenhouse-Attribut entspricht.
- Klicken Sie auf Attribut hinzufügen, um weitere Attribute hinzuzufügen.
- Klicken Sie auf Weiter , um mit Schritt vier des Konfigurationsassistenten fortzufahren.
Hinweis:
Wenn Sie Attribute vom Typ Auswahlliste zuordnen, vergewissern Sie sich, dass die Attributwerte in Personio und Greenhouse identisch sind.
Wichtige Hinweise zur Attributzuordnung
Wenn bei der Integration ein Mitarbeitendenprofil erstellt wird, aber einige Attribute fehlen, kann das an Problemen mit der Zuordnung zwischen Greenhouse und Personio liegen. Beachten Sie die folgenden häufigen Fälle:
- Datumsattribute: Personio benötigt Daten im Format DD.MM.YYYY. Wenn Sie ein Personio Datumsattribut nicht direkt einem Greenhouse-Datumsattribut zuordnen, werden die Daten möglicherweise nicht korrekt übertragen.
- Währungs-/Vergütungsattribute: Greenhouse kombiniert Wert und Währungstyp in einem Feld. Diese kombinierten Felder lassen sich den separaten Währungsfeldern von Personio nicht zuordnen.
- Zahlenbasierte Attribute: Multi-Select-Attributsarten in Greenhouse sind nicht mit Ganzzahl- oder Dezimalattributen von Personio kompatibel und können nicht zugeordnet werden.
Überprüfen Sie, dass Ihre Attributzuordnungen kompatibel sind, und passen Sie sie bei Bedarf an.
Webhook erstellen
In Schritt vier des Konfigurationsassistenten müssen Sie einen Webhook in Greenhouse erstellen. Befolgen Sie diese Schritte:
- Kopieren Sie im Personio Konfigurationsassistenten die Endpunkt-URL. Sie müssen sie im nächsten Schritt in Greenhouse eingeben.
- Gehen Sie in Greenhouse zu Konfigurieren > Dev Center > Webhooks > Neuen Webhook erstellen.
- Füllen Sie die folgende Felder aus:
- Name: Geben Sie einen beschreibenden Namen für den Webhook ein. Wir empfehlen „Personio Integration“.
- Wann: Bewerbende Person wurde eingestellt.
- Endpunkt-URL: Fügen Sie die URL ein, die Sie aus dem Personio Konfigurationsassistenten kopiert haben.
- Geheimschlüssel: Ein einzigartiger Schlüssel Ihrer Wahl.
- Zugeordneter Partner: Wählen Sie Personio.
- Deaktiviert? Belassen Sie diese Einstellung vorerst auf Ja. Sobald Sie die verbleibenden Schritte in Personio abgeschlossen haben, müssen Sie sie ändern, um den Webhook zu aktivieren.
- Klicken Sie auf Webhook erstellen.
- Kehren Sie zu Personio zurück und klicken Sie auf Fertigstellen.
- Kehren Sie zu Greenhouse zurück, suchen Sie den Webhook, den Sie erstellt haben, und ändern Sie Deaktiviert von Ja auf Nein, um ihn zu aktivieren.