So verbindest du Ashby mit Kendor
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
- Öffne Integrationen in der Seitenleiste, unter Organisation.
- Wähle auf der Karte Ashby unter Bewerbermanagement die Option Verbinden.
- 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 reviewundKendor decisionexistieren 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.