Questions fréquentes

Général

Qu’est-ce que Klozeo ? Klozeo est la base de leads où vos automatisations écrivent et que votre équipe et vos assistants IA consultent. Vous stockez, scorez, filtrez et interrogez vos leads professionnels via l’API REST ou en langage naturel avec des clients IA compatibles MCP (Claude, Cursor, Cline, etc.).

Quelle est la différence entre updated_at et last_interaction_at ?

• updated_at : ne change que lorsqu’un champ structurel (name, email, city, etc.) est modifié.
• last_interaction_at : est mis à jour à chaque push API, y compris lors des fusions où aucun champ n’a changé.

Utilisez last_interaction_at pour trier par « fraîcheur d’intérêt », indépendamment des modifications de données.

Les horodatages sont-ils en millisecondes ou en secondes ? Tous les horodatages sont en secondes Unix (pas en millisecondes). En JavaScript : new Date(timestamp * 1000).

Authentification

Où obtenir une clé API ? Connectez-vous sur klozeo.com/dashboard, puis API Keys → Add new. La clé brute n’est affichée qu’une fois : copiez-la immédiatement.

Et si je n’ai pas copié ma clé API à temps ? Supprimez la clé depuis le tableau de bord et créez-en une nouvelle : cela prend 10 secondes.

Puis-je avoir plusieurs clés API ? Oui. Créez autant de clés que nécessaire (par exemple une par intégration). Vous pouvez révoquer une clé individuellement sans affecter les autres.

Que devient une clé révoquée ? Elle est supprimée immédiatement et cesse de fonctionner partout. Seuls son nom et ses dates de création et de révocation sont conservés, pour votre piste d’audit, jusqu’à la suppression de votre compte.

Comment supprimer mon compte ? Tableau de bord → Settings → Delete account, puis confirmez avec votre mot de passe. Votre compte et toutes ses données (leads et leur historique, règles de scoring, clés API, webhooks, membres d’équipe et invitations) sont supprimés et votre abonnement est annulé. Les factures déjà émises sont conservées par Stripe pour la comptabilité.

Leads

Que se passe-t-il quand j’envoie un lead en doublon ? Klozeo compare chaque nouveau lead à vos leads existants par email, puis par SIREN, puis par source_id, puis par téléphone avec un nom similaire, et le fusionne dans la première correspondance. Un même nom et une même ville ne font que signaler un doublon possible. Voir le guide du dédoublonnage.

La création par lot applique-t-elle le dédoublonnage ? Oui : POST /leads/batch applique le même dédoublonnage élément par élément que POST /leads seul. Les doublons sont fusionnés et renvoyés comme des succès avec duplicate: true ; les fusions ne consomment pas de place dans votre limite de leads. Voir Opérations par lot et Déduplication.

Quelle est la limite du plan Free ? Les comptes Free ont un utilisateur, peuvent stocker jusqu’à 2 500 leads et effectuer 250 requêtes API toutes les 10 minutes. Pro coûte $30 (€30 dans la zone euro) par mois pour 50 000 leads et 2 500 requêtes/10 min. Scale coûte $80 (€80) par mois pour 250 000 leads et 5 000 requêtes/10 min. Les prix sont hors taxes et par espace de travail, sièges d’équipe inclus.

Puis-je importer des leads en masse ? Oui : utilisez POST /leads/batch (jusqu’à 100 en Free, 500 en Pro et Scale) ou importez un fichier CSV ou JSON depuis le tableau de bord.

Que se passe-t-il si j’atteins la limite de leads ? Les nouveaux leads renvoient 403 leads_limit_reached. Les leads existants et toutes les autres opérations continuent normalement. Passez à Pro pour augmenter votre limite.

MCP

Quels clients IA sont pris en charge ? Claude Desktop, Claude Code, Cursor, Cline, Roo Code, Smithery et Goose. Tout client compatible MCP qui prend en charge les transports HTTP ou SSE fonctionne.

Dois-je partager ma clé API avec le client IA ? Pour la plupart des clients (Claude Code, Cursor, Cline, Goose) : non, un flux d’autorisation dans le navigateur génère et enregistre la clé automatiquement. Claude Desktop exige actuellement une clé manuelle dans sa configuration.

Tarifs et facturation

Une carte bancaire est-elle requise ? Non. Chaque nouveau compte commence par un essai Pro de 14 jours, sans informations de paiement. Les paramètres et la barre latérale du tableau de bord affichent les jours restants, et le propriétaire du compte reçoit un email 3 jours puis 1 jour avant la fin de l’essai.

Que se passe-t-il à la fin de l’essai ? Sauf si vous passez à un plan payant, le compte bascule en Free. Rien n’est supprimé. Les leads restent lisibles. Dans un espace Free modifiable, le propriétaire peut toujours modifier les leads existants, mais ne peut pas en ajouter au-delà de 2 500. Les membres invités conservent un accès en lecture seule et vous ne pouvez pas en inviter de nouveaux. Si vous passez à un plan payant plus tard, les membres retrouvent leurs rôles. Si vous possédez plusieurs espaces Free, un seul reste modifiable. → Quand un espace Free passe en lecture seule

Comment passer de Free à Pro ? Sélectionnez l’espace de travail, ouvrez les Réglages de votre tableau de bord et cliquez sur « Passer à Pro ». Seul le propriétaire de l’espace de travail peut l’abonner, et chaque espace de travail dont vous êtes propriétaire a son propre plan et son propre abonnement, qui vous est facturé. Vous êtes redirigé vers le paiement Stripe. Si un nouveau paiement Stripe s’ouvre, le précédent est annulé et ne peut plus être réglé. Votre plan est activé dès que Stripe confirme le paiement, généralement en quelques secondes ; en attendant, les Réglages affichent « Paiement reçu, activation de votre plan… ».

Quelles sont les différences entre Free et Pro ? Free : un utilisateur, 2 500 leads, 250 requêtes API toutes les 10 minutes. Pro : sièges d’équipe, 50 000 leads, 2 500 requêtes toutes les 10 minutes ($30 ou €30 par mois, hors taxes). Scale : 250 000 leads, 5 000 requêtes toutes les 10 minutes ($80 ou €80 par mois, hors taxes).

Les prix incluent-ils la TVA ? Non. Les prix sont hors taxes : €30 et €80 par mois dans la zone euro, $30 et $80 ailleurs. Le paiement demande votre adresse de facturation et ajoute la TVA lorsqu’elle s’applique, par exemple 20 % pour un client en France. Une entreprise de l’UE hors de France peut saisir son numéro de TVA au moment du paiement : la TVA est alors autoliquidée et non ajoutée. Les factures indiquent le montant de TVA, notre numéro de TVA et le vôtre si vous en avez saisi un.

Qu’est-ce que le prix fondateur ? Tant que l’offre fondateur est ouverte, le paiement applique un prix fondateur aux plans Pro et Scale pour votre premier espace de travail ; les premiers abonnés obtiennent le tarif le plus bas. Vous le conservez tant que votre abonnement reste actif, y compris lorsque vous passez de Pro à Scale ou inversement. Il prend fin si vous résiliez : si vous vous abonnez de nouveau plus tard, vous payez le prix normal, même tant que l’offre est ouverte. Un paiement non terminé conserve votre place jusqu’à son expiration, au bout d’une heure ; ouvrir un nouveau paiement remplace le précédent. Vos autres espaces de travail paient le prix standard.

Puis-je résilier mon abonnement ? Oui, à tout moment depuis Réglages → Gérer la facturation, qui liste tous les abonnements que vous payez. Résiliez celui de l’espace de travail concerné. Vous conservez le plan payant de cet espace de travail jusqu’à la fin de la période de facturation, puis il bascule en Free (sans retour à un essai). Si vous possédez alors plusieurs espaces Free, un seul reste modifiable. Vos factures restent disponibles depuis Réglages → Gérer la facturation après le retour d’un espace de travail en Free.

Que se passe-t-il si un paiement échoue ? Vous conservez votre plan pendant que Stripe retente le paiement, et vous pouvez mettre à jour votre carte depuis Réglages → Gérer la facturation. Tant que le paiement n’aboutit pas, changer de plan dans les Réglages de cet espace de travail ouvre aussi Gérer la facturation : vous réglez ainsi le paiement avant de changer de plan et n’êtes jamais facturé deux fois pour le même espace de travail. Si les tentatives échouent et que Stripe met fin à l’abonnement, cet espace de travail revient en Free : les leads existants sont conservés, mais aucun nouveau lead ne peut être ajouté au-delà de 2 500, et les membres invités passent en lecture seule. Si vous possédez plusieurs espaces Free, un seul reste modifiable, y compris pour le propriétaire et les clés API.

Quels moyens de paiement sont acceptés ? Cartes de crédit et de débit via Stripe (Visa, Mastercard, American Express).