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
đ RĂ©cupĂ©rer les messages d'une conversation pour alimenter ton planning de chantiers
âïž Ă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 đ ïž
Va dans le Menu â ParamĂštres de ton espace
Clique sur l'onglet ClĂ©s API đ
Clique sur "CrĂ©er une clĂ© API" â
Donne-lui un nom parlant (ex : "Make - ERP" ou "Zapier - Archivage") đ
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 đ )
đ Tu dĂ©veloppes une application oĂč chaque utilisateur connecte son propre compte Kraaft ? L'API accepte aussi l'OAuth 2.0, en plus de la clĂ© API
đŠ Ce qu'on peut faire avec l'API Kraaft aujourd'hui
L'API Kraaft te donne accĂšs Ă 6 ressources đïž
đïž Workspaces â lister les espaces accessibles avec ta clĂ©
đ Schemas â lire la structure de tes rapports pour savoir quoi envoyer et recevoir
đ Records â lister, lire, crĂ©er et modifier tes rapports
đŹ Conversations â lire, crĂ©er, archiver une conversation et gĂ©rer ses membres
đš Messages â envoyer des messages et des fichiers (photos, documents) dans une conversation, et lire l'historique des messages
⥠Events â dĂ©tecter en temps rĂ©el tout ce qui se passe sur tes rapports et tes messages
⥠Zoom sur les Events
Kraaft tient un journal de tout ce qui se passe đ Chaque rapport créé, modifiĂ©, supprimĂ© ou restaurĂ© et chaque message envoyĂ©, 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, ou ton planning rĂ©cupĂšre chaque nouvelle info postĂ©e dans une conversation de chantier âĄ
đ€ 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 â installe l'app Kraaft directement depuis make.kraaft.co : la connexion se fait en OAuth, en un clic, sans copier de clĂ© Ă la main
đ§ n8n, Zapier et autres â utilise les modules HTTP ou requĂȘte API de ton outil pour appeler l'API Kraaft avec ta clĂ©
đ 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.
đ DĂ©couvrir le KDE
đ§ Tu veux utiliser Kraaft depuis un assistant IA ?
L'API est faite pour connecter des outils entre eux, de façon automatique đ§ Pour poser des questions sur tes donnĂ©es Kraaft ou demander une action en langage naturel depuis Claude, ChatGPT ou un autre assistant IA, utilise plutĂŽt le MCP Kraaft đ€
đ Envie d'aller plus loin ?
Lire les messages d'une conversation, clĂ© API ou OAuth, rĂŽles de clĂ© en dĂ©tail, rĂ©solution des ID, listes et tableaux, filtrage et temps rĂ©el⊠on a rassemblĂ© toutes les subtilitĂ©s de l'API dans un article complĂ©mentaire đ”ïž
đ Besoin d'aide ?
Si tu as des questions Contacte nous !
