Zum Hauptinhalt springen

So verwendest du die Kraaft API 🔌

Die Kraaft API ermöglicht es dir, deinen Kraaft-Arbeitsbereich mit deinen anderen Tools zu verbinden und deine Workflows zu automatisieren: Schluss mit doppelter Dateneingabe — her mit den smarten Verbindungen 💡!


📌 Was ist die Kraaft API?

Die Kraaft API ist eine technische Schnittstelle, über die deine externen Tools direkt mit Kraaft kommunizieren können 💡 Konkret kannst du damit Aktionen automatisch auslösen — ganz ohne manuelle Eingabe.

Hier sind einige Beispiele, was du damit machen kannst:

  • 🏗️ Automatisch eine Kraaft-Konversation aus deinem ERP erstellen, wenn ein Projekt gestartet wird

  • 📂 Deine Berichte in SharePoint, Google Drive oder dein DMS archivieren, sobald sie abgeschlossen sind

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


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

Die Kraaft API ist standardmäßig nicht aktiviert ⚙️ Um Zugang zu erhalten, kontaktiere unseren Support.

⚠️ Nur ein Account-Inhaber kann die Aktivierung beantragen.

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

Sobald die API aktiviert ist, kann der Administrator oder Inhaber des Arbeitsbereichs Schlüssel über die Einstellungen erstellen.

  1. Gehe zum 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 entsprechend deinem Anwendungsfall

Die verfügbaren Rollen:

Rolle

Rechte & Zugriff

Wann verwenden?

Standard

Zugriff nur auf Konversationen, denen der Schlüssel manuell hinzugefügt wurde

Gezielter Einsatz für bestimmte Konversationen

Administrator & Inhaber

Vollständiger Zugriff auf den Arbeitsbereich, Erstellung und Änderung

Standardmäßig für eine globale Integration

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


📦 Was du mit der Kraaft API machen kannst

Die API ist um 4 Ressourcen aufgebaut:

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

  • 📋 Schemas — die Struktur deiner Berichte lesen, um zu wissen, was zu senden und zu empfangen ist

  • 📝 Records & Conversations — deine Berichte und Konversationen auflisten, lesen, erstellen und ändern

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

⚡ Spotlight: Events 🔍

Kraaft führt ein Protokoll über alles, was passiert: jeder erstellte, geänderte oder gelöschte Bericht erzeugt ein Event 🔔 Zwei Möglichkeiten, diese zu nutzen:

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

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

💡 Beispiel: Dein ERP wird automatisch benachrichtigt, sobald ein Bericht in Kraaft den Status "Abgeschlossen" erhält — ohne manuelle Aktion.

Was noch nicht möglich ist: Nachrichten oder Dateien über den Kraaft-Chat senden.


🤖 Die Kraaft API mit einem Automatisierungstool verwenden

Du möchtest die Kraaft API mit einem No-Code-Tool verbinden? Das ist absolut möglich 🎉

  • Make: Native Kraaft-Konnektoren sind direkt in Make verfügbar

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

  • 🔜 In Zukunft werden weitere native Kraaft-Konnektoren in anderen Tools verfügbar sein


📖 Zugriff auf die Kraaft API-Dokumentation

Die offizielle Dokumentation ist hier verfügbar 👉 developers.kraaft.co/docs

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


📊 Du möchtest deine Kraaft-Daten analysieren?

Das Kraaft Data Exchange (KDE) ist genau dafür gemacht 📊 Verbinde deine Daten mit Power BI, Tableau oder Looker — und steuere deine Projekte über ein einziges Datenvisualisierungstool.


💬 Du brauchst Hilfe?

Hat dies deine Frage beantwortet?