Connectez Make et n8n à Klozeo en HTTP

Klozeo est la base de leads où vos automatisations écrivent et que votre équipe et vos assistants IA consultent.

Comment Klozeo se connecte

Il n’existe ni application Make ni nœud n8n pour Klozeo. Votre scénario Make ou votre workflow n8n envoie chaque lead avec le module HTTP de Make ou le nœud HTTP Request de n8n, avec une clé API que le client crée. Trois voies mènent à Klozeo :

Make ou n8n, en HTTP. Une requête par lead depuis le module HTTP de Make ou le nœud HTTP Request de n8n. Voir Make et n8n.
Le code, par l’API REST. En HTTP direct, ou avec les SDK TypeScript et Python. Voir API REST et SDK.
Claude et les outils de développement, par MCP. Un connecteur pour Claude, et un point d’accès MCP pour Claude Code, Cursor, Cline, Roo Code et Smithery. Voir Claude et Outils de développement.

Dans l’autre sens, les webhooks renvoient les événements de leads vers votre scénario.

Chaque plan inclut l’API, les webhooks et le connecteur Claude. Les plans diffèrent par le nombre de leads stockés, les limites, les membres et le délai de réponse du support.

Make : envoyez vos leads avec le module HTTP

Dans votre scénario, ajoutez le module HTTP de Make, « Make a request », et envoyez un POST par lead.

URL : POST https://api.klozeo.com/api/v1/leads
Authentification : une clé API dans l’en-tête X-API-Key, avec la clé du client
Corps : application/json. Envoyez au moins un nom et une source, plus une clé de correspondance : l’e-mail, le SIREN si vous l’avez, ou votre propre source_id.

Ici, source_id reprend l’identifiant d’une ligne du Google Sheet du client.

POST https://api.klozeo.com/api/v1/leads
X-API-Key: <la clé API du client>
Content-Type: application/json

{
  "name": "Atelier Démo",
  "source": "make",
  "email": "[email protected]",
  "source_id": "gsheet-0042"
}

La réponse est un accusé de réception avec l’id du lead. Pour lire la fiche, appelez GET /leads/{id}.

Statut	Ce qui s’est passé
201	Klozeo a créé le lead.
200	Le lead correspondait à un lead existant sur une clé de correspondance. Klozeo l’a mis à jour et renvoie `"duplicate": true` et le même id.

Ouvrir le guide Make

n8n : envoyez vos leads avec le nœud HTTP Request

Dans votre workflow, utilisez le nœud HTTP Request de n8n avec l’authentification Header Auth. Envoyez un POST par lead à https://api.klozeo.com/api/v1/leads, avec la clé API dans l’en-tête X-API-Key et un corps JSON qui contient au moins un nom et une source, plus une clé de correspondance : l’e-mail, le SIREN si vous l’avez, ou votre propre source_id. Klozeo répond 201 quand il crée le lead et 200 quand il met à jour celui qui correspond.

Exemple : votre workflow envoie la ligne du Google Sheet du client pour [email protected], ville Lyon. Plus tard, la ligne indique Paris et le workflow l’envoie de nouveau. Klozeo reconnaît l’e-mail, met à jour le même lead avec Paris et répond 200 avec le même id.

Ouvrir le guide n8n

Ce que votre client prépare d’abord

Le client possède le compte Klozeo : quelques étapes passent donc avant que votre scénario puisse écrire.

Le client crée son compte. À l’inscription, le premier espace de travail bénéficie de 14 jours de Pro, sans carte bancaire.
Le client crée une clé API et vous la confie pour le scénario. Le propriétaire ou un admin crée les clés API. Une clé à accès complet agit avec les droits du propriétaire : gardez-la dans les identifiants du scénario, pas dans un message ni un e-mail.
Si votre scénario écoute des événements, le client ajoute le webhook. Le propriétaire ou un admin crée les webhooks.
Le client vous invite comme éditeur, depuis « Équipe », pour que vous voyiez et corrigiez les leads. L’invitation expire au bout de sept jours et ne sert qu’une fois. Avec le même identifiant, vous acceptez l’invitation de chaque client et vous changez d’espace de travail dans le tableau de bord.

Les invitations fonctionnent en Pro, en Scale et pendant l’essai ; un compte Free n’a qu’un utilisateur. Si l’essai se termine sans abonnement, rien n’est supprimé, les membres invités peuvent lire mais pas modifier, et la clé API continue d’écrire.

Pas à pas pour le client : Support

Webhooks : renvoyez les événements vers le scénario

Un webhook envoie des événements de leads vers une URL, pour que votre scénario réagisse quand un lead change. Chaque webhook s’abonne aux événements qu’il choisit :

lead.created
lead.updated (une fusion envoie lead.updated)
lead.scored
lead.deleted
les formes groupées de ces événements
les événements de notes

Nouvelles tentatives. Klozeo retente une livraison échouée, jusqu’à 10 tentatives sur environ 24 heures.

Qui les gère. Le propriétaire ou un admin crée, modifie ou met en pause un webhook, et peut renvoyer une livraison échouée dans les 72 heures.

Pause. Un webhook en pause enregistre ses événements comme échoués au lieu de les garder. Quand le propriétaire le réactive, il ne livre que les nouveaux événements.

Signature. Un webhook vers une URL qui vous appartient est signé quand il a un secret : chaque livraison porte un en-tête Klozeo-Signature horodaté, et le secret peut être changé. Dans le tableau de bord, le champ « Secret de signature » est obligatoire pour chaque nouveau webhook vers votre propre URL. Par l’API, définissez un secret pour obtenir des livraisons signées. Les webhooks vers une URL Discord ou Slack ne sont pas signés.

Référence des webhooks (en anglais)

API REST et SDK, pour le code

Depuis votre code, appelez le même endpoint : l’API REST, ou les SDK TypeScript et Python. Les endpoints de lot créent, mettent à jour et suppriment plusieurs leads en une requête. Un 207 signifie que certains éléments ont échoué et que les autres sont enregistrés. La suppression en lot est réservée au propriétaire.

Les limites dépendent du plan :

Plan	Requêtes par 10 minutes	Taille d’un lot	Clés API
Free	250	100	10
Pro	2 500	500	25
Scale	5 000	500	50

Claude : lisez et mettez à jour vos leads dans vos espaces

Connectez Claude : il lit les leads, notes, statistiques, catégories, villes et statuts d’un ou plusieurs espaces de travail, choisis à la connexion.

Écrire demande un second consentement et un rôle propriétaire, admin ou éditeur dans chaque espace choisi. Claude peut modifier un lead, ajouter un tag ou une note et créer des leads. Définir les tags d’un lead remplace la liste. Il ne supprime pas de leads.

Pour déconnecter Claude, ouvrez « MCP », puis « Applications connectées », dans le tableau de bord. L’accès s’arrête à la requête suivante.

Claude sur le web : connecter Klozeo

Claude Code, Cursor et autres outils de développement

Claude Code, Cursor, Cline, Roo Code et Smithery se connectent à https://mcp.klozeo.com/mcp avec une clé API. Le propriétaire ou un admin crée la clé sous « Clés API » ; la révoquer déconnecte le client.

Questions sur la connexion

Existe-t-il une application Make ou un nœud n8n natif ?

Non. Make appelle Klozeo par son module HTTP, et n8n par son nœud HTTP Request, avec votre clé API. Les guides pas à pas existent en français et en anglais.

Quels champs permettent de reconnaître un lead envoyé de nouveau ?

Klozeo compare d’abord l’e-mail (sans tenir compte de la casse), puis le SIREN, puis votre propre source_id, puis un numéro de téléphone identique associé à un nom similaire à plus de 80 %. La comparaison reste dans un seul compte.

Que se passe-t-il si je relance un scénario sans clé de correspondance ?

Un lead envoyé sans e-mail, SIREN, source_id ni téléphone crée un nouvel enregistrement : la relance l’ajoute donc de nouveau. Un nom et une ville identiques signalent seulement un doublon possible.

Mon scénario écrase-t-il les modifications du client ?

Il peut en écraser. Une fusion conserve le nom, le statut, les coordonnées GPS (latitude, longitude) et l’indicateur « Ne pas contacter », ajoute les nouveaux tags et ignore les champs verrouillés. Chaque autre champ que vous envoyez avec une valeur, téléphone, e-mail et site web compris, remplace la valeur enregistrée, sauf s’il est verrouillé ; un champ que vous omettez ou envoyez vide reste inchangé. Pour garder les modifications du client, verrouillez ces champs sur le lead, sous « Verrous de champ ». Un verrou sur un champ natif fait que les fusions et les imports suivants le laissent intact ; une mise à jour explicite l’écrit quand même. Les verrous se posent lead par lead, et les attributs personnalisés ne peuvent pas être verrouillés. « Ne pas contacter » survit à toute fusion et à tout import : seule une action explicite et enregistrée le lève, et votre scénario d’envoi doit quand même le vérifier.

Puis-je utiliser ChatGPT ?

L’application ChatGPT n’est pas encore disponible.

Créer un compte

À l’inscription : 14 jours de Pro sur votre premier espace de travail, sans carte bancaire.