Integrationen

Wechseln Sie nicht das ATS. Setzen Sie Aya in das ein, das Sie haben.

Das Interview von Aya wird zu einer Stufe Ihres bestehenden Prozesses. Der Kandidat unterhält sich über WhatsApp, und die Bewertung landet mit ihren Belegen in der Akte, auf die Ihr Team ohnehin schaut — niemand öffnet einen zweiten Bildschirm.

API-Schlüssel, Testumgebung und Webhooks richten Sie selbst in den Kontoeinstellungen ein. Es gibt keine Warteliste und kein Einführungsprojekt.

Das Argument

Das bedeutet Plug-and-play, in drei Sätzen

Keine Migration, kein neues Werkzeug, das das Team lernen muss, kein Bericht, den jemand von Hand zusammenstellt.

Eine Stufe, kein Ersatz

Ihr ATS bleibt Herr des Prozesses

Stelle, Pipeline und Verlauf bleiben, wo sie sind. Talpy verlangt keine Migration und nicht, dass ein Recruiter den Bildschirm wechselt, in dem er jeden Tag arbeitet.

Das Interview

Aya spricht mit allen, die sich beworben haben

Interview über WhatsApp oder per Link, im Tempo des Kandidaten: er antwortet, wenn er kann, und niemand vereinbart einen Termin. Vorauswahl ist keine Warteschlange mehr, sondern eine sortierte Liste.

Der Rückweg

Die Bewertung kommt mit dem Beleg zurück, der sie trägt

Gesamtbewertung, Passung zum Profil, eine Bewertung pro Kompetenz und das wörtliche Zitat aus der Antwort, das jede davon begründet. Entscheiden tut ein Mensch; die KI empfiehlt und zeigt das Warum.

Native Integration

Workable: vier Schritte, und die Bewertung landet in der Akte

Es ist heute die einzige native Integration, und sie läuft in beide Richtungen: Workable meldet, wenn ein Kandidat die von Ihnen gewählte Stufe erreicht, und Talpy schreibt die Bewertung dort in seine Akte zurück.

01

Verbinden

Subdomain und ein Zugriffstoken, das ein Administrator Ihres Workable erzeugt. Das Token liegt bei uns verschlüsselt.

02

Auslöser-Stufe wählen

Ein Kandidat, der in diese Stufe verschoben wird, wird mit Stelle und Lebenslauf importiert und erhält schon vor dem Gespräch eine Vorauswahl-Bewertung. Bleibt das Feld leer, kommt jede neue Bewerbung herein.

03

Aya interviewt

Die Einladung geht über das WhatsApp des Kandidaten hinaus. Fehlt in der Akte die Telefonnummer, schreiben wir einen Kommentar dazu, statt still zu scheitern.

04

Die Bewertung kommt zurück

Ein Kommentar in der Workable-Akte mit Bewertung, Passung, Zusammenfassung, Kompetenzen samt Belegen und einem Link auf den vollen Bericht, plus eine Daumen-Bewertung. Auf Wunsch wechselt der angenommene Kandidat auch selbst die Stufe.

Was diese Integration nicht tut

  • Eine Verbindung pro Unternehmen und eine Auslöser-Stufe. Zwei unterschiedliche Abläufe im gleichen Konto passen noch nicht.
  • Die Daumen-Bewertung hat zwei Zustände: positiv ab der von Ihnen gesetzten Mindestbewertung, negativ darunter. Voreingestellt ist 7.
  • Die in Talpy gespiegelte Stelle entsteht als interne Stelle und erreicht Google nie. Die öffentliche Anzeige bleibt die von Workable, und so soll es sein.
  • Ein Kandidat, der nicht aus Workable kam, wird nicht dorthin geschoben. Für diese Richtung gibt es die API und die Webhooks.
  • Für den Rückweg gibt es keinen automatischen neuen Versuch. Ist Workable ausgefallen, wenn die Bewertung fertig ist, bleibt sie in Talpy gespeichert und der Fehler erscheint im Bildschirm der Integration.

Anleitung Schritt für Schritt

Jedes andere ATS

Signierte Webhooks: Ihr System erfährt es sofort

Jedes Kandidaten-Ereignis geht als POST an die Adresse, die Sie hinterlegen. Es sind sechs, und sie decken den ganzen Zyklus ab, nicht nur das Ende: ein System, das nur „bewertet“ erhält, erfährt von der Bewerbung Stunden nach ihr.

  1. candidato.criado

    Jemand hat sich beworben — über den Stellenlink, die Karriereseite oder die API.

  2. candidato.triado

    Der Lebenslauf wurde gelesen und hat die Passungsbewertung zum Stellenprofil erhalten.

  3. entrevista.iniciada

    Der Kandidat hat auf den ersten Kontakt geantwortet, das Gespräch mit Aya hat begonnen.

  4. candidato.avaliado

    Aya hat das Interview beendet und die Bewertung erfasst: Note, Kompetenzen und Belege.

  5. candidato.decidido

    Die Personalabteilung hat den Kandidaten angenommen oder abgelehnt — die menschliche Entscheidung, dokumentiert.

  6. revisao.solicitada

    Der Kandidat hat eine menschliche Überprüfung der Bewertung verlangt. Vorrangig behandeln.

Signiert, damit Sie vertrauen können

Jeder POST trägt den HMAC-SHA256 des Rumpfs, berechnet mit einem Geheimnis, das nur zu Ihrem Endpunkt gehört. Die Signatur zu prüfen ist das, was verhindert, dass jemand sich als Talpy ausgibt und einen angenommenen Kandidaten in Ihr System schiebt.

X-Talpy-Signature: sha256=…

Testen, bevor Sie sich darauf verlassen

Eine Schaltfläche im Panel löst ein signiertes Testereignis aus und zeigt den HTTP-Status, den Ihr Server geliefert hat — daneben die Uhrzeit der letzten echten Zustellung.

Was es nicht gibt

Automatische erneute Zustellung. Ein Endpunkt, der nicht innerhalb von fünf Sekunden antwortet, verliert dieses Ereignis; der Status steht im Bildschirm, und der Weg zurück zu Verpasstem ist die API.

Öffentliche API

API v1: für Teams, die den Ablauf selbst schreiben wollen

REST mit JSON, per Schlüssel authentifiziert und im Pfad versioniert. Die Endpunkte deckten Stelle, Kandidat, Lebenslauf, WhatsApp-Einladung und das Interview mit Transkript und Bewertung ab.

GET/api/v1/jobsjobs:read
GET/api/v1/jobs/{id}jobs:read
POST/api/v1/jobsjobs:write
PATCH/api/v1/jobs/{id}jobs:write
GET/api/v1/jobs/{id}/candidatescandidates:read
POST/api/v1/candidatescandidates:write
GET/api/v1/candidates/{id}candidates:read
POST/api/v1/candidates/{id}/whatsappwhatsapp:send
GET/api/v1/interviews/{id}interviews:read
POST/api/mcpmcp:read

7 Berechtigungen, einzeln angehakt

Ein Schlüssel entsteht nur mit dem, was Sie anhaken, und die Berechtigungen sind nach HANDLUNG getrennt, weil der Schaden jeweils anders aussieht: eine Stelle zu lesen ist faktisch öffentlich, einen Kandidaten anzulegen berührt personenbezogene Daten, und WhatsApp zu senden kostet Geld und riskiert den Ruf der Unternehmensnummer.

jobs:read
Die Stellen des Unternehmens und die Details jeder Stelle lesen.
jobs:write
Stellen anlegen und bestehende Stellen ändern.
candidates:read
Die Kandidaten einer Stelle und die Akte eines Kandidaten lesen.
candidates:write
Kandidaten anlegen, auch mit Lebenslauf in Base64.
interviews:read
Das Interview und die Bewertung des Kandidaten neben der Akte lesen.
whatsapp:send
Einem Kandidaten eine WhatsApp-Nachricht senden.
mcp:read
Talpy über einen KI-Agenten mit dem MCP-Protokoll abfragen.

Der Schlüssel erscheint genau einmal

Wir speichern den Hash, nicht den Schlüssel — selbst wir können ihn später nicht wiederherstellen. Wer ihn verliert, widerruft ihn und erzeugt einen neuen; und das Präfix des Werts sagt im Geheimnis selbst laut, ob er für Produktion oder für Tests ist.

Limit und Umgebung in jeder Antwort

120 Anfragen pro Minute und Schlüssel. Jede Antwort sagt, wie viel vom Limit übrig ist und in welcher Umgebung sie entstand — damit Sie die Grenze nicht dadurch entdecken, dass Sie dagegenstoßen, und nicht auf Produktion schwören, während Sie Spielzeugdaten lesen.

curl-Beispiele und das Format jeder Antwort

Testumgebung

Eine Kopie Ihres Unternehmens, besetzt mit Menschen, die es nicht gibt

Ein Testschlüssel arbeitet in einer Spiegel-Organisation Ihrer eigenen, bei Bedarf erzeugt und schon bestückt mit einer Stelle, zwei Kandidaten in verschiedenen Phasen und einer Bewertung zum Lesen.

Gleiche Routen, gleiche Fehler

Es ist keine Simulation mit erfundenen Antworten: es ist derselbe Code und dieselbe Datenbank, nur mit Spielzeugdaten. Eine erfundene Antwort lügt über Format und Fehler, und der Unterschied zeigt sich in der Produktion.

Nichts verlässt das Haus

Kein WhatsApp, keine Abrechnung, kein Verbrauch Ihres Tarifs. Die Beispiel-Kandidaten haben keine Telefonnummer, es gibt also nichts, wohin man eine Nachricht senden könnte.

Zurücksetzen möglich

Beim Testen die Sandbox durcheinandergebracht? Ein Befehl löscht und bestückt sie neu, und Ihr echter Betrieb merkt nichts davon.

KI-Assistent

Fragen Sie über den Assistenten, den Ihr Team schon nutzt

Talpy stellt einen MCP-Server bereit: der KI-Client des Unternehmens zeigt auf die Adresse, schickt den Schlüssel, und das Team fragt in natürlicher Sprache — „wer war auf der Support-Stelle am besten?“. Das gibt es, weil Recruiting von der Personalabteilung gekauft wird, nicht von der Technik: eine API setzt jemanden voraus, der Code schreibt, Dokumentation liest und Fehler behandelt.

Fünf Abfragen, und nichts als Abfragen

listar_vagas
Die Stellen des Unternehmens, mit Status und der Zahl der Kandidaten pro Stelle.
detalhar_vaga
Eine Stelle mit den Kompetenzen, die Aya bewertet, und dem Gewicht jeder einzelnen — aus diesen Kriterien entstehen die Bewertungen.
listar_candidatos
Die Kandidaten einer Stelle mit Bewertung, Passung und Phase, absteigend sortiert.
detalhar_candidato
Die vollständige Bewertung eines Kandidaten: Note pro Kompetenz, der Beleg zu jeder Note, Auffälligkeiten, Stärken und die menschliche Entscheidung, wenn es sie schon gibt.
resumo_do_recrutamento
Die Gesamtzahlen des Unternehmens: offene Stellen, Kandidaten, abgeschlossene Interviews, Durchschnittsbewertung und Tarifnutzung. Enthält keine personenbezogenen Daten.

Drei Sperren, und keine davon ist Zierde

  • Eigene Berechtigung. Der Assistenten-Zugang ist eine von den Leseberechtigungen getrennte Berechtigung. Ein Integrationsschlüssel, der schon Kandidaten lesen konnte, bekommt diesen Kanal nicht gratis dazu.
  • Einwilligung des Unternehmens. Sie ist standardmäßig aus. Einschalten darf sie der Kontoadministrator — nicht wir und nicht, wer den Schlüssel erzeugt hat: das Unternehmen entscheidet, ob die Daten seiner Kandidaten von einem Modell im selbst gewählten KI-Client gelesen werden dürfen.
  • Ein Auditeintrag pro Abfrage. Jeder Aufruf landet im Audit-Protokoll des Unternehmens, samt der gestellten Frage. Zugriff auf Kandidatendaten, der keine Spur hinterlässt, ist der Zugriff, den man hinterher nicht erklären kann.

Nur lesend, und ohne Kontaktdaten

Kein Werkzeug schreibt, entscheidet, löscht oder sendet Nachrichten — ein Modell, das „sag allen, die Stelle ist zu“ auslegt, darf kein Geld ausgeben können. Und keines gibt Telefonnummer, E-Mail oder Lebenslauf zurück: um die Person zu erreichen, öffnet jemand die Akte im Panel, wo der Zugriff namentlich erfolgt und im Audit-Protokoll landet.

Ohne zu programmieren

Zapier, Make, n8n, Tabelle, Team-Chat

Das läuft über den Webhook — und hier der ehrliche Teil: wir haben keine veröffentlichte App in den Verzeichnissen von Zapier oder Make. Was es gibt, ist einfacher, als es klingt: jedes dieser Werkzeuge akzeptiert einen Webhook-Auslöser, und dort fügen Sie die Adresse ein, die Talpy erzeugt.

Von dort wird ein bewerteter Kandidat zur Tabellenzeile, zur Karte auf Ihrem Board, zur Nachricht im Team-Chat oder zum neuen Kandidaten in Ihrem ATS. Das fertige Rezept steht in der Dokumentation, neben dem Format des eingehenden Rumpfs.

Zum Rezept

Ehrlichkeit

Was es noch nicht gibt

Diese Seite verspricht nur, was heute im Produkt ist. Was fehlt, fehlt — und es erst in einem Termin zu erfahren, kostet die Zeit aller Beteiligten.

  • Eine veröffentlichte App in den Verzeichnissen von Zapier, Make oder n8n. Die Verbindung läuft über Webhook, und Sie stellen sie her.
  • Native Integration mit Gupy, Greenhouse, Lever, SAP oder Workday. Die kommen über die API und die Webhooks, nicht über eine Schaltfläche.
  • Automatische erneute Zustellung eines fehlgeschlagenen Webhooks.
  • Schreiben über den KI-Assistenten. Der MCP-Kanal ist absichtlich nur lesend, und das steht nicht zur Änderung an.
  • Bidirektionale Synchronisierung außerhalb von Workable. In jedem anderen ATS entscheidet Ihr Code, was hochgeht und wann.
Fragen

Was vor der Integration gefragt wird

Brauchen wir einen Entwickler, um anzufangen?

Für Workable nicht: die Verbindung entsteht auf einem Bildschirm, mit einem Token aus Ihrem eigenen Workable. Für Webhooks braucht jemand eine Adresse, die einen POST annimmt — das löst ein Automatisierungswerkzeug ohne Code. Die API ist der Weg für Teams, die den Ablauf selbst schreiben wollen.

Was kostet die Integration?

Nichts zusätzlich. API, Webhooks, Testumgebung und der KI-Assistenten-Kanal gehören zum Produkt; abgerechnet werden Interviews. Die Grenzen je Tarif stehen auf der Preisseite.

Können wir testen, ohne einen echten Kandidaten zu berühren?

Ja, und das ist der empfohlene Weg. Ein Testschlüssel arbeitet in einer bestückten Kopie Ihres Unternehmens, in der nichts nach außen geht — kein WhatsApp, keine Abrechnung. Wenn es dort läuft, tauschen Sie den Schlüssel.

Wie hoch ist das Nutzungslimit?

120 Anfragen pro Minute und Schlüssel, und jede Antwort sagt, wie viel übrig ist. Braucht Ihr Fall mehr, sprechen Sie mit uns, bevor Sie um die Grenze herum bauen.

Sprechen Sie mit uns

Sagen Sie uns, welches ATS Sie nutzen

Nennen Sie das System, das Stellenvolumen und die Stelle im Prozess, an der Aya einsteigen soll. Wir antworten mit dem konkreten Weg — und wenn es keinen gibt, sagen wir auch das.

Wir verwenden diese Daten nur, um Ihnen zu antworten. Details in der Datenschutzerklärung.

Erklärbare KI · menschliche Entscheidung