Starhunter n8n Node - Übersicht aller verfügbaren Aktionen

Überblick

Der Starhunter n8n Node bietet 7 Ressourcen-Kategorien mit insgesamt 13 Operationen, mit denen Sie Ihre Recruiting-Prozesse automatisieren können. Diese Übersicht erklärt jede Aktion mit praktischen Anwendungsfällen.

1. Person (Kontakte)

Verwalten Sie Personen-Stammdaten in Starhunter.

Get Birthdays - Geburtstage abrufen

Was macht diese Aktion?
Ruft alle Personen ab, die an einem bestimmten Datum Geburtstag haben.

Anwendungsfall:

• Automatische Geburtstags-E-Mails an Kandidaten und Mitarbeiter versenden
• Tägliche Slack-Benachrichtigung mit heutigen Geburtstagen
• Monatliche Geburtstags-Liste für das Team erstellen

Parameter:

• Use Today (Pflicht): Wenn aktiviert, werden heutige Geburtstage abgerufen
• Date (Optional): Alternatives Datum im Format MM-DD (z.B. "12-24" für 24. Dezember)

Get by ID - Person anhand ID abrufen

Was macht diese Aktion?
Ruft die vollständigen Daten einer einzelnen Person anhand ihrer Starhunter-ID ab.

Parameter:

• Person ID (Pflicht): Die eindeutige ID der Person in Starhunter

Search - Personen suchen

Was macht diese Aktion?
Durchsucht die Datenbank nach Personen anhand ihres Namens.

Parameter:

• Name (Pflicht): Suchbegriff (Teilstring-Suche möglich)
• Limit (Optional): Maximale Anzahl Ergebnisse (Standard: 50)
• Offset (Optional): Ab welchem Ergebnis starten (für Pagination)

2. Candidate (Kandidaten)

Search - Kandidaten suchen

Was macht diese Aktion?
Sucht nach Kandidaten anhand verschiedener Kriterien und liefert auch die Kontakthistorie.

Parameter:

• Candidate ID (Optional): Direkte Suche nach ID
• Name (Optional): Suche nach Vor- oder Nachname
• Limit (Optional): Maximale Anzahl Ergebnisse
• Offset (Optional): Startpunkt für Pagination

Hinweis: Mindestens ein Suchkriterium muss angegeben werden.

3. Employee (Mitarbeiter)

Get Current - Aktuellen Benutzer abrufen

Was macht diese Aktion?
Ruft den Mitarbeiter-Datensatz des Benutzers ab, dessen API-Token verwendet wird.

Anwendungsfall:

• Workflows personalisieren ("Diese Aktion wurde ausgeführt von...")
• Automatische Signaturen oder Absender-Infos generieren

Search - Mitarbeiter suchen

Parameter:

• Employee ID (Optional): Direkte Suche nach ID
• Name (Optional): Suche nach Name

4. Email (E-Mail-Protokollierung)

Log - E-Mail protokollieren

Was macht diese Aktion?
Speichert eine E-Mail-Aktivität in der Starhunter-Historie, sodass sie im CRM nachvollziehbar ist.

Anwendungsfall:

• Alle über n8n versendeten E-Mails automatisch in Starhunter dokumentieren
• E-Mail-Kommunikation mit Kandidaten nachverfolgen
• Vollständige Kontakthistorie pflegen

Parameter:

• From (Pflicht): Absender-E-Mail-Adresse
• To (Pflicht): Empfänger-E-Mail-Adresse
• Subject (Pflicht): E-Mail-Betreff
• Body (Pflicht): E-Mail-Inhalt (Text oder HTML)

Tipp: Nutzen Sie Expressions {{ $json.from }} um Daten aus vorherigen Nodes zu verwenden.

5. Project (Projekte)

Search - Projekte suchen

Parameter:

• Status (Optional): Projekt-Status
• Limit (Optional): Maximale Anzahl Ergebnisse
• Offset (Optional): Startpunkt für Pagination

6. Project Candidate (Projekt-Kandidaten)

Die wichtigste Ressource für Recruiting-Automatisierung.

Add - Kandidat zu Projekt hinzufügen

Was macht diese Aktion?
Fügt einen Kandidaten zu einem Projekt hinzu (= Bewerbung anlegen).

Anwendungsfall:

• Eingehende Bewerbungen aus externen Quellen automatisch anlegen
• Kandidaten aus Talent-Pools zu neuen Projekten hinzufügen
• Massenzuordnung von Kandidaten zu Projekten

Parameter:

• Project ID (Pflicht): ID des Projekts
• Candidate ID (Pflicht): ID des Kandidaten
• Presentation Status (Optional): Initialer Status
• Comment (Optional): Notiz zur Zuordnung

Get By Status Change Date - Nach Status-Änderungsdatum abrufen

Was macht diese Aktion?
Ruft alle Projekt-Kandidaten ab, deren Status sich vor X Tagen geändert hat.

Anwendungsfall:

• Follow-up-Erinnerungen: "Kandidaten seit 7 Tagen im Status 'Interview geplant'"
• Automatische Eskalation bei zu langer Bearbeitungszeit
• Reporting: "Wie viele Kandidaten wurden letzte Woche abgelehnt?"

Parameter:

• Status (Pflicht): Der zu prüfende Status
• Days Ago (Pflicht): Anzahl Tage zurück (z.B. 7 = "vor 7 Tagen")
• Limit (Optional): Maximale Anzahl Ergebnisse

? Tipp: Ideal für SLA-Monitoring und automatische Erinnerungen.

Update Status - Status aktualisieren

Was macht diese Aktion?
Ändert den Präsentations-Status eines Kandidaten in einem Projekt.

Parameter:

• Project Candidate ID (Pflicht): ID der Projekt-Kandidaten-Zuordnung
• Presentation Status (Pflicht): Neuer Status
• Comment (Optional): Kommentar zur Status-Änderung

7. Task (Aufgaben)

Create - Aufgabe erstellen

Was macht diese Aktion?
Legt eine neue Aufgabe in Starhunter an.

Anwendungsfall:

• Automatische Erinnerungen für Recruiter erstellen
• Follow-up-Aufgaben nach bestimmten Events anlegen
• Onboarding-Checklisten automatisch generieren

Parameter:

• Title (Pflicht): Aufgabentitel
• Description (Optional): Detaillierte Beschreibung
• Deadline (Optional): Fälligkeitsdatum (Format: YYYY-MM-DD)
• Assignee ID (Optional): ID des zuständigen Mitarbeiters
• Target Entity Type (Optional): Typ der Ziel-Entität
• Target Entity ID (Optional): ID der Ziel-Entität

Beliebte Workflow-Ideen

Automatische Geburtstags-Grüße

Schedule Trigger (täglich 8 Uhr)
  → Starhunter: Get Birthdays (heute)
  → Loop über Ergebnisse
    → Gmail: Geburtstags-E-Mail senden
    → Starhunter: Log Email

E-Mail-Tracking

Gmail Trigger: E-Mail gesendet
  → Filter: An Kandidaten?
  → Starhunter: Log Email

Follow-up Erinnerungen

Schedule Trigger (jeden Montag)
  → Starhunter: Get By Status Change Date
    Status = "Interview geplant"
    Days Ago = 14
  → Starhunter: Create Task (Follow-up)
  → Slack: Benachrichtigung

Status-Synchronisation

Webhook: Event aus Video-Interview-Tool
  → Starhunter: Search Candidate
  → Starhunter: Update Status
  → Gmail: Bestätigung an Kandidat
  → Starhunter: Log Email

Best Practices

✅ Empfehlungen

1. Immer E-Mails loggen: Nutzen Sie "Email Log" nach jedem E-Mail-Versand für vollständige Nachvollziehbarkeit
2. Fehlerbehandlung: Nutzen Sie n8n Error Triggers, um bei Problemen benachrichtigt zu werden
3. Duplikate vermeiden: Suchen Sie vor dem Anlegen immer erst nach existierenden Datensätzen
4. Pagination beachten: Bei großen Datenmengen nutzen Sie Limit/Offset für mehrere Durchläufe
5. Status-Namen prüfen: Achten Sie auf exakte Schreibweise der Status-Namen (Groß-/Kleinschreibung)

Häufig gestellte Fragen (FAQ)

❓ Kann ich mehrere Kandidaten gleichzeitig zu einem Projekt hinzufügen?

Ja, nutzen Sie einen Loop-Node, um über eine Liste von Kandidaten zu iterieren und jeden einzeln hinzuzufügen.

❓ Wie finde ich die ID eines Kandidaten/Projekts?

Nutzen Sie die entsprechende Search-Operation. Die ID ist in den Rückgabedaten enthalten.

❓ Was passiert, wenn ein Kandidat bereits in einem Projekt ist?

Die "Add to Project" Operation gibt einen Fehler zurück. Prüfen Sie vorher, ob der Kandidat bereits zugeordnet ist.

❓ Kann ich E-Mails mit Anhängen protokollieren?

Die "Log Email" Operation speichert derzeit nur Text-Inhalte. Anhänge müssen separat in Starhunter hochgeladen werden.

❓ Wie viele Anfragen kann ich pro Minute machen?

Es gibt Standard-Rate-Limits. Bei sehr häufigen Anfragen implementieren Sie Delays zwischen Operationen.

❓ Funktioniert der Node auch mit Starhunter On-Premise?

Ja, geben Sie einfach die URL Ihrer On-Premise-Instanz als Base URL an.

Technische Details

• API-Typ: GraphQL
• Authentifizierung: Bearer Token
• Endpoint: {baseUrl}/Api/graphql
• Package Version: 0.2.1
• n8n API Version: 1

Nächste Schritte

• Probieren Sie die verschiedenen Operationen aus
• Erstellen Sie Ihren ersten eigenen Workflow
• Lesen Sie die Einrichtungsanleitung, falls noch nicht geschehen
• Besuchen Sie die offizielle n8n Dokumentation

Brauchen Sie Hilfe?

• Lesen Sie die n8n Community-Beiträge
• Melden Sie Bugs auf GitHub