Zum Inhalt springen
PynPyn

Ashby

Die Ashby-Integration liest Kandidatinnen und Kandidaten mit einer Bewerbung im Status „hired“ und einem gültigen Angebot mit Startdatum (ein angenommenes Angebot wird bevorzugt) und legt sie als künftige Mitarbeitende an, mit Startdatum, Jobtitel, Abteilung, Standort und Hiring Manager. Ein Pre-Boarding-Flow mit Trigger auf das Startdatum kann sie dann unter einer privaten Adresse erreichen, bevor ihr Arbeitskonto existiert.

  • Du bist Admin oder Owner in Pyn.
  • Ein Ashby-Admin erstellt unter Admin > API Keys einen API-Schlüssel mit Lesezugriff auf Candidates, Offers und Organization. Lesezugriff auf Jobs ist optional und übernimmt den am Job statt an der Bewerbung gesetzten Hiring Manager. Um Neueinstellungen für vertrauliche Jobs einzuschließen, erlaube zusätzlich den Zugriff auf vertrauliche Jobs und Projekte.
The Connect to Ashby dialog with the API Key field and the note on required read access.
Connect to Ashby asks for an API Key.
  1. Öffne in Pyn Settings in der linken Navigation, dann Available unter Integrations.

  2. Wähle die Kachel Ashby. Der Dialog Connect to Ashby öffnet sich.

  3. Füge den API Key ein.

  4. Wähle Connect. Der Dialog zeigt „Validating that API key…“, während Pyn ihn prüft.

  5. Bei Erfolg lautet die Meldung „Your Ashby integration has been added to Pyn. It will take a minute or two for candidate data to be pulled from Ashby.“

Fehler, die der Dialog zeigen kann: „Could not verify that API key — it appears to be invalid or deactivated.“ / „The API key is valid but lacks the permissions needed. Grant it read access to Candidates, Offers and Organization and try again.“ / „Enter an Ashby API key.“ / „An unexpected error occurred. Please check the API key and try again. If the error persists, contact support.“

Pyn aktualisiert etwa einmal pro Stunde aus Ashby. Für jede Bewerbung im Status „hired“ liest es:

Pyn-Eigenschaft Aus Ashby
Anzeigename, rechtlicher Name Der Name der Kandidatin oder des Kandidaten
Geschäftliche E-Mail, private E-Mail Die geschäftlichen und privaten Kontakt-E-Mails
Startdatum Das Startdatum der neuesten Angebotsversion
Jobtitel Der Job der Bewerbung
Abteilung, Standort Die Namen von Abteilung und Standort des Jobs
Führungskraft Der Hiring Manager des Jobs (ein Ashby-User)
Zeitzone Die Zeitzone der Kandidatin oder des Kandidaten
Eigene Felder Jede Workspace-Erweiterung, die auf ein eigenes Ashby-Feld abgebildet ist, gelesen aus dem Angebot, dann der Bewerbung, dann der Person

Neueinstellungen erscheinen im Directory bis zu ihrem Startdatum als Upcoming. Siehe Synchronisierungsrhythmus und Abgleich dafür, wie sie dem später eintreffenden HRIS-Datensatz zugeordnet werden.

Öffne nach der ersten Aktualisierung Employees und wähle die Ansicht Upcoming: Aktuelle Neueinstellungen sollten mit ihrem Startdatum aufgeführt sein. Der Tab History der Integration zeigt jede Aktualisierung.

  • Reconnect im Menü … öffnet Reconnect to Ashby, um einen neuen Schlüssel einzufügen. „Your Ashby integration has been updated.“ bestätigt es.
  • Deactivate pausiert die Synchronisierung; Activate setzt sie fort.
Was du siehst Was es bedeutet
History: „Error: Authentication failed, please reconnect“ Der Schlüssel wurde in Ashby deaktiviert. Erstelle einen neuen und verbinde neu.
History: „Error: Insufficient Ashby permissions“ Dem Schlüssel fehlt ein Lese-Scope. Erlaube Candidates, Offers und Organization.
Eine Neueinstellung fehlt Das Angebot wurde abgelehnt, storniert oder zurückgezogen, hat kein Startdatum, oder der Job ist vertraulich und der Schlüssel kann ihn nicht sehen.
Hiring Manager leer Erlaube Lesezugriff auf Jobs oder setze den Hiring Manager an der Bewerbung.