Zum Hauptinhalt springen

Native HR-Tool-Integrationen von Spendesk

Verbinden Sie Spendesk mit Ihrem HR-Tool, um Konten von Mitarbeitenden automatisch zu erstellen, zu aktualisieren und zu archivieren, wenn sich ihre Daten in Ihrem HR-System ändern. Dadurch entfällt die manuelle Verwaltung von Mitgliedern.

Für: Kontoinhaber:innen und Administrator:innen mit Scale- oder Premium-Tarif

Bevor Sie beginnen

  • Plan: Nur auf den Plänen Scale und Premium verfügbar.

  • Rolle: Sie benötigen in Spendesk die Rolle Kontoinhaber:in oder Administrator:in, um die Integration einzurichten und zu verwalten.

  • Zugriff auf das HR-Tool: Sie benötigen Admin-Zugriff auf Ihr HR-Tool, um API-Schlüssel oder Zugangsdaten zu generieren.

  • E-Mail-Format: Mitarbeitende in Ihrem HR-Tool müssen eine berufliche oder geschäftliche E-Mail-Adresse verwenden. Spendesk gleicht Datensätze aus dem HR-Tool anhand dieser E-Mail-Adresse mit Spendesk-Konten ab.

  • Mehrere Entitäten: Wenn Sie über mehrere Spendesk-Entitäten, also juristische Gesellschaften, verfügen, wiederholen Sie alle folgenden Schritte für jede Entität.

🔒 Zugriff: Diese Funktion ist nur auf den Plänen Scale und Premium verfügbar.

Schritt 1: Verbinden Sie Ihr HR-Tool

  1. Navigieren Sie zu Einstellungen > Integrationen.

  2. Wählen Sie Ihr HR-Tool aus der Liste aus.

  3. Klicken Sie auf Verbinden.

  4. Prüfen Sie, auf welche Daten Spendesk zugreifen wird.

  5. Geben Sie die Authentifizierungsdaten für Ihr HR-Tool ein, zum Beispiel den API-Schlüssel oder entsprechende Zugangsdaten.

  6. Bestätigen Sie die Verbindung.

Einige HR-Tools erfordern vor der Verbindung zusätzliche Vorbereitungsschritte.

Führen Sie zunächst die entsprechenden Schritte in der folgenden Tabelle aus.

HR-Tool

Vor der Verbindung erforderliche Schritte

Personio

Ermitteln Sie die Subdomain aus Ihrer Personio-URL, zum Beispiel https://subdomain.personio.de. Öffnen Sie als Personio-Administrator:in die Marketplace-Seite und klicken Sie oben rechts auf „Connect“. Wählen Sie „Generate new API credential“ und bestätigen Sie. Kopieren Sie die generierte Client ID und das Client Secret in den Spendesk-Verbindungsdialog.

BambooHR

Ermitteln Sie die Subdomain aus Ihrer BambooHR-URL, zum Beispiel https://subdomain.bamboohr.com. Erstellen und rufen Sie als BambooHR-Administrator:in in BambooHR einen API-Schlüssel ab.

HiBob

Erstellen Sie in HiBob einen Service User unter Settings > Integrations > Service Users. Wählen Sie „New Service User“ und geben Sie einen Namen ein, zum Beispiel „Spendesk Integration“. Notieren Sie die ID und das Token, die Sie erhalten. Erstellen Sie anschließend unter Settings > Account > Permission Groups eine neue Permission Group, geben Sie ihr einen Namen und legen Sie im Tab „People's Data“ die erforderlichen Berechtigungen fest, wie im Spendesk-Verbindungsdialog angegeben. Fügen Sie Ihren Service User dieser Permission Group hinzu. Kehren Sie zu Spendesk zurück, um die Verbindung abzuschließen.

Workday

Melden Sie sich als Administrator:in bei Workday an und suchen Sie nach „View API Clients“. Notieren Sie den Workday REST API Endpoint. Suchen Sie anschließend nach „Create Integration System User“ und legen Sie einen Benutzernamen sowie ein Passwort fest. Richten Sie die erforderlichen Berechtigungen ein.

Deel

Bestätigen Sie im Bildschirm Organization Settings, dass Ihr Konto die Rolle Organization Admin hat.

PayFit

Folgen Sie als PayFit-Administrator:in dem Verbindungsprozess im Produkt und autorisieren Sie die Verbindung mit Ihrem PayFit-Konto.

Lucca HR

Ermitteln Sie Ihre Lucca-Domain aus Ihrer URL, zum Beispiel „example“ in https://example.ilucca.net. Melden Sie sich als Administrator:in bei Lucca an und klicken Sie oben rechts auf das Zahnradsymbol. Gehen Sie zu „Authentication, SSO and API“ > „API Keys“. Klicken Sie auf „Generate API Key“ und geben Sie einen Namen ein, zum Beispiel „Spendesk Integration“. Kopieren Sie den generierten Schlüssel. Kehren Sie zu Spendesk zurück und geben Sie die Domain sowie den API-Schlüssel ein, um die Verbindung abzuschließen.

💡 Tipp: Wenn Ihr HR-Tool nicht in der obigen Tabelle aufgeführt ist, prüfen Sie die Verbindungsanleitungen für andere unterstützte Tools oder wenden Sie sich an den Spendesk-Support.

Sobald die Verbindung erfolgreich hergestellt wurde, kehren Sie zum Bildschirm Integrationen zurück. Spendesk startet anschließend eine erste Synchronisierung. Diese Synchronisierung ruft nur Daten ab, sie nimmt in Spendesk noch keine Änderungen vor. Nach Abschluss der Synchronisierung zeigt der Integrationsstatus Aktionen ausstehend an.

Schritt 2: Konfigurieren Sie die Integration

  1. Navigieren Sie zu Einstellungen > Integrationen.

  2. Klicken Sie auf die Integrationskarte Ihres HR-Tools, die den Status Aktionen ausstehend anzeigt.

  3. Wählen Sie Alle Mitarbeitenden oder Benutzerdefinierter Filter, um festzulegen, welche Mitarbeitenden von Spendesk verwaltet werden sollen.

  4. Wenn Sie Benutzerdefinierter Filter auswählen, wählen Sie in den Dropdown-Menüs die gewünschten Filterwerte aus, zum Beispiel Arbeitsort oder Abteilung. Damit legen Sie fest, welche Mitarbeitenden mit dieser Entität synchronisiert werden sollen.

  5. Wenn Sie Benutzerdefinierter Filter verwenden und möchten, dass Vorgesetzte automatisch synchronisiert werden, aktivieren Sie Vorgesetzte automatisch einbeziehen. Diese Einstellung ist nicht erforderlich, wenn Sie Alle Mitarbeitenden ausgewählt haben, da die Daten der Vorgesetzten in diesem Fall automatisch synchronisiert werden.

  6. Aktivieren Sie Inaktive Mitarbeitende automatisch entfernen, wenn Spendesk Mitarbeitende archivieren soll, sobald sie in Ihrem HR-Tool inaktiv werden. Diese Einstellung ist standardmäßig deaktiviert.

  7. Klicken Sie auf Speichern und anwenden.

  8. Prüfen Sie die Vorschau. Sie zeigt, welche Mitglieder neu verwaltet, eingeladen oder archiviert werden.

  9. Bestätigen Sie die Änderungen.

⚠️ Warnung: Bestimmte Felder von HR-verwalteten Mitgliedern sind schreibgeschützt. Spendesk betrachtet die Daten des HR-Tools als maßgebliche Quelle. Daher können diese Felder nur in Ihrem HR-Tool bearbeitet werden.

Nach der Bestätigung ändert sich der Integrationsstatus in Verbunden. Die anfängliche Verarbeitungszeit hängt von der Anzahl Ihrer Mitarbeitenden ab.

Schritt 3: Trennen Sie die Integration

  1. Navigieren Sie zu Einstellungen > Integrationen.

  2. Klicken Sie auf die Integrationskarte Ihres HR-Tools.

  3. Klicken Sie auf Trennen.

Durch das Trennen wird verhindert, dass die Integration künftig Mitglieder erstellt oder aktualisiert. Bereits in Spendesk erstellte Mitglieder sind davon nicht betroffen. Um die Integration erneut zu verbinden, wiederholen Sie Schritt 1 und Schritt 2 vollständig.

Erwartete Ergebnisse

Sobald die Verbindung hergestellt ist, sehen Sie folgende Änderungen:

  • Integrationskarte unter Einstellungen > Integrationen: Sie zeigt Verbunden an, wenn die Synchronisierung aktiv ist, oder einen Fehlerstatus, falls ein Verbindungsproblem vorliegt.

  • Seite „Mitglieder“ unter Einstellungen > Mitglieder: Sie zeigt einen Hinweis an, dass Mitglieder aktiv verwaltet werden, sowie eine neue Spalte HR-Status:

    • Grünes Häkchen: Das Mitglied wird aktiv durch die Integration verwaltet.

    • Oranges Warnsymbol: Das Mitglied wurde zuvor verwaltet, entspricht aber nicht mehr Ihren Filtereinstellungen.

    • Leer: Das Mitglied wird manuell verwaltet, die Integration aktualisiert es nicht.

  • Registerkarte „Eingeladen“: Von der Integration eingeladene Mitglieder erscheinen hier, bis sie das Onboarding abgeschlossen haben. Anschließend wechseln sie zur Registerkarte „Aktiv“.

  • Registerkarte „Archiviert“: Mitglieder, die wegen Inaktivität in Ihrem HR-Tool entfernt wurden, erscheinen hier.

👥 Rollen: Nur Kontoinhaber:innen und Administrator:innen können den Status der HR-Integration einsehen und verwalten.

Fehlerbehebung

Symptom: Eine Person erscheint nach der Synchronisierung der Integration nicht in Spendesk.

Ursache: Die E-Mail-Adresse im HR-Tool stimmt nicht exakt mit der E-Mail-Adresse des Spendesk-Kontos überein, häufig nach einer kürzlich erfolgten Änderung der E-Mail-Adresse.

Lösung:

  1. Vergleichen Sie die E-Mail-Adresse der Person in Ihrem HR-Tool und in Spendesk.

  2. Falls die E-Mail-Adressen voneinander abweichen, aktualisieren Sie die E-Mail-Adresse in Spendesk, sodass sie mit der Adresse in Ihrem HR-Tool übereinstimmt.

  3. Wenn Sie die E-Mail-Adresse nicht selbst aktualisieren können, wenden Sie sich an den Spendesk-Support und geben Sie die aktuelle sowie die vorherige E-Mail-Adresse der Person an.

Symptom: Die Integrationskarte zeigt einen Verbindungsfehler an.

Ursache: Der API-Schlüssel oder die Zugangsdaten Ihres HR-Tools sind ungültig oder abgelaufen, oder eine Netzwerk- beziehungsweise Firewall-Regel blockiert die Verbindung.

Lösung:

  1. Prüfen Sie, ob der API-Schlüssel oder die Zugangsdaten in Ihrem HR-Tool noch gültig sind.

  2. Vergewissern Sie sich, dass Ihre Netzwerk- oder Firewall-Einstellungen die Integration nicht blockieren.

  3. Prüfen Sie die genaue Fehlermeldung auf der Integrationskarte.

  4. Wenden Sie sich an den Spendesk-Support, falls das Problem weiterhin besteht.

Symptom: Ein Mitglied muss in mehreren Spendesk-Entitäten vorhanden sein, aber die Synchronisierungsfilter lassen dies nicht zu.

Ursache: Benutzerdefinierte Filter können nicht jede Ausnahme abbilden, zum Beispiel Personen, die in mehreren Entitäten arbeiten.

Lösung:

  1. Identifizieren Sie die betroffenen Mitarbeitenden und vergleichen Sie ihre E-Mail-Adressen in Spendesk und Ihrem HR-Tool.

  2. Wenden Sie sich an den Spendesk-Support oder eine:n Kontoinhaber:in, um die Profildaten manuell abzugleichen.

  3. Vergewissern Sie sich, dass Angaben wie die vorgesetzte Person und die Abteilung in Spendesk mit den Angaben in Ihrem HR-Tool übereinstimmen.

FAQ

Wie oft synchronisiert die Integration Daten?

Spendesk führt alle 6 Stunden eine vollständige Synchronisierung durch. Die meisten Integrationen führen zusätzlich alle 2 Stunden eine Delta-Synchronisierung durch, bei der nur die neuesten Änderungen berücksichtigt werden. Das bedeutet, dass Aktualisierungen oder Entfernungen in Ihrem HR-Tool spätestens nach 6 Stunden, oft aber schneller, in Spendesk erscheinen.

Was passiert, wenn mein HR-Tool in Spendesk nicht verfügbar ist?

Wenn Ihr HR-Tool nicht unter Einstellungen > Integrationen aufgeführt ist, wenden Sie sich an Ihre Ansprechperson beim Spendesk-Support oder reichen Sie über das In-Produkt-Formular auf der Seite Integrationen eine Anfrage ein. Spendesk erweitert die Liste der unterstützten Tools kontinuierlich.

Sie können das HR-Tool auch selbst verbinden: Ihre Entwickler:innen oder Ihr Integrationspartner können Mitglieder, Kostenstellen, Vorgesetzte und Rollen über die Spendesk API synchron halten. Weitere Informationen finden Sie unter Ein nicht aufgeführtes HR-Tool über die Spendesk API verbinden.

Verwandte Artikel

Hat dies deine Frage beantwortet?