1. Home
  2. FAQ
  3. Wie kann ich Greenhouse integrieren?

Wie kann ich Greenhouse integrieren?

Antwort

Um Greenhouse in JOIN zu integrieren, benötigen Sie eine User-ID, ein API-Token und die Subdomain Ihrer Greenhouse-Karriereseite.

Um alle erforderlichen Informationen zu sammeln, folgen Sie bitte der nachstehenden Schritt-für-Schritt-Anleitung.

Greenhouse-Integration in 5 Schritten

Die Integration von Greenhouse mit JOIN erfordert nur fünf einfache Schritte. Wir haben den Prozess für Sie zusammengefasst, um ihn so einfach wie möglich zu halten. 

Außerdem haben wir eine Diashow am Ende dieser Seite hinzugefügt, um den Workflow in Greenhouse für Sie noch besser zu veranschaulichen.

Schritt 1: Nutzerrechte in Greenhouse überprüfen

Vergewissern Sie sich vor der Erstellung des erforderlichen API-Tokens, dass Sie über „Site Admin“-Rechte verfügen. Das ist unter anderem notwendig, um Ihre Benutzer-ID abzurufen, die später in JOIN benötigt wird.

Möglicherweise müssen Sie zuerst die Benutzerberechtigungen in Greenhouse konfigurieren.

  1. Klicken Sie oben rechts auf das Zahnrad-Symbol und wählen Sie anschließend Benutzer > Ihr Name aus.

  2. Unten auf der Seite finden Sie den Bereich „Permissions“. Prüfen Sie hier, ob Sie bereits über die erforderlichen „Site Admin“-Rechte verfügen.

Sollte das nicht der Fall sein, wenden Sie sich bitte an jemanden in Ihrem Team, der über Site-Admin-Rechte verfügt, und bitten Sie ihn, Ihnen ebenfalls solche zu erteilen.

Schritt 2: User-ID in Greenhouse abfragen

Nun, da Sie die erforderlichen Administratorrechte besitzen, ist es an der Zeit, Ihre User-ID abzurufen. Das können Sie in zwei einfachen Schritten tun:

  1. Rufen Sie über das Zahnrad den Menüpunkt Konfigurieren > Benutzer aus und klicken Sie oben rechts in der Benutzerübersicht „Export to Excel“.
  2. In der Tabellenkalkulation finden Sie Ihre persönliche Benutzer-ID in der ersten Spalte links mit dem Titel „User ID“.

Die User-ID muss später in JOIN unter „ATS-Kennung“ hinterlegt werden.

Schritt 3: API-Schlüssel in Greenhouse erstellen

Als Nächstes müssen Sie einen sogenannten „Harvest API“-Schlüssel in Greenhouse erstellen. Das erreichen Sie mit den folgenden Schritten:

  1. Rufen Sie Konfigurieren > Dev Center > API Credentials auf.
  2. Klicken Sie auf „Create New API Key“, um den erforderlichen „Harvest API“-Schlüssel zu generieren. Es öffnet sich ein kleines Fenster.
  3. Wählen Sie „Harvest“ als API Type aus.
  4. Hinterlegen Sie join.com als Partner.
  5. Klicken Sie „Manage Permissions“ an.
  6. Setzen Sie einen Haken in die Boxen Applications, Candidates, Custom Fields und Sources.
  7. Klicken Sie „Save“ und anschließend im geöffneten Dialogfenster „Copy“.
  8. Fügen Sie den API-Schlüssel in ein Dokument ein und speichern Sie es an einem sicheren Ort.
  9. Klicken Sie dann auf „I have stored the API Key“.

Ihr API-Schlüssel für die Greenhouse-Integration in JOIN ist einsatzbereit!

Schritt 4: Custom Candidate Field erstellen (Optional)

Möchten Sie, dass die ursprüngliche Quelle (z.B. LinkedIn, Indeed) Ihrer Bewerber:innen in Greenhouse angezeigt wird? Folgen Sie diesen Schritten, um ein Custom Candidate Field als Sekundärquelle zu erstellen:

  1. Rufen Sie den Menüpunkt Configure > Custom Options > Company Custom Fields > Candidates auf.
  2. Klicken Sie rechts auf „Add Field“.
  3. Geben Sie dem benutzerdefinierten Feld einen Namen (z. B. JOIN Quelle Original)
  4. Wählen Sie im Dropdown-Menü Field Type „Short textbox“ aus.
  5. Klicken Sie unten rechts „Save“.
  6. Kopieren Sie den automatisch generierten „Immutable Field Key“ unten auf der Seite.

Nun sind alle Schlüssel und Informationen, die Sie von Greenhouse benötigen, vorbereitet und im nächsten Schritt müssen Sie nur noch die Integration in Ihrem JOIN Dashboard aktivieren.

Schritt 5: Integrationsdaten in JOIN hinterlegen 

Fast geschafft! Der letzte Schritt ist das Hinterlegen Ihrer User-ID, Ihres API-Schlüssels, Ihrer alternativen Quelle und Ihrer Subdomain in Ihrem JOIN-Konto:

  1. Melden Sie sich an und rufen Sie links den Menüpunkt Einstellungen > Integrationen auf.
  2. Wählen Sie anschließend in der Übersicht Greenhouse aus.
  3. Fügen Sie unter Subdomäne die Subdomain Ihrer Greenhouse Karriereseite ein.
  4. Hinterlegen Sie bei ATS-Kennung Ihre User-ID, die Sie aus Greenhouse exportiert haben.
  5. Fügen Sie unter API-Schlüssel die Harvest API ein, die Sie in Greenhouse erstellt haben.
  6. Um die Quelle der Bewerbungen zu sehen, fügen Sie unter Name der Jobbörse den Immutable Field Key aus Greenhouse ein.
  7. Klicken Sie oben rechts auf „Anfragen“.

Herzlichen Glückwunsch, Sie haben es geschafft! Die Integration sollte innerhalb eines Werktags freigeschaltet werden.

Diashow zur Greenhouse-Integration

Sie wünschen sich visuelle Unterstützung für die Integration von Greenhouse? Sehen Sie sich unsere praktische Diashow an:

Greenhouse integrieren nutzerrechte abfragen
Greenhouse integrieren user ansicht
Greenhouse integrieren user id abfragen
Spreadsheet Screenshot showing where to find greenhouse user id
Greenhouse integrieren dev center api credentials
Greenhouse integrieren harvest api erstellen
Greenhouse integrieren harvest api fenster
Greenhouse integrieren harvest api berechtigungen
Greenhouse integrieren harvest api managen
Greenhouse custom options
Greenhouse integrieren custom candidate field erstellen
Greenhouse integrieren custom candidate field verwalten
Greenhouse integrieren immutable field key

Schritt 1.1: Nutzerrechte aufrufen

Melden Sie sich bei Greenhouse an und klicken Sie oben rechts auf das Zahnrad-Symbol. Klicken Sie dann auf Benutzer > Ihr Name.

Schritt 1.2: Nutzerrechte überprüfen

Prüfen Sie im Bereich Permissions unten auf der Seite, ob Sie bereits Site Admin-Rechte besitzen.

Sollten Sie diese nicht besitzen, bitten Sie bitte jemanden in Ihrem Team, der über solche verfügt, Ihnen diese ebenfalls zuzuweisen.

Schritt 2.1: User-ID aus Greenhouse exportieren

Um Ihre User-ID aus Greenhouse abzurufen, rufen Sie Konfigurieren > Benutzer auf und klicken Sie Export to Excel.

Schritt 2.2: User-ID aus Excel-Tabelle ablesen

In der Tabellenkalkulation finden Sie Ihre persönliche User-ID in der linken Spalte mit dem Titel „User ID“ (10 Ziffern).

Schritt 3.1: Dev Center aufrufen

Zeit, den API-Schlüssel für Ihre Greenhouse-Integration zu erstellen!

Klicken Sie auf das Zahnrad-Symbol oben rechts, um zum Menüpunkt Konfigurieren > Dev Center > API Credentials zu gelangen.

Schritt 3.2: Neuen API-Schlüssel erstellen

Klicken Sie Create New API Key, um den erforderlichen „Harvest API“-Schlüssel zu generieren.

Es sollte sich ein Dialogfenster öffnen.

Schritt 3.3 - 3.5: API-Schlüssel erstellen

Im neuen Fenster gehen Sie wie folgt vor:

• Wählen Sie Harvest im Dropdown-Menü Type aus.
• Wählen Sie join.com im Dropdown-Menü Partner aus.
• Klicken Sie auf Manage Permissions.

Schritt 3.6: Berechtigungen des API-Schlüssels verwalten

Sie werden auf eine neue Seite geleitet, auf der Sie Ihrem neuen API-Schlüssel Berechtigungen zuweisen können.

Aktivieren Sie die Kästchen für Applications, Candidates, Custom Fields und Sources und klicken Sie auf Save, um zu speichern.

Schritt 3.7: Harvest API kopieren

In dem sich öffnenden Dialogfeld erhalten Sie die Möglichkeit, den API-Schlüssel zu kopieren und in einem Dokument abzuspeichern.

Klicken Sie Copy und speichern Sie ihn an einem sicheren Ort ab!

Wenn Sie fertig sind, klicken Sie auf den roten Button mit der Aufschrift I have stored the API Key.

Schritt 4.1: Custom Field Options aufrufen

Um die Originalquelle Ihrer Bewerber:innen in Greenhouse sichtbar zu machen, müssen Sie ein sogenanntes Custom Candidate Field erstellen.

Rufen Sie hierzu den Menüpunkt Configure > Custom Options > Company Custom Fields > Candidates auf.

Schritt 4.2: Candidate Field hinzufügen

Klicken Sie rechts oben auf Add Field. Sie werden auf eine neue Seite weitergeleitet, auf der Sie einen Feldnamen und einen Feldtyp angeben können.

Schritt 4.3 - 4.5: Custom Candidate Field konfigurieren

Geben Sie Ihrem Custom Candidate Field einen Namen (z. B. JOIN Quelle Original), und wählen Sie anschließend Short textbox im Dropdown-Menü Type aus. Klicken Sie dann Save.

Schritt 4.6: Immutable Field Key kopieren

Unten auf der Seite finden Sie den neuen, automatisch generierten Immutable Field Key. Kopieren Sie den Inhalt des Feldes.

Jetzt ist es an der Zeit, alles in Ihrem JOIN-Konto zu hinterlegen!

Autor

Sarah Heßler

Aktualisiert 01/09/23