In diesem Artikel erklären wir, wie Sie die Integration von Greenhouse mit Personio einrichten. Nach erfolgter Einrichtung werden neue Mitarbeitende automatisch in Personio angelegt, sobald der Status einer bewerbenden Person in Greenhouse als Eingestellt markiert ist. Die Integration ermöglicht die Synchronisation bestimmter Attribute in Personio und Greenhouse, sodass Personio die entsprechenden Informationen in Ihren Account importieren kann.

Voraussetzungen für eine erfolgreiche Integration

Stellen Sie vor der Integration sicher, 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.
• Damit Daten erfolgreich ausgetauscht werden können, werden die Attribute Vorname, Nachname und E-Mail-Adresse in Greenhouse befüllt.

Greenhouse verbinden und authentifizieren

Richten Sie die Greenhouse-Integration mit dem Konfigurationsassistenten direkt im Personio-Marketplace ein. Dazu müssen Sie in Greenhouse einen API-Schlüssel generieren, den Sie dann in Personio eingeben. Befolgen Sie diese Schritte:

1. Gehen Sie in Personio zum Marketplace, suchen Sie nach der Greenhouse-Integration und wählen Sie diese aus.
2. Klicken Sie auf Verbinden, um den Konfigurationsassistenten zu öffnen.
3. Melden Sie sich in Ihrem Greenhouse-Account an.
4. Erstellen Sie im Bereich zur Verwaltung der Greenhouse-API-Anmeldedaten einen API-Schlüssel. Diese Schritte werden in Schritt eins des Konfigurationsassistenten in Personio beschrieben.
5. Geben Sie den API-Schlüssel nach der Erstellung in das Textfeld Greenhouse API-Schlüssel im Personio-Konfigurationsassistenten ein.
6. Klicken Sie auf Weiter, um zu Schritt zwei des Konfigurationsassistenten zu gelangen und Personio zu authentifizieren.

Hinweis:
Speichern Sie den Greenhouse API-Key sicher ab. Wenn Sie ihn verlieren, müssen Sie einen neuen erstellen.

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:

1. Überprüfen Sie die Berechtigungen, die für die Greenhouse-Integration erforderlich sind.
2. Klicken Sie auf Weiter, um mit Schritt drei des Konfigurationsassistenten und Zuordnung der Attribute fortzufahren.

Tipp:
Sie können die gewährten Berechtigungen nach dem Setup-Prozess überprüfen, indem Sie zu Einstellungen > Sicherheit & Integrationen > API-Zugriffsdaten gehen und die Greenhouse-Integration auswählen.

Attribute zuordnen

Im dritten Schritt der Konfiguration können Sie auswählen, welche Greenhouse-Attribute mit Personio synchronisiert bzw. abgeglichen werden sollen. Befolgen Sie diese Schritte:

1. Überprüfen Sie alle Attribute und stellen Sie sicher, dass jedes Personio-Attribut dem entsprechenden Greenhouse-Attribut entspricht.
2. Klicken Sie auf Attribut hinzufügen, um weitere Attribute hinzuzufügen.
3. Klicken Sie auf Weiter , um mit Schritt vier des Konfigurationsassistenten, Web-Hook erstellen, fortzufahren.

Hinweis:
Wenn Sie Attribute vom Typ Auswahlliste zuordnen, stellen Sie sicher, 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 dies 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 ein Personio-Datumsattribut nicht direkt einem Greenhouse-Datumsattribut zugeordnet ist, werden die Daten möglicherweise nicht korrekt übertragen.
• Währungs-/Vergütungsattribute: Greenhouse kombiniert Wert und Währungstyp in einem Feld. Diese kombinierten Felder können nicht den separaten Währungsfeldern von Personio zugeordnet werden.
• 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 Ihre Attributzuordnungen, um die Kompatibilität sicherzustellen, und passen Sie sie bei Bedarf an.

Webhook erstellen

In Schritt vier des Konfigurationsassistenten müssen Sie einen Webhook erstellen. Gehen Sie wie folgt vor, um einen Webhook zu erstellen:

1. Gehen Sie zurück zum Bereich Web Hooks im Greenhouse Dev Center und folgen Sie der Anleitung auf der Greenhouse-Seite.
2. Lesen Sie außerdem die im Konfigurationsassistenten von Personio beschriebenen Schritte.
3. Geben Sie die Endpunkt-URL in Greenhouse ein, indem Sie im Konfigurationsassistenten unterhalb der Schritte auf den Button Link kopieren klicken. Fügen Sie den Link in das Feld Endpoint URL ein. 
4. Folgen Sie den Schritten des Konfigurationsassistenten, um die Erstellung des Webhook abzuschließen.
5. Klicken Sie auf Fertigstellen. 
6. Gehen Sie zurück zum Greenhouse Dev Center, und aktivieren Sie den Webhook.
   • Klicken Sie unter Edit Web Hook auf das Stiftsymbol neben dem Web Hook, den Sie aktivieren möchten.
   • Unter Deaktiviert?, wählen Sie Nein.
   • Klicken Sie auf Webhook aktualisieren.

Die Einrichtung der Integration ist abgeschlossen.

Hinweis:
Wenn Sie die Greenhouse Integration reaktivieren, müssen Sie einen neuen Webhook erstellen. Der zuvor verwendete Webhook funktioniert nicht mehr.