Passer au contenu principal

🔌 Activer l'API Kraaft

L'API Kraaft te permet de connecter ton espace Kraaft à tes autres outils et d'automatiser tes flux de travail : fini la double saisie, place aux connexions intelligentes 💡 !


📌 C'est quoi l'API Kraaft ?

L'API Kraaft, c'est une interface technique qui permet Ă  tes outils externes de communiquer directement avec Kraaft 💡 ConcrĂštement, tu peux dĂ©clencher des actions automatiquement, sans aucune saisie manuelle.

Voici quelques exemples de ce que tu peux faire :

  • đŸ—ïž CrĂ©er une conversation Kraaft automatiquement depuis ton ERP quand un projet est lancĂ©

  • 📂 Archiver tes rapports dans SharePoint, Google Drive ou ta GED dĂšs qu'ils sont terminĂ©s

  • 🔔 DĂ©clencher une action dans un outil externe dĂšs qu'un rapport change de statut dans Kraaft


☑ Étape 1 : Activer l'API sur ton espace Kraaft

L'API Kraaft n'est pas activĂ©e par dĂ©faut ⚙ Pour en bĂ©nĂ©ficier, contacte notre support.

⚠ Seul un propriĂ©taire de compte peut faire la demande d'activation.

🔑 Étape 2 : CrĂ©er une clĂ© API Kraaft

Une fois l'API activée, l'administrateur ou le propriétaire de l'espace peut créer des clés depuis les paramÚtres.

  1. Va dans le Menu → Paramùtres de ton espace

  2. Clique sur l'onglet ClĂ©s API 🔑

  3. Clique sur "CrĂ©er une clĂ© API" ➕

  4. Donne-lui un nom parlant (ex : "Make - ERP" ou "Zapier - Archivage") 📋

  5. Choisis le rÎle de la clé selon ton usage

Les 3 rĂŽles disponibles :

RĂŽle

Droits et accĂšs

Quand l'utiliser ?

Standard

AccÚs uniquement aux conversations dans lesquelles la clé a été ajoutée manuellement

Usage ciblé sur quelques conversations précises

Administrateur & Propriétaire

AccÚs complet à l'espace, création et modification

Usage classique pour une intégration globale

⚠ La clĂ© s'affiche une seule et unique fois — copie-la immĂ©diatement ! Si tu la perds, il faudra en crĂ©er une nouvelle (ça prend 2 minutes, mais autant l'Ă©viter 😅)


📩 Ce qu'on peut faire avec l'API Kraaft

L'API est organisée autour de 4 ressources :

  • đŸ—‚ïž Workspaces — lister les espaces accessibles avec ta clĂ©

  • 📋 Schemas — lire la structure de tes rapports pour savoir quoi envoyer et recevoir

  • 📝 Records & Conversations — lister, lire, crĂ©er et modifier tes rapports et conversations

  • ⚡ Events — dĂ©tecter en temps rĂ©el tout ce qui se passe dans Kraaft

⚡ Zoom sur les Events 🔍

Kraaft tient un journal de tout ce qui se passe : chaque rapport créé, modifiĂ© ou supprimĂ© gĂ©nĂšre un Ă©vĂ©nement 🔔 Deux façons de les consommer :

  • Liste d'Ă©vĂ©nements — interroge Kraaft Ă  intervalles rĂ©guliers ("qu'est-ce qui s'est passĂ© depuis la derniĂšre fois ?")

  • ÉvĂ©nements en temps rĂ©el — reçois les Ă©vĂ©nements instantanĂ©ment, dĂšs qu'ils se produisent ⚡

💡 Exemple : ton ERP est notifiĂ© automatiquement dĂšs qu'un rapport passe au statut "TerminĂ©" dans Kraaft — sans aucune action manuelle.

❌ Ce qui n'est pas encore possible : envoyer des messages ou des fichiers via le chat Kraaft.


đŸ€– Utiliser l'API Kraaft avec un outil d'automatisation

Tu veux connecter l'API Kraaft à un outil no-code ? C'est tout à fait possible 🎉

  • ✅ Make : des connecteurs Kraaft natifs sont disponibles directement dans Make

  • 🔧 Zapier, n8n et autres : utilise les modules HTTP ou requĂȘte API de ton outil pour appeler l'API Kraaft

  • 🔜 À l'avenir, d'autres connecteurs natifs Kraaft seront disponibles dans d'autres outils


📖 AccĂ©der Ă  la documentation API Kraaft

La documentation officielle est disponible ici 👉 developers.kraaft.co/docs

Elle dĂ©taille tous les endpoints disponibles, les formats de donnĂ©es attendus et les modalitĂ©s d'authentification 📚 Un profil technique saura s'y retrouver rapidement !


📊 Tu veux analyser tes donnĂ©es Kraaft ?

Le Kraaft Data Exchange (KDE) est fait pour ça 📊 Connecte tes donnĂ©es Ă  Power BI, Tableau ou Looker — et pilote tes projets depuis un seul outil de datavisualisation.


💬 Besoin d'aide ? Contacte notre support !

Avez-vous trouvé la réponse à votre question ?