Zum Inhalt springen
KendorDocs

So verbindest du Ashby mit Kendor

Für Eigentümer ·

Erstelle einen Ashby-API-Schlüssel mit den von Kendor genannten Berechtigungen, füge ihn unter Integrationen ein, und Kendor richtet Webhook und Felder ein, soweit der Schlüssel es erlaubt.

Du verbindest Ashby mit einem einzigen API-Schlüssel. Erstelle den Schlüssel in Ashby, füge ihn in Kendor unter Integrationen → Ashby ein, und Kendor prüft seine Berechtigungen, registriert den Webhook und legt seine Felder an der Bewerbung an, soweit der Schlüssel es erlaubt. Eine Checkliste zeigt dann, was erledigt ist und was gegebenenfalls noch von Hand in Ashby zu tun ist.

Bevor du anfängst

  • Deine Organisation hat den Kendor-Tarif, der die Ashby-Integration enthält, und wir haben die Integration gemeinsam mit dir freigeschaltet.
  • Du bist in Kendor Eigentümer. Bearbeiter und Betrachter sehen die Ashby-Karte als Nur Inhaber können Ashby verwalten.
  • Du kannst in den Admin-Einstellungen von Ashby API-Schlüssel erstellen.

Einen API-Schlüssel in Ashby erstellen

Öffne in Ashby Admin → API keys und erstelle einen Schlüssel für Kendor. Kendor listet die benötigten Berechtigungen auf der Ashby-Seite unter 1 · API-Schlüssel in Ashby erstellen auf.

Erforderlich

Berechtigung in Kendor Ashby-Scope Wofür Kendor sie nutzt
Read API keys apiKeys:read Prüft, welche Berechtigungen der Schlüssel hat.
Read jobs jobs:read Listet deine Stellen auf, wenn du Phasenregeln einrichtest.
Read interviews interviews:read Liest den Interviewplan jeder Stelle und seine Phasen.
Read hiring process metadata hiringProcessMetadata:read Liest Phasen und Bewerbungsfelder.
Write candidates candidates:write Schreibt die Kendor-Felder und Notizen.

Damit Kendor sich selbst einrichten kann

Berechtigung in Kendor Ashby-Scope Wofür Kendor sie nutzt
Write API keys apiKeys:write Registriert den Webhook für dich.
Write hiring process metadata hiringProcessMetadata:write Legt die fünf Kendor-Felder für dich an.

Diese beiden sind optional. Ohne sie legst du den Webhook und die fünf Felder selbst in Ashby an, und Kendor zeigt dir genau, was du eintragen musst.

Den Schlüssel in Kendor einfügen

  1. Öffne Integrationen in der Seitenleiste, unter Organisation.
  2. Wähle auf der Karte Ashby unter Bewerbermanagement die Option Verbinden.
  3. Füge unter 2 · Ashby-API-Schlüssel einfügen den Schlüssel in Ashby-API-Schlüssel ein und wähle Verbinden.

Kendor fragt Ashby, welche Berechtigungen der Schlüssel hat, registriert dann den Webhook und findet oder erstellt seine Felder. Wenn Ashby den Schlüssel ablehnt, erscheint der Grund unter dem Feld, zum Beispiel Ashby rejected the API key.

Der Schlüssel wird verschlüsselt gespeichert. Danach zeigt Kendor nur noch seine letzten vier Zeichen: Verbunden mit dem Schlüssel auf 1234.

Die Einrichtungsliste prüfen

Der Abschnitt Einrichtung hat drei Zeilen. Ein Häkchen bedeutet, dass die Zeile erledigt ist.

  • Schlüsselberechtigungen: Jede erforderliche Berechtigung ist am Schlüssel aktiv. Fehlen welche, nennt Kendor sie. Füge sie in Ashby zum Schlüssel hinzu und wähle dann Erneut prüfen.
  • Webhook: Ashby meldet Kendor, wenn eine Bewerbung die Phase wechselt.
  • Kendor-Felder an Bewerbungen: Die fünf Felder Kendor status, Kendor result, Kendor score, Kendor review und Kendor decision existieren in Ashby an Application.

Der Status oben lautet Verbunden, wenn alles an seinem Platz ist, und Braucht Aufmerksamkeit, wenn etwas fehlt.

Den Webhook von Hand anlegen

Wenn der Schlüssel keine API-Schlüssel schreiben kann, zeigt die Zeile Webhook eine Webhook-URL und ein Geheimes Token zum Kopieren. Öffne in Ashby Admin → Webhooks und lege einen Webhook vom Typ Candidate stage change mit dieser URL und diesem Secret an. Mit Secret anzeigen siehst du das vollständige Token.

Jede Organisation hat ihre eigene Webhook-URL und ihr eigenes Secret. Ashby signiert jede Anfrage mit dem Secret, und Kendor weist jede Anfrage ab, deren Signatur nicht passt.

Die Felder von Hand anlegen

Wenn der Schlüssel keine Metadaten des Einstellungsprozesses schreiben kann, lege die fehlenden Felder in Ashby unter Admin → Custom fields an Application an, mit genau diesen Namen und Typen:

Feldname Typ
Kendor status String
Kendor result String
Kendor score Number
Kendor review URL
Kendor decision String

Kendor findet sie anhand des Namens, ohne Beachtung der Groß- und Kleinschreibung. Wähle Erneut prüfen, sobald sie existieren. Fehlende Felder werden beim Schreiben der Ergebnisse einfach übersprungen.

Tipp. Erneut prüfen liest die Berechtigungen des Schlüssels neu ein und holt jede Einrichtung nach, die der Schlüssel jetzt erlaubt. Nutze es immer, wenn du die Berechtigungen des Schlüssels in Ashby änderst.

Den Schlüssel ersetzen oder trennen

  • Schlüssel ersetzen tauscht einen neuen Schlüssel mit denselben Berechtigungen ein. Der alte Schlüssel wird sofort nicht mehr verwendet. Webhook-URL und Secret bleiben gleich, sodass ein von Hand angelegter Webhook weiter funktioniert.
  • Trennen entfernt den Schlüssel, deine Phasenregeln und den von Kendor registrierten Webhook, und Kendor schreibt nicht mehr in Ashby. Ein von Hand angelegter Webhook bleibt in Ashby, bis du ihn dort löschst. Bereits versandte Einladungen bleiben gültig.

Wenn du dich nach dem Trennen erneut verbindest, stellt Kendor eine neue Webhook-URL und ein neues Secret aus, also aktualisiere jeden Webhook, den du von Hand angelegt hast.

Als Nächstes: Wähle, welche Phasen ein Screening senden.

War dieser Artikel hilfreich?