Passer au contenu principal

🔌 Activer l'API Kraaft

Kraaft te facilite la vie pour connecter ton espace à tes autres outils et automatiser tes flux de travail : fini la double saisie, place aux connexions intelligentes 💡

Quelques exemples concrets âŹ‡ïž

  • đŸ—ïž 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

  • 💬 Envoyer automatiquement un message ou une photo dans une conversation depuis un outil tiers


☑ É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é

💡 Les droits d'une clĂ© API suivent exactement les mĂȘmes rĂŽles que dans Kraaft : Externe, Standard, Administrateur et PropriĂ©taire đŸ‘€ Chaque rĂŽle donne accĂšs Ă  un pĂ©rimĂštre diffĂ©rent de tes conversations et rapports — on dĂ©taille les subtilitĂ©s de chaque rĂŽle dans notre article "Aller plus loin avec l'API Kraaft", pour bien choisir selon ton usage.

⚠ 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 aujourd'hui

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 tes 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 ⚡

✅ Et depuis peu, tu peux aussi envoyer des messages et des fichiers (photos, documents) directement dans une conversation via l'API — pratique pour notifier une Ă©quipe terrain ou joindre un document depuis un outil tiers, sans passer par l'app đŸ“€


đŸ€– 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

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

  • 🔜 D'autres connecteurs natifs Kraaft arrivent prochainement dans d'autres outils


📖 AccĂ©der Ă  la documentation API Kraaft

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

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.


🔍 Envie d'aller plus loin ?

RĂŽles de clĂ© en dĂ©tail, rĂ©solution des ID, listes et tableaux, connexion Ă  Make/n8n
 on a rassemblĂ© toutes les subtilitĂ©s qu'on dĂ©couvre en testant l'API en profondeur dans un article complĂ©mentaire đŸ•”ïž


💬 Besoin d'aide ?

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