TieTalent verbinden mit
Ein TieTalent-API-Key, fünf Schritte. Danach starten Recruiter Candidate Intelligence oder Role Fit aus Pinpoint-Bewerbungen oder Stage Actions und sehen die Ergebnisse auf der Bewerbung.
Video-Transkript
Dieser Walkthrough zeigt, wie Sie unter Developers einen TieTalent-API-Key anlegen, das TieTalent-Plugin in Pinpoint unter Settings, Integrations, My Plugins öffnen, den TieTalent-API-Key einfügen, optional Ihre Pinpoint-Account-URL und einen Pinpoint-API-Key nur mit Lesezugriff auf Application hinterlegen und dann Candidate Intelligence oder Role Fit aus einer Bewerbung oder einer Stage Action starten.
Was Sie brauchen
- Pinpoint Company Manager Zugriff (Integrations und API & Webhooks)
- TieTalent Workspace-Owner, Admin oder Developer (Developers → API keys)
- Etwa 10 Minuten, Pinpoint und TieTalent in zwei Tabs offen
- API-Keys geheim halten. Den TieTalent-Key beim Erstellen einmal kopieren
Fünf Schritte zur Verbindung
- 1
TieTalent-API-Key erstellen
TieTalent → Developers → API keys → Create
Öffnen Sie in TieTalent Developers → API keys und erstellen Sie einen Key. Kopieren Sie den vollständigen Wert einmal (beginnt mit ats_). TieTalent zeigt das vollständige Geheimnis nicht erneut.
- 2
TieTalent in Pinpoint öffnen
Pinpoint → Settings → Integrations → My Plugins → TieTalent → Configure
Öffnen Sie in Pinpoint Settings → Integrations → My Plugins. Finden Sie TieTalent und öffnen Sie Configure. Sie sehen Felder für den TieTalent-API-Key sowie optional Pinpoint-Account-URL und Pinpoint-API-Key.
- 3
TieTalent-API-Key einfügen
Pinpoint → TieTalent Configure → TieTalent API key → Save
Fügen Sie den ats_-Key in TieTalent API key ein und speichern Sie. Ohne gültigen Key zeigt das Aktionsformular eine Setup-Warnung.
- 4
Pinpoint-Account-Zugriff hinzufügen (empfohlen)
Pinpoint → Settings → API & Webhooks → API Keys → dann TieTalent Configure
Aktivieren Sie unter Pinpoint Settings → API & Webhooks die Pinpoint API und erstellen Sie einen API-Key nur mit Application: Read. TieTalent liest über diesen Key nur und ändert nichts in Pinpoint. Fügen Sie in TieTalent Configure Ihre Account-URL (https://yourcompany.pinpointhq.com) und diesen API-Key ein. So liest TieTalent LinkedIn, CV, Berufshistorie und Stellenbeschreibung, und Role Fit kann aus einer Stage Action laufen, ohne dass Sie eine Stellenbeschreibung einfügen.
- 5
Candidate Intelligence oder Role Fit starten
Pinpoint → Bewerbung → ⋯ → Run TieTalent …, oder Stage → Add stage action
Öffnen Sie auf einer Bewerbung das ⋯-Menü und wählen Sie Run TieTalent Candidate Intelligence oder Run TieTalent Role Fit. Oder fügen Sie auf einer Pipeline-Stufe eine Stage Action hinzu, damit der Report automatisch startet, wenn Kandidaten diese Stufe erreichen. Role Fit ohne Pinpoint-Verbindung braucht eine eingefügte Stellenbeschreibung.
Verbindung mit einem Kandidaten bestätigen
Wählen Sie eine echte Bewerbung, möglichst mit CV. Starten Sie Candidate Intelligence oder Role Fit. Role Fit braucht eine Stellenbeschreibung im Formular oder aus dem verbundenen Pinpoint-Job. Wenn der Lauf fertig ist, zeigt das Assessment auf der Bewerbung ein Verdict oder eine Fit-Zusammenfassung, Key Facts und den Link Open TieTalent report. Damit ist die Verbindung bestätigt.
So sieht „fertig“ aus
- Pinpoint My Plugins → TieTalent ist mit gültigem TieTalent-API-Key konfiguriert
- Mindestens ein Assessment gestartet und Ergebnisse auf der Pinpoint-Bewerbung zurückgegeben
- Optionale Pinpoint-API-Verbindung ausgefüllt, wenn LinkedIn, CV und Stellenbeschreibung automatisch gelesen werden sollen
Häufige Probleme
Setup-Warnung zum TieTalent-API-Key
Erstellen Sie unter TieTalent Developers → API keys einen neuen Key, fügen Sie den vollständigen ats_-Wert in Pinpoint Configure ein und speichern Sie. Widerrufene oder vertippte Keys werden abgelehnt.
Ungültige Pinpoint-Account-URL oder Key-Paarung
Verwenden Sie Ihre Anmelde-Adresse, zum Beispiel https://yourcompany.pinpointhq.com. Wenn Sie die URL hinzufügen, müssen Sie auch den Pinpoint-API-Key setzen (oder beides entfernen). Erstellen Sie den Key unter Settings → API & Webhooks nur mit Application: Read.
Role Fit verlangt eine Stellenbeschreibung
Ohne optionale Pinpoint-Verbindung fügen Sie die Stellenbeschreibung in das Formular ein. Mit konfigurierter Verbindung lassen Sie das Feld leer, damit TieTalent die Stelle aus Pinpoint liest.
Nicht genug Credits oder Candidate Intelligence nicht aktiviert
Jeder Lauf verbraucht Credits aus Ihrem TieTalent-Workspace. Reichen sie nicht, startet der Lauf nicht und es wird nichts berechnet; ein TieTalent-Admin kann unter Plans & billing aufladen. Ist Candidate Intelligence für Ihren Workspace nicht aktiviert, kontaktieren Sie TieTalent, um es aktivieren zu lassen.
Assessment startet, Ergebnisse erscheinen nicht in Pinpoint
Reports dauern einige Minuten. Aktualisieren Sie die Bewerbung. Schlägt ein Lauf fehl, zeigt das Assessment den Grund und es werden keine Credits berechnet. Jeder Lauf erscheint außerdem in der TieTalent History unter Candidate Intelligence oder Role Fit, filterbar nach Pinpoint.
TieTalent kann den Kandidaten nicht aus Pinpoint lesen
Das Assessment meldet, dass Pinpoint den API-Key abgelehnt hat. Der Pinpoint-API-Key wurde widerrufen oder hat kein Application: Read. Erstellen Sie einen neuen Key mit Application: Read, fügen Sie ihn in TieTalent Configure ein und starten Sie den Report erneut.
Ein erneuter Lauf liefert denselben Report
Wird derselbe Kandidat innerhalb von 6 Monaten mit denselben Angaben (CV, LinkedIn-Profil und bei Role Fit Stellenbeschreibung) erneut gestartet, liefert TieTalent den bestehenden Report kostenlos. Ändern Sie die Angaben, zum Beispiel mit einem neueren CV, um einen neuen Report zu erhalten.
Bereit zum Verbinden?
Erstellen Sie einen TieTalent-API-Key und konfigurieren Sie TieTalent in Pinpoint My Plugins. Sprechen Sie uns an, wenn Ihr Team einen Walkthrough braucht.