❓ Questions fréquentes

Retrouvez toutes les réponses à vos questions sur Kis et les automatisations.

Kis est présent sur différentes plateformes :

• Make : https://www.make.com/en/integrations/kis ;

• Zapier : https://zapier.com/apps/kis/integrations ;

• n8n : https://n8n.io/integrations/kis/ ;

• Power Automate : en cours de développement.

Les webhooks fonctionnent-ils en mode Push ou en mode Pull ?

Pour rappel, le mode Push signifie que Kis envoie l'événement vers un système dès qu'il se produit. Et, à l'inverse, le mode Pull implique que le système interroge l'API de Kis régulièrement

Les webhooks de Kis fonctionnent en Push. Toutefois, Kis possède également une API qui permet de récupérer les données (Pull).

Existe-t-il une liste des événements déclenchables via webhook ?

Kis ne repose pas sur une liste d’événements métier standardisés car la plateforme est entièrement configurable en fonction des cas d’usage.

Concrètement, les événements déclencheurs correspondent aux actions sur les données (création, modification, suppression) au sein des listes de données configurées pour votre projet.

Prenons l'exemple d'une Liste qui s'appelle "Note de frais”. Il est donc possible de mettre en place un déclencheur dès qu'une note de frais est créée.

Le payload contient l’élément qui a déclenché le webhook. Dans notre exemple, il contiendra les informations de la note de frais.

Lors de la mise en place d'une automatisation pour une micro-application, nous définissons ensemble :

• Les événements à surveiller. Par exemple, la création d’un adhérent, un changement de statut ou encore la validation d’une étape ;

• Les données à transmettre ;

• Le format de la donnée : texte, nombre, date, etc.

Cela permet de créer des automatisations parfaitement alignées avec votre modèle métier et non pas un schéma générique figé.

En cas d'échec d'un webhook, Kis rejoue-t-il automatiquement la requête ?

Kis n’intègre pas de mécanisme natif de retry ou de logs pour les webhooks.

Ces aspects peuvent être gérés directement via la plateforme que vous utilisez (Zappier, Make, n8n) qui permet de configurer les retries, délais, et d’avoir accès à un historique complet des exécutions pour assurer la fiabilité des flux.

Les événements webhook sont-ils granulaires ?

Les automatisations peuvent être configurées de manière granulaire. C'est-à-dire de créer un webhook distinct par type d'événement métier.

Concrètement, il est possible de définir des déclencheurs distincts selon le type d’événement surveillé dans Kis (par exemple, la création d’une donnée, la modification d’un champ ou un changement de statut), puis d'orienter chaque flux vers le traitement approprié dans la plateforme d'automatisation utilisée.

L'API est-elle versionnée ?

Oui, l’API Kis est versionnée. Plus clairement, si Kis évolue, vos automatisations existantes continuent de fonctionner sans modification.

Cela permet de maintenir la compatibilité des intégrations existantes. Les mises à jour majeures de Kis peuvent nécessiter des modifications dans les outils connectés.

Existe-t-il un environnement de test avec la même API et les mêmes webhooks que la production, afin de tester sans modifier les données réelles ?

Il n’y a pas d’environnement sandbox à proprement parlé.

Mais il est possible de réaliser tous les tests nécessaires sur un environnement isolé, avec une base dédiée (ou non), permettant de valider les automatisations sans impacter les données de production.

Y a-t-il une limite sur le nombre de webhooks que Kis peut envoyer par minute ou par heure ?

Pour le moment, il n’y a pas de limite de type rate limiting (nombre de requêtes ou d’événements par minute/heure).

En pratique, les flux peuvent être dimensionnés via la plateforme d'automatisation afin de lisser la charge (batch, files d’attente, retries), notamment lors de volumes importants.

Si nécessaire, des garde-fous peuvent être mis en place pour s’adapter aux contraintes de performance.