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

  • 📅 Die Nachrichten einer Unterhaltung abrufen, um deine Baustellenplanung zu füttern


☑️ 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 😅)

🔐 Du entwickelst eine Anwendung, bei der jeder Nutzer sein eigenes Kraaft-Konto verbindet? Die API unterstützt neben API-Schlüsseln auch OAuth 2.0


📦 Was du mit der Kraaft-API heute machen kannst

Die Kraaft-API gibt dir Zugriff auf 6 Ressourcen 🗂️

  • 🗂️ 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 — deine Berichte auflisten, lesen, erstellen und bearbeiten

  • 💬 Conversations — eine Unterhaltung lesen, erstellen, archivieren und ihre Mitglieder verwalten

  • 📨 Messages — Nachrichten und Dateien (Fotos, Dokumente) in eine Unterhaltung senden und den Nachrichtenverlauf lesen

  • ⚡ Events — in Echtzeit alles erkennen, was mit deinen Berichten und Nachrichten passiert

⚡ Zoom auf Events

Kraaft führt ein Protokoll über alles, was passiert 🔔 Jeder erstellte, geänderte, gelöschte oder wiederhergestellte Bericht und jede gesendete, bearbeitete oder gelöschte Nachricht 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, oder deine Planung übernimmt jede neue Info aus einer Baustellen-Unterhaltung ⚡


🤖 Die Kraaft-API mit einem Automatisierungstool nutzen

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

  • ✅ Make — installiere die Kraaft-App direkt über make.kraaft.co: die Verbindung erfolgt per OAuth, mit einem Klick, ohne einen Schlüssel manuell zu kopieren

  • 🔧 n8n, Zapier und andere — nutze die HTTP- oder API-Request-Module deines Tools, um die Kraaft-API mit deinem Schlüssel aufzurufen


📖 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 Kraaft über einen KI-Assistenten nutzen?

Die API ist dafür gemacht, Tools automatisch miteinander zu verbinden 🔧 Um Fragen zu deinen Kraaft-Daten zu stellen oder eine Aktion in natürlicher Sprache über Claude, ChatGPT oder einen anderen KI-Assistenten anzufordern, nutze lieber den Kraaft MCP 🤖


🔍 Willst du mehr erfahren?

Die Nachrichten einer Unterhaltung lesen, API-Schlüssel oder OAuth, Schlüsselrollen im Detail, IDs auflösen, Listen und Tabellen, Filtern und Echtzeit… wir haben alle Feinheiten der API in einem Ergänzungsartikel gesammelt 🕵️


📞 Brauchst du Hilfe?

Bei Fragen, Kontaktiere uns!

Hat dies deine Frage beantwortet?