Aller au contenu

API et développeurs

Vos systèmes lisent et écrivent dans Kanesh.

Une API REST, un serveur MCP et des webhooks signés, avec des clés révocables à permissions limitées. Pour les projets approuvés, pas en libre-service.

Bêta Disponible pour les projets approuvés, pas en libre-service.

# Lister les contacts avec une clé en lecture seulecurl https://app.kanesh.example/api/v1/contacts \  -H "Authorization: Bearer kn_live_••••"
Démonstration avec des données fictives

Des clés qui ne font que ce que vous autorisez.

Une API REST et un schéma OpenAPI pour vos données, avec des clés à permissions limitées. Donnez à chaque intégration sa propre clé et uniquement les permissions nécessaires.

  • Un schéma OpenAPI pour générer un client dans votre langage.
  • Des permissions de lecture, d’écriture ou d’envoi, ressource par ressource.
  • Les clés sont stockées sous forme de hash et révocables à tout moment.
  • Des envois de modèles idempotents : retenter une requête ne renvoie pas le message au client.
  • La documentation de référence dans l’application une fois votre projet approuvé.

Illustration de la création d’une clé API : un nom et les seules permissions nécessaires lui sont attribués. La clé est affichée une fois, puis révoquée ; les requêtes l’utilisant sont alors rejetées.

Démonstration avec des données fictives

Vos systèmes doivent aussi communiquer avec vos clients.

  1. Des données isolées

    Des contacts, conversations et commandes que votre ERP ou BI ne peut pas lire.

  2. Des alertes jamais envoyées

    Votre système détecte un événement, mais ne peut pas envoyer le bon modèle WhatsApp.

  3. Des intégrations fragiles

    Des scripts sans authentification ni limites qui cassent dès que quelque chose change.

Ce qu’une clé peut être autorisée à faire.

Chaque clé reçoit uniquement les permissions cochées. Voici les ressources disponibles aujourd’hui.

Lire

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

Écrire

  • contacts
  • conversations
  • labels
  • segments

Envoyer

  • templates:send

Les identifiants exacts des permissions figurent dans la documentation des projets approuvés.

Connectez vos propres outils d’IA aux données de Kanesh.

Un serveur MCP pour que vos outils d’IA puissent lire vos données Kanesh et agir dessus avec une clé API à permissions limitées.

Bêta
  • Connexion par HTTP en streaming et authentification par clé API Bearer.
  • Compatible avec les clients MCP permettant de définir cette clé. Ce n’est pas un connecteur en un clic pour les applications d’IA grand public.

Lire

  • Contacts
  • Conversations
  • Messages
  • Commandes
  • Campagnes
  • Segments et membres
  • Automatisations
  • Indicateurs
  • Attributions

Agir

  • Envoyer un modèle WhatsApp
  • Ajouter une note
  • Attribuer une conversation
  • Gérer les étiquettes
  • Créer ou mettre à jour un contact

Des événements sortants, des messages entrants.

Deux autres possibilités pour relier Kanesh à vos systèmes.

  • Webhooks signés

    Bêta

    Des webhooks signés pour les événements clés : votre endpoint peut vérifier qu’ils viennent de Kanesh. La liste des événements est communiquée aux projets approuvés.

  • Canal API personnalisé

    Bêta

    Faites entrer les conversations d’un canal que vous gérez dans la boîte partagée via l’API.

Quatre étapes, sans inscription en libre-service.

  1. 01

    Présentez votre projet

    Ce que vous voulez connecter et les données nécessaires.

  2. 02

    Nous l’approuvons

    S’il convient, nous activons l’accès à l’API pour votre espace.

  3. 03

    Des clés limitées

    Une clé par intégration, avec les seules permissions nécessaires.

  4. 04

    Développez et révoquez

    Développez à partir du schéma OpenAPI. Révoquez une clé quand vous voulez.

Questions des développeurs

Puis-je obtenir une clé API immédiatement ?
Pas encore. L’accès est réservé aux projets approuvés : présentez ce que vous voulez construire, puis recevez des clés à permissions limitées après approbation.
Existe-t-il un SDK ?
Non. Nous publions un schéma OpenAPI pour générer un client dans votre langage.
Puis-je connecter ChatGPT ou Claude ?
Le serveur MCP fonctionne avec les clients MCP permettant de définir une clé API Bearer. Les connecteurs en un clic nécessitant un parcours de connexion ne sont pas disponibles.
Quels événements les webhooks couvrent-ils ?
Les webhooks sont signés et couvrent les événements clés. La liste, susceptible d’évoluer, est communiquée aux projets approuvés plutôt que publiée ici.
Que faire si une clé fuit ?
Révoquez-la. Les requêtes utilisant une clé révoquée sont rejetées. Les clés sont stockées sous forme de hash : Kanesh ne peut pas non plus vous les afficher à nouveau en entier.

Dites-nous ce que vous voulez construire.

L’accès est accordé par projet. Expliquez ce que vous voulez connecter lors du diagnostic : nous vous dirons franchement si cela convient.