Mise en place
Les webhooks permettent à des outils externes — formulaires en ligne, plateformes d'automatisation (Zapier, Make), systèmes de notification ou scripts personnalisés — de créer des cartes dans votre tableau via une simple requête HTTP. Pour activer la fonctionnalité, allez dans Outils du tableau > Intégrations et cliquez sur Webhooks > Configuration :
Dans la boîte de dialogue qui s'ouvre, activez la fonctionnalité et donnez un nom à votre webhook. Un identifiant unique (slug) est généré automatiquement — il fait partie de l'URL de votre webhook. Vous pouvez le régénérer ou le personnaliser si vous le souhaitez :
Une fois activé, l'URL de votre webhook est affichée et prête à l'emploi. Elle ressemble à ceci :
https://votreprojet.klaro.cards/w/votre-slug-ici
Copiez-la à l'aide du bouton de copie, ou récupérez l'un des extraits de code prêts à l'emploi affichés sous l'URL.
Envoyer des données à votre webhook
Envoyez une requête POST avec un corps JSON à l'URL de votre webhook. Gardez cette URL privée — le slug fait office de secret.
Voici un exemple avec curl :
curl -X POST 'https://votreprojet.klaro.cards/w/votre-slug-ici' \
-H 'Content-Type: application/json' \
-d '{
"title": "Le titre de ma carte"
}'
La plupart des plateformes d'automatisation (Zapier, Make, n8n, etc.) disposent d'actions HTTP/webhook intégrées — il vous suffit d'y coller votre URL et de configurer le corps JSON.
Vous pouvez envoyer n'importe quelle structure JSON — le contenu est transformé en carte grâce à l'expression Elo que vous configurez dans l'onglet Traitement.
Définir les valeurs des dimensions (Traitement)
L'onglet Traitement vous permet d'écrire une expression Elo qui transforme le contenu JSON reçu en carte. L'expression reçoit le contenu sous la variable _ et doit retourner un Tuple dont les clés sont les codes de vos dimensions et les valeurs sont les valeurs de ces dimensions.
Exemple simple
Si votre système externe envoie { "name": "Rapport de bug", "body": "La connexion ne fonctionne plus" }, vous pouvez le transformer en carte comme ceci :
{
title: _.name,
specification: _.body
}
Utiliser des conditions
Vous pouvez inclure des conditions pour catégoriser automatiquement les cartes. Par exemple, si vous avez une dimension Priorité :
{
title: _.name,
specification: _.body,
priority: if contains(_.name, 'urgent') then 'High' else 'Normal'
}
Créer plusieurs cartes
Votre expression Elo peut aussi retourner un tableau pour créer plusieurs cartes à partir d'un seul appel webhook :
[
{ title: _.primary, specification: _.details },
{ title: concat('Suivi : ', _.primary) }
]
Trouver les codes des dimensions
Pour les clés de votre tuple Elo, utilisez les codes des dimensions et de leurs valeurs, tels qu'affichés dans l'écran de configuration de chaque dimension :
Aller plus loin avec Elo
Elo prend en charge la manipulation de dates, de chaînes de caractères, et bien plus encore. Consultez la référence complète du langage Elo pour découvrir toutes les fonctions disponibles.
Filtres du tableau
Comme partout dans Klaro Cards, les filtres du tableau fournissent des valeurs par défaut aux nouvelles cartes. Si votre tableau a des filtres actifs (par exemple, un Type ou une Langue spécifique), les cartes créées par webhook hériteront automatiquement de ces valeurs — aucune configuration supplémentaire n'est nécessaire.
Questions fréquentes
-
Que se passe-t-il si mon webhook est désactivé ?
Les requêtes sont ignorées silencieusement. Réactivez le webhook dans la boîte de dialogue de configuration pour reprendre le traitement.
-
Que se passe-t-il si mon expression Elo contient une erreur ?
La carte ne sera pas créée. Vérifiez votre syntaxe Elo et testez d'abord avec une expression simple comme
{ title: _.title }. -
Puis-je créer des cartes sur plusieurs tableaux ?
Oui — configurez un webhook distinct sur chaque tableau. Chaque tableau a son propre slug et sa propre expression Elo.