Zum Hauptinhalt springen

🔌 So verwendest du die Kraaft API

Kraaft macht es dir leicht, deinen Arbeitsbereich mit deinen anderen Tools zu verbinden und deine Abläufe zu automatisieren: Schluss mit der doppelten Eingabe, her mit den smarten Verbindungen 💡

Ein paar konkrete Beispiele ⬇️

  • 🏗️ Automatisch eine Kraaft-Unterhaltung aus deinem ERP erstellen, sobald ein Projekt startet

  • 📂 Deine Berichte automatisch in SharePoint, Google Drive oder deinem Dokumentenmanagementsystem archivieren, sobald sie fertig sind

  • 🔔 Eine Aktion in einem externen Tool auslösen, sobald sich der Status eines Berichts in Kraaft ändert

  • 💬 Automatisch eine Nachricht oder ein Foto in einer Unterhaltung von einem Drittanbieter-Tool aus senden


☑️ Schritt 1: Die API in deinem Kraaft-Arbeitsbereich aktivieren

Die Kraaft-API ist standardmäßig nicht aktiviert ⚙️ Kontaktiere unseren Support, um sie zu nutzen.

⚠️ Nur ein Kontoinhaber kann die Aktivierung anfragen.


🔑 Schritt 2: Einen Kraaft-API-Schlüssel erstellen

Sobald die API aktiviert ist, können Administrator oder Inhaber des Arbeitsbereichs Schlüssel in den Einstellungen erstellen 🛠️

  1. Gehe zu Menü → Einstellungen deines Arbeitsbereichs

  2. Klicke auf den Tab API-Schlüssel 🔑

  3. Klicke auf "API-Schlüssel erstellen" ➕

  4. Gib ihm einen aussagekräftigen Namen (z. B. "Make - ERP" oder "Zapier - Archivierung") 📋

  5. Wähle die Rolle des Schlüssels

💡 Die Rechte eines API-Schlüssels folgen genau denselben Rollen wie in Kraaft: Extern, Standard, Administrator und Inhaber 👤 Jede Rolle gibt Zugriff auf einen anderen Bereich deiner Unterhaltungen und Berichte — die Feinheiten jeder Rolle erklären wir dir in unserem Artikel "Mehr zur Kraaft-API entdecken", damit du die richtige für deinen Anwendungsfall wählst.

⚠️ Der Schlüssel wird nur einmal angezeigt — kopiere ihn sofort! Wenn du ihn verlierst, musst du einen neuen erstellen (dauert 2 Minuten, aber das kannst du dir sparen 😅)


📦 Was du mit der Kraaft-API heute machen kannst

Die API ist um 4 Ressourcen herum aufgebaut 🗂️

  • 🗂️ Workspaces — die mit deinem Schlüssel zugänglichen Arbeitsbereiche auflisten

  • 📋 Schemas — die Struktur deiner Berichte auslesen, um zu wissen, was du senden und empfangen kannst

  • 📝 Records & Conversations — deine Berichte und Unterhaltungen auflisten, lesen, erstellen und bearbeiten

  • ⚡ Events — in Echtzeit alles erkennen, was in Kraaft passiert

⚡ Zoom auf Events

Kraaft führt ein Protokoll über alles, was passiert: Jeder erstellte, geänderte oder gelöschte Bericht erzeugt ein Ereignis 🔔 Zwei Wege, sie zu nutzen:

  • Ereignisliste — frage Kraaft in regelmäßigen Abständen ab ("Was ist seit dem letzten Mal passiert?")

  • Echtzeit-Ereignisse — erhalte Ereignisse sofort, sobald sie eintreten ⚡

Beispiel: Dein ERP wird automatisch benachrichtigt, sobald ein Bericht in Kraaft den Status "Abgeschlossen" erhält — ganz ohne manuelles Zutun ⚡

✅ Und seit Kurzem kannst du auch Nachrichten und Dateien (Fotos, Dokumente) direkt über die API in eine Unterhaltung senden — praktisch, um ein Team vor Ort zu benachrichtigen oder ein Dokument von einem Drittanbieter-Tool aus anzuhängen, ohne die App zu öffnen 📤


🤖 Die Kraaft-API mit einem Automatisierungstool nutzen

Du willst die Kraaft-API mit einem No-Code-Tool verbinden? Kein Problem 🎉

  • ✅ Make: native Kraaft-Connectoren sind direkt in Make verfügbar

  • 🔧 n8n, Zapier und andere: nutze die HTTP- oder API-Request-Module deines Tools, um die Kraaft-API aufzurufen

  • 🔜 Weitere native Kraaft-Connectoren folgen bald für andere Tools


📖 Zugriff auf die Kraaft-API-Dokumentation

Die offizielle Dokumentation findest du hier 👉 developers.kraaft.co

Sie beschreibt alle verfügbaren Endpunkte, die erwarteten Datenformate und die Authentifizierungsmethoden 📚 Ein technisches Profil findet sich hier schnell zurecht!


📊 Willst du deine Kraaft-Daten analysieren?

Der Kraaft Data Exchange (KDE) ist genau dafür da 📊 Verbinde deine Daten mit Power BI, Tableau oder Looker — und steuere deine Projekte von einem einzigen Datenvisualisierungstool aus.


🔍 Willst du mehr erfahren?

Schlüsselrollen im Detail, IDs auflösen, Listen und Tabellen, Verbindung zu Make/n8n… wir haben alle Feinheiten, die wir beim intensiven Testen der API entdeckt haben, in einem Ergänzungsartikel gesammelt 🕵️


💬 Brauchst du Hilfe?

Hat dies deine Frage beantwortet?