Zum Inhalt springen
Kanesh

API und Entwicklung

Ihre Systeme lesen und schreiben Kanesh-Daten.

REST-API, MCP-Server und signierte Webhooks mit widerrufbaren, berechtigungsgebundenen Schlüsseln. Für freigegebene Projekte, nicht im Self-Service.

Beta Für freigegebene Projekte verfügbar, nicht im Self-Service.

# Kontakte mit einem Nur-Lese-Schlüssel auflistencurl https://app.kanesh.example/api/v1/contacts \  -H "Authorization: Bearer kn_live_••••"
Beispieldarstellung mit fiktiven Daten

Schlüssel, die nur tun, was Sie erlauben.

Eine REST-API und ein OpenAPI-Schema für Ihre Daten, mit begrenzten Berechtigungen. Jede Integration erhält einen eigenen Schlüssel mit genau den nötigen Rechten.

  • Ein OpenAPI-Schema, um einen Client in Ihrer Programmiersprache zu erzeugen.
  • Berechtigungen zum Lesen, Schreiben oder Senden, je Ressource.
  • Schlüssel werden als Hash gespeichert und lassen sich jederzeit widerrufen.
  • Idempotenter Vorlagenversand: Ein erneuter Versuch sendet dem Kunden keine zweite Nachricht.
  • Referenzdokumentation in der App nach Freigabe Ihres Projekts.

Illustration eines neuen API-Schlüssels: Er erhält einen Namen und nur die nötigen Rechte, wird einmal angezeigt und später widerrufen. Anfragen mit diesem Schlüssel werden danach abgelehnt.

Beispieldarstellung mit fiktiven Daten

Auch Ihre Systeme müssen mit Ihren Kunden kommunizieren.

  1. Isolierte Daten

    Kontakte, Konversationen und Bestellungen, die Ihr ERP oder BI nicht lesen kann.

  2. Nicht versendete Hinweise

    Ihr System erkennt ein Ereignis, kann aber die passende WhatsApp-Vorlage nicht senden.

  3. Anfällige Integrationen

    Skripte ohne Authentifizierung oder Grenzen, die bei der nächsten Änderung ausfallen.

Was ein Schlüssel dürfen kann.

Jeder Schlüssel erhält nur die ausgewählten Rechte. Diese Ressourcen sind heute verfügbar.

Lesen

  • contacts
  • conversations
  • messages
  • orders
  • team
  • labels
  • usage
  • analytics
  • attribution
  • automations
  • campaigns
  • clicks
  • segments

Schreiben

  • contacts
  • conversations
  • labels
  • segments

Senden

  • templates:send

Die genauen Berechtigungskennungen stehen in der Referenzdokumentation für freigegebene Projekte.

Verbinden Sie Ihre KI-Werkzeuge mit Kanesh-Daten.

Ein MCP-Server, über den Ihre KI-Werkzeuge Kanesh-Daten mit einem berechtigungsgebundenen API-Schlüssel lesen und bearbeiten können.

Beta
  • Verbindung über Streamable HTTP, Authentifizierung mit einem Bearer-API-Schlüssel.
  • Funktioniert mit MCP-Clients, in denen Sie diesen Schlüssel hinterlegen können. Kein Ein-Klick-Connector für KI-Apps für Endverbraucher.

Lesen

  • Kontakte
  • Konversationen
  • Nachrichten
  • Bestellungen
  • Kampagnen
  • Segmente und Mitglieder
  • Automatisierungen
  • Kennzahlen
  • Attributionen

Aktionen

  • WhatsApp-Vorlage senden
  • Notiz hinzufügen
  • Konversation zuweisen
  • Labels verwalten
  • Kontakt erstellen oder aktualisieren

Ereignisse hinaus, Nachrichten hinein.

Zwei weitere Möglichkeiten, Kanesh mit Ihren Systemen zu verbinden.

  • Signierte Webhooks

    Beta

    Signierte Webhooks für wichtige Ereignisse, damit Ihr Endpoint die Herkunft aus Kanesh prüfen kann. Die Ereignisliste erhalten freigegebene Projekte.

  • Eigener API-Kanal

    Beta

    Bringen Sie Konversationen aus einem selbst betriebenen Kanal über die API in den gemeinsamen Posteingang.

Vier Schritte, keine Self-Service-Anmeldung.

  1. 01

    Projekt beschreiben

    Was Sie verbinden möchten und welche Daten Sie benötigen.

  2. 02

    Wir geben es frei

    Wenn es passt, aktivieren wir den API-Zugang für Ihren Workspace.

  3. 03

    Begrenzte Schlüssel

    Ein Schlüssel je Integration mit genau den nötigen Rechten.

  4. 04

    Entwickeln und widerrufen

    Nutzen Sie das OpenAPI-Schema. Widerrufen Sie Schlüssel jederzeit.

Fragen zur Entwicklung

Bekomme ich sofort einen API-Schlüssel?
Noch nicht. Der API-Zugang ist für freigegebene Projekte verfügbar. Beschreiben Sie Ihr Vorhaben; nach Freigabe erhalten Sie Schlüssel mit begrenzten Rechten.
Gibt es ein SDK?
Nein. Wir veröffentlichen ein OpenAPI-Schema, mit dem Sie einen Client in Ihrer Programmiersprache erzeugen können.
Kann ich ChatGPT oder Claude verbinden?
Der MCP-Server funktioniert mit MCP-Clients, in denen sich ein Bearer-API-Schlüssel hinterlegen lässt. Ein-Klick-Connectoren mit Anmeldeablauf sind nicht verfügbar.
Welche Webhook-Ereignisse gibt es?
Webhooks sind signiert und decken wichtige Ereignisse ab. Die Liste erhalten freigegebene Projekte; sie wird hier nicht veröffentlicht, da sie sich noch ändern kann.
Was passiert, wenn ein Schlüssel bekannt wird?
Widerrufen Sie ihn. Anfragen mit widerrufenen Schlüsseln werden abgelehnt. Schlüssel werden als Hash gespeichert, daher kann auch Kanesh den vollständigen Schlüssel nicht erneut anzeigen.

Was möchten Sie entwickeln?

Der Zugang wird pro Projekt freigegeben. Beschreiben Sie im Diagnosegespräch, was Sie verbinden möchten. Wir sagen Ihnen ehrlich, ob es passt.