Klantly Developers

Make et n8n

Connectez Klantly à des centaines d'autres applications sans programmer, avec Make ou n8n.

Avec Make et n8n, vous construisez des intégrations en assemblant des blocs. Klantly fonctionne avec les deux, grâce à deux briques : un webhook pour savoir qu'il s'est passé quelque chose, et une requête HTTP pour agir dans Klantly.

Avant de commencer

Dans Klantly, créez sous Intégrations → API une clé distincte pour Make ou n8n, avec uniquement les scopes dont votre scénario a besoin. Vous pourrez ainsi la révoquer plus tard sans arrêter vos autres intégrations.

Démarrer avec un événement Klantly

Make

  1. Créez un nouveau scénario et choisissez Webhooks → Custom webhook comme premier module.
  2. Ajoutez un nouveau webhook et copiez l'adresse affichée par Make.
  3. Dans Klantly, sous Intégrations → API, onglet Webhooks, créez un endpoint avec cette adresse et choisissez les événements dont vous avez besoin.
  4. Make attend maintenant un premier message pour apprendre quelles données il contient. Déclenchez un vrai événement, par exemple en créant un client de test. Le message de test ping n'a pas la même forme que les vrais événements.

n8n

  1. Ajoutez un nœud Webhook et réglez la méthode HTTP sur POST.
  2. Utilisez la Production URL comme adresse de l'endpoint dans Klantly. La Test URL ne fonctionne que pendant que vous attendez un message de test dans l'éditeur.
  3. Activez le workflow.

L'objet figure dans le message sous data.object ; dans n8n, c'est body.data.object. Les champs disponibles sont décrits avec l'objet dans la référence de l'API. Le type d'événement figure dans type.

Attention

Make et n8n ne vérifient pas la signature de Klantly. Gardez donc l'adresse du webhook secrète : quiconque la connaît peut y envoyer des messages. Pour des actions sensibles, traitez plutôt les messages sur votre propre serveur, qui vérifie la signature. Webhooks explique comment faire.

Agir dans Klantly

Make

Utilisez le module HTTP → Make a request :

Réglage Valeur
URL par exemple https://app.klantly.com/api/v1/customers
Method POST
Headers Authorization avec la valeur Bearer kly_…
Body type Raw, avec le content type JSON (application/json)
Request content le JSON, par exemple {"email": "jan@example.com", "name": "Jan de Vries"}
Parse response activé

n8n

Utilisez le nœud HTTP Request :

  1. Sous Authentication, choisissez Generic Credential Type puis Header Auth. Créez un credential avec le nom Authorization et la valeur Bearer kly_…. Ainsi, la clé n'est pas enregistrée dans le workflow lui-même.
  2. Choisissez la méthode et l'URL, par exemple POST et https://app.klantly.com/api/v1/customers.
  3. Activez Send Body, avec JSON comme content type.

Exemple : un deal gagné dans Slack

  1. Démarrez avec un webhook pour l'événement deal.won.
  2. Récupérez le client avec une requête HTTP : GET https://app.klantly.com/api/v1/customers/<customer_id>, avec le customer_id de l'événement.
  3. Avec le module Slack, envoyez un message dans votre canal commercial, avec le titre et la valeur du deal et le nom du client.

Conseils

  • Envoyez une Idempotency-Key lors d'une création, par exemple l'id de l'événement qui a lancé le scénario. Si Make ou n8n réexécute une étape, aucun doublon n'est créé.
  • Un scénario qui traite des milliers d'enregistrements d'un coup peut atteindre les limites de débit. Faites-le attendre et réessayer en cas de 429.
  • Une erreur de Klantly a toujours un code fixe. Les codes d'erreur expliquent pour chaque code ce que vous pouvez faire.

Dernière mise à jour le 15 septembre 2026