Vous souhaitez ajouter automatiquement vos nouveaux prospects dans Klape depuis votre CRM, votre site internet ou un formulaire publicitaire ?

Klape dispose d’une API permettant de connecter des outils d’automatisation comme Make, Zapier et n8n.

Grâce à cette API, vous pouvez créer automatiquement des contacts dans Klape et, si vous le souhaitez, les attribuer directement à une campagne pour déclencher leur prise de contact par l’intelligence artificielle.

Ce guide explique comment générer votre clé API, configurer une connexion et résoudre les problèmes les plus fréquents.

1. À quoi sert l’API Klape ? #

L’API permet à une application externe de communiquer avec Klape pour effectuer certaines opérations automatiquement.

Vous pouvez notamment l’utiliser pour :

• Ajouter un prospect provenant d’un formulaire de votre site internet.
• Importer automatiquement les contacts issus d’un CRM.
• Transmettre les prospects collectés par vos campagnes publicitaires.
• Créer des contacts depuis une automatisation Make, Zapier ou n8n.
• Ajouter directement un nouveau contact à une campagne Klape.
• Vérifier la connexion à votre compte.
• Récupérer la liste de vos campagnes et leurs identifiants.

Exemple concret #

Vous diffusez une publicité sur Facebook pour obtenir des demandes de renseignements.

Un internaute remplit votre formulaire.

Grâce à une automatisation, ses coordonnées sont transmises à Klape.

Si vous avez indiqué la campagne à utiliser, le prospect est automatiquement ajouté à celle-ci.

L’intelligence artificielle peut alors commencer sa séquence de prise de contact, dans le respect des horaires configurés.

Vous n’avez donc pas besoin d’importer manuellement chaque nouveau prospect.

2. Où trouver l’API dans Klape ? #

La configuration de l’API est accessible depuis votre espace utilisateur.

Procédure #

1. Connectez-vous à Klape.
2. Rendez-vous dans Paramètres.
3. Ouvrez API & Intégrations.
4. Sélectionnez l’onglet API.

Cette rubrique permet de gérer votre clé API et de consulter la documentation technique disponible dans Klape.

Vous y trouverez également des exemples pour connecter des outils externes.

3. Comment générer une clé API Klape ? #

La clé API permet à votre outil externe de s’authentifier auprès de Klape.

Elle doit être utilisée comme un identifiant confidentiel.

Étapes #

1. Rendez-vous dans Paramètres → API & Intégrations → API.
2. Cliquez sur Générer une clé si aucune clé n’est encore disponible.
3. Récupérez la clé créée.
4. Renseignez-la dans l’outil que vous souhaitez connecter.

Cette clé sera utilisée pour autoriser les requêtes envoyées à Klape.

Comment protéger votre clé API ? #

Votre clé API est confidentielle.

Pour éviter tout accès non autorisé :

• Ne la partagez pas publiquement.
• Ne l’ajoutez pas dans le code visible d’un site internet.
• Ne la transmettez pas à vos prospects.
• Ne la publiez pas dans une documentation accessible au public.
• Évitez de l’envoyer par email ou dans une capture d’écran.
• Stockez-la uniquement dans les paramètres sécurisés de vos outils d’automatisation.

Important : une personne disposant de votre clé API pourrait effectuer les opérations autorisées par cette clé sur votre compte Klape.

4. Quelles informations sont nécessaires pour se connecter à l’API ? #

L’API Klape utilise une authentification par clé API.

Les requêtes doivent utiliser les informations suivantes :

Remplacez VOTRE_CLE_API par la clé générée depuis votre compte Klape.

Exemple d’authentification #

Dans l’en-tête HTTP Authorization, la valeur doit commencer par le mot Bearer, suivi d’un espace et de votre clé.

Par exemple :

Bearer VOTRE_CLE_API

Attention : ne renseignez pas seulement la clé sans le préfixe Bearer lorsque votre outil attend l’en-tête complet.

Certains outils disposent d’un champ « Bearer Token » qui ajoute automatiquement le préfixe. Dans ce cas, renseignez uniquement la clé dans ce champ.

5. Comment vérifier que ma clé API fonctionne ? #

Avant de créer une automatisation complète, nous vous recommandons de vérifier la connexion.

Klape propose un endpoint permettant de tester l’authentification :

GET /api/v1/me

L’URL complète est :

Comment effectuer le test ? #

Dans Make, Zapier, n8n ou un autre outil HTTP compatible :

1. Créez une nouvelle requête HTTP.
2. Sélectionnez la méthode GET.
3. Renseignez l’URL de test.
4. Ajoutez votre clé API dans l’authentification Bearer.
5. Exécutez la requête.

Si la requête réussit, cela confirme que votre outil peut s’authentifier auprès de Klape.

Si elle échoue, vérifiez votre clé et les paramètres de connexion avant de poursuivre.

6. Comment créer automatiquement un contact avec l’API ? #

Klape propose un endpoint permettant de créer un contact depuis une application externe.

POST /api/v1/contacts

URL complète :

La requête doit contenir les informations du contact au format JSON.

Champs disponibles #

Exemple de données #

Pour créer un contact, vous pouvez transmettre un objet JSON comme celui-ci :

{"first_name":"Julie","last_name":"Martin","email":"julie.martin@example.com","phone":"0612345678"}

Cet exemple crée un contact dans votre base Klape sans l’attribuer à une campagne.

Le contact est-il immédiatement relancé ? #

Non, si vous ne précisez aucune campagne.

Un contact créé avec l’API, mais sans campaign_uuid, est simplement ajouté à votre base de contacts.

Pour déclencher ses communications automatiques, vous devrez ensuite l’ajouter à une campagne depuis Klape.

7. Comment ajouter automatiquement un contact à une campagne ? #

L’API permet également d’associer un nouveau contact directement à une campagne Klape.

Pour cela, ajoutez le champ :

campaign_uuid

Ce champ doit contenir l’identifiant unique de la campagne concernée.

Exemple #

Vous souhaitez créer un nouveau prospect et l’ajouter directement à votre campagne commerciale.

Votre requête contient :

{"first_name":"Julie","last_name":"Martin","email":"julie.martin@example.com","phone":"0612345678","campaign_uuid":"IDENTIFIANT_UUID_DE_LA_CAMPAGNE"}

Remplacez IDENTIFIANT_UUID_DE_LA_CAMPAGNE par le véritable UUID récupéré depuis Klape.

Que se passe-t-il ensuite ? #

Lorsque le contact est créé et attribué à la campagne :

1. Il apparaît dans la campagne concernée.
2. Sa séquence est initialisée automatiquement.
3. Klape prépare sa prise de contact selon les instructions de la campagne.
4. Le premier message est envoyé par email lorsque les conditions d’envoi le permettent.

Important : attribuer une campagne via l’API déclenche le démarrage automatique de la séquence.

Avant d’activer une automatisation, vérifiez donc les instructions de votre campagne et vos horaires de communication.

8. Comment récupérer l’identifiant d’une campagne ? #

L’API Klape permet de récupérer la liste des campagnes disponibles sur votre compte.

Pour cela, utilisez :

GET /api/v1/campaigns

URL complète :

Cette requête permet de retrouver les campagnes et leurs identifiants UUID.

Pourquoi utiliser l’UUID ? #

L’API n’utilise pas simplement le nom commercial de votre campagne pour attribuer un contact.

Elle utilise son identifiant unique.

Par exemple, une campagne intitulée « Nouveaux prospects » possède un UUID qui permet de l’identifier précisément.

Vous devez renseigner cet UUID dans le champ campaign_uuid lors de la création du contact.

Peut-on automatiser la sélection de la campagne ? #

Oui.

Dans un outil comme Make ou n8n, vous pouvez utiliser les informations récupérées par l’API pour déterminer l’identifiant de la campagne dans laquelle créer un nouveau contact.

Vous pouvez aussi conserver l’UUID d’une campagne précise dans votre automatisation lorsque votre objectif est toujours d’ajouter les prospects à cette même campagne.

9. Comment connecter Klape à Make ? #

Make est un outil d’automatisation permettant de faire communiquer plusieurs applications.

Vous pouvez utiliser son module HTTP pour envoyer des contacts à Klape.

Étape 1 — Créer un scénario #

Dans Make, créez un nouveau scénario.

Ajoutez d’abord le module qui récupère vos prospects.

Il peut s’agir, par exemple :

• D’un formulaire de votre site.
• D’une source de leads publicitaires.
• D’un outil CRM.
• D’une application disposant d’un connecteur Make.

Étape 2 — Ajouter le module HTTP #

Ajoutez un module HTTP → Make a request.

Configurez les informations suivantes :

Si vous utilisez les en-têtes personnalisés, renseignez également Content-Type: application/json et Accept: application/json.

Étape 3 — Associer les champs #

Associez les données provenant de votre formulaire ou CRM aux champs Klape :

Les noms exacts des champs provenant de votre application source peuvent varier.

Étape 4 — Tester le scénario #

Effectuez un test avec un contact dont l’adresse email n’existe pas encore dans Klape.

Pour un premier test sans envoi de message, vous pouvez ne pas renseigner campaign_uuid.

Vérifiez ensuite que le contact apparaît dans Contacts.

Étape 5 — Activer l’automatisation #

Une fois la connexion validée, vous pouvez activer votre scénario.

Les nouveaux prospects transmis par la source pourront être créés automatiquement dans Klape.

10. Comment connecter Klape à Zapier ? #

Zapier permet également de transmettre automatiquement des contacts à Klape grâce à une requête HTTP.

Étape 1 — Créer un Zap #

Dans Zapier, créez un nouveau Zap.

Sélectionnez l’événement qui doit déclencher l’automatisation.

Par exemple, la création d’un nouveau prospect dans votre CRM ou la réception d’un formulaire.

Étape 2 — Ajouter Webhooks by Zapier #

Ajoutez une action Webhooks by Zapier.

Sélectionnez Custom Request.

Étape 3 — Configurer la requête #

Renseignez :

• Méthode : POST.
• URL : https://ai.klape.io/api/v1/contacts.
• En-tête Authorization : Bearer VOTRE_CLE_API.
• Content-Type : application/json.
• Accept : application/json.

Dans le corps de la requête, transmettez les données du prospect au format JSON.

Associez les champs de votre application source aux champs attendus par Klape.

Étape 4 — Ajouter la campagne si nécessaire #

Si vous souhaitez que Klape commence automatiquement les relances, ajoutez le champ campaign_uuid avec l’identifiant de votre campagne.

Sans ce champ, le contact est seulement créé dans la base Klape.

Étape 5 — Tester et activer #

Lancez le test proposé par Zapier.

Vérifiez que le nouveau contact est bien présent dans Klape.

Une fois le fonctionnement confirmé, activez votre Zap.

À noter : l’accès aux fonctionnalités Webhooks de Zapier peut dépendre de votre abonnement Zapier.

11. Comment connecter Klape à n8n ? #

n8n est une autre solution d’automatisation compatible avec les requêtes HTTP.

Vous pouvez connecter n8n à Klape grâce au nœud HTTP Request.

Procédure #

1. Créez un workflow dans n8n.
2. Ajoutez le déclencheur correspondant à votre source de prospects.
3. Ajoutez un nœud HTTP Request.
4. Sélectionnez la méthode POST.
5. Renseignez l’URL https://ai.klape.io/api/v1/contacts.
6. Configurez l’authentification Bearer avec votre clé API.
7. Activez l’envoi d’un corps JSON.
8. Associez les champs du prospect.
9. Ajoutez campaign_uuid si vous souhaitez attribuer automatiquement une campagne.
10. Testez le workflow avant son activation.

Exemple d’utilisation #

Vous pouvez déclencher ce workflow lorsqu’un nouveau prospect apparaît dans votre CRM.

n8n récupère ses coordonnées et les transmet automatiquement à Klape.

Si une campagne est indiquée, Klape peut alors commencer sa séquence de prise de contact.

12. Peut-on importer plusieurs contacts en une seule requête ? #

Oui.

L’API Klape permet de créer plusieurs contacts dans une même requête.

Pour cela, utilisez toujours :

POST /api/v1/contacts

Mais transmettez cette fois une liste de contacts dans un tableau contacts.

Combien de contacts peut-on envoyer ? #

L’API accepte des lots de 1 à 100 contacts par requête.

Exemple #

Un objet JSON peut contenir une structure comme :

{"contacts":[{"first_name":"Julie","last_name":"Martin","email":"julie.martin@example.com"},{"first_name":"Thomas","last_name":"Bernard","email":"thomas.bernard@example.com"}]}

Les mêmes champs sont disponibles pour les contacts du lot.

Vous pouvez notamment utiliser campaign_uuid pour leur attribuer une campagne.

Et si je possède 500 contacts ? #

Vous devez répartir votre importation en plusieurs requêtes, contenant chacune au maximum 100 contacts.

Par exemple, cinq requêtes de 100 contacts.

Si vous ajoutez directement les contacts à une campagne, leurs séquences peuvent démarrer automatiquement.

Vérifiez donc votre campagne et votre volume de crédits avant de lancer une importation importante.

13. Que se passe-t-il si un contact existe déjà dans Klape ? #

Klape utilise l’adresse email comme identifiant unique des contacts.

Un même email ne peut pas être utilisé pour créer plusieurs fiches.

Exemple #

Votre base Klape contient déjà :

julie.martin@example.com

Votre automatisation tente ensuite de créer un contact avec cette même adresse.

L’API ne crée pas de deuxième fiche.

L’API affiche-t-elle systématiquement une erreur ? #

Non.

Lors des créations groupées par API, les contacts dont l’adresse email existe déjà sont ignorés sans générer nécessairement d’erreur.

Il faut donc éviter de considérer qu’une requête techniquement réussie signifie que chaque contact transmis a effectivement été créé.

L’API met-elle à jour les informations existantes ? #

Non.

La création d’un contact via l’API ne constitue pas une opération de mise à jour automatique d’une fiche existante.

Par exemple, transmettre un numéro de téléphone pour une adresse email déjà enregistrée ne met pas automatiquement à jour le contact correspondant.

Et si je renseigne une campagne pour un contact déjà existant ? #

Ne considérez pas la requête de création comme une méthode pour transférer un contact existant vers une nouvelle campagne.

Pour transférer un contact déjà présent, utilisez le parcours prévu dans Klape : interrompre sa séquence, le retirer de son ancienne campagne, puis l’ajouter à la nouvelle.

14. Peut-on renseigner automatiquement le champ Projet avec l’API ? #

Non, pas actuellement.

Le champ Projet permet de fournir à l’intelligence artificielle des informations spécifiques sur un prospect.

Il est particulièrement utile pour les campagnes de réactivation ou les contacts ayant déjà échangé avec votre entreprise.

Cependant, l’API actuelle ne permet pas de renseigner automatiquement ce champ lors de la création d’un contact.

Les champs pris en charge pour la création sont :

• first_name
• last_name
• email
• phone
• campaign_uuid

Le champ Projet doit actuellement être complété manuellement depuis la fiche du contact.

Si sa séquence est déjà active, vous devez l’interrompre avant de modifier ce champ, puis la réactiver.

L’API pourra évoluer, mais ces possibilités ne doivent pas être considérées comme disponibles aujourd’hui.

15. Comment régénérer une clé API ? #

Si vous souhaitez remplacer votre clé actuelle, Klape propose une fonction de régénération.

Procédure #

1. Rendez-vous dans Paramètres → API & Intégrations → API.
2. Repérez votre clé actuelle.
3. Cliquez sur Régénérer.
4. Lisez le message d’avertissement.
5. Confirmez votre demande.

Que se passe-t-il après la régénération ? #

L’ancienne clé API est immédiatement invalidée et une nouvelle clé est générée.

Toutes les automatisations utilisant encore l’ancienne clé cessent alors de fonctionner.

Que dois-je faire ensuite ? #

Vous devez mettre à jour la clé dans tous les outils connectés :

• Make.
• Zapier.
• n8n.
• Votre CRM.
• Toute autre application utilisant votre clé API Klape.

Important : ne régénérez pas votre clé sans anticiper l’interruption éventuelle de vos automatisations.

16. Comment révoquer une clé API ? #

Klape permet également de révoquer votre clé API.

La révocation est différente de la régénération.

Procédure #

1. Ouvrez Paramètres → API & Intégrations → API.
2. Cliquez sur Révoquer.
3. Confirmez l’action si l’interface le demande.

Que se passe-t-il ? #

La clé actuelle est immédiatement désactivée.

Contrairement à la régénération, Klape ne crée pas automatiquement une nouvelle clé lors de sa révocation.

Les automatisations utilisant cette clé ne peuvent donc plus communiquer avec Klape.

Comment utiliser de nouveau l’API ? #

Vous devez retourner dans la rubrique API, cliquer sur Générer une clé, puis configurer cette nouvelle clé dans vos outils.

Quelle différence entre les deux actions ? #

Ces actions sont particulièrement utiles lorsque vous souhaitez renforcer la sécurité de votre compte ou désactiver une intégration devenue inutile.

17. Pourquoi mon automatisation Make, Zapier ou n8n ne fonctionne-t-elle pas ? #

Plusieurs problèmes peuvent empêcher un outil externe de communiquer avec Klape.

La clé API est incorrecte #

Vérifiez que votre clé a été correctement renseignée.

Si vous l’avez régénérée, remplacez l’ancienne clé dans votre automatisation.

La clé API a été révoquée #

Une clé révoquée n’est plus utilisable.

Vous devez en générer une nouvelle.

L’authentification Bearer est mal configurée #

Vérifiez que votre requête utilise correctement l’en-tête Authorization et votre clé.

Évitez d’ajouter deux fois le préfixe Bearer si votre outil le renseigne automatiquement.

L’adresse de l’API est incorrecte #

Vérifiez que vous utilisez le domaine :

Ainsi que le chemin correspondant à l’opération souhaitée.

Le format JSON est incorrect #

Les données transmises doivent respecter la structure attendue par l’API.

Vérifiez notamment les noms des champs, les guillemets, les virgules et les types de données.

Des informations obligatoires manquent #

Pour créer un contact, vous devez fournir :

• first_name
• last_name
• email

Le téléphone est facultatif.

Le contact existe déjà #

Si l’adresse email existe déjà dans Klape, un nouveau contact n’est pas créé.

Dans les importations groupées par API, les doublons peuvent être ignorés sans message d’erreur.

L’identifiant de campagne est incorrect #

Si vous utilisez campaign_uuid, assurez-vous qu’il correspond à une campagne existante et accessible dans votre compte.

Vous pouvez récupérer les identifiants grâce à :

GET /api/v1/campaigns

Le lot contient trop de contacts #

L’API accepte au maximum 100 contacts par requête groupée.

Si votre liste est plus importante, divisez-la en plusieurs lots.

Comment identifier précisément l’erreur ? #

Consultez le résultat de la requête HTTP dans Make, Zapier ou n8n.

Vérifiez le code de réponse et les éventuelles informations techniques renvoyées.

Vous pouvez commencer par tester GET /api/v1/me pour isoler un problème d’authentification.

18. Quelle différence entre l’API et l’intégration native Sellsy ? #

Klape propose actuellement une intégration native avec Sellsy.

Contrairement à une automatisation Make ou Zapier, cette connexion s’effectue directement via OAuth.

Avec Sellsy #

Vous connectez votre compte Sellsy à Klape depuis :

Paramètres → API & Intégrations → Intégrations

Ensuite, lorsque vous ajoutez le tag klape à un contact dans Sellsy, celui-ci est automatiquement importé dans votre base Klape.

Attention : le contact n’est pas automatiquement attribué à une campagne.

Vous devez encore l’ajouter manuellement à une campagne pour déclencher les relances.

Retirer le tag dans Sellsy ne supprime pas le contact déjà importé dans Klape.

De même, déconnecter Sellsy ne supprime pas les contacts précédemment importés.

Avec l’API #

Vous pouvez créer un contact depuis un outil externe et renseigner directement un identifiant de campagne avec campaign_uuid.

Dans ce cas, la séquence démarre automatiquement après l’attribution du contact.

À retenir : l’intégration native Sellsy et les automatisations utilisant l’API ne proposent pas exactement le même fonctionnement.

19. Bonnes pratiques avant d’activer une automatisation #

Avant de connecter votre CRM ou votre outil publicitaire à Klape, nous recommandons plusieurs vérifications.

Vérifiez vos campagnes #

Si vous utilisez campaign_uuid, assurez-vous que les instructions de votre campagne correspondent aux prospects qui vont être ajoutés.

Commencez par un test sans campagne #

Pour vérifier uniquement la création de contacts, vous pouvez commencer par une requête sans campaign_uuid.

Cela évite de déclencher immédiatement une séquence de communication pendant votre test.

Utilisez des adresses email valides #

L’adresse email est obligatoire pour chaque contact.

Une adresse incorrecte peut empêcher la création ou provoquer ultérieurement des problèmes d’envoi.

Contrôlez les doublons #

Un contact possédant une adresse email déjà enregistrée ne sera pas créé une seconde fois.

Vérifiez vos crédits #

Si votre automatisation ajoute de nombreux contacts à une campagne, leurs premiers messages et leurs relances pourront consommer des crédits.

Respectez les préférences des prospects #

N’ajoutez pas automatiquement à des campagnes commerciales des contacts qui se sont opposés à ce type de communication.

Assurez-vous également de disposer d’une base légale adaptée et de respecter les règles applicables à votre prospection.

Protégez votre clé API #

Ne publiez jamais votre clé et révoquez-la si vous pensez qu’elle a été compromise.

Questions fréquentes #

Klape possède-t-il une API ? #

Oui. L’API est accessible depuis Paramètres → API & Intégrations → API.

Puis-je connecter Klape à Make ? #

Oui. Vous pouvez utiliser le module HTTP de Make pour envoyer des requêtes à l’API Klape.

Puis-je connecter Klape à Zapier ? #

Oui. Vous pouvez utiliser Webhooks by Zapier pour créer automatiquement des contacts.

Puis-je utiliser n8n avec Klape ? #

Oui. n8n peut communiquer avec Klape grâce au nœud HTTP Request.

Où générer ma clé API ? #

Dans Paramètres → API & Intégrations → API → Générer une clé.

Quelle est l’adresse de l’API Klape ? #

L’adresse de base est https://ai.klape.io.

Comment tester ma connexion API ? #

Utilisez l’endpoint GET /api/v1/me avec votre clé API.

Comment créer un contact automatiquement ? #

Envoyez une requête POST vers /api/v1/contacts avec le prénom, le nom et l’email du prospect.

Le numéro de téléphone est-il obligatoire ? #

Non. Le champ phone est facultatif.

Comment déclencher automatiquement une campagne ? #

Ajoutez le champ campaign_uuid à votre requête de création de contact.

Comment récupérer les identifiants de mes campagnes ? #

Utilisez GET /api/v1/campaigns.

Puis-je créer plusieurs contacts en une seule requête ? #

Oui. L’API accepte des lots de 1 à 100 contacts.

Peut-on créer deux contacts avec la même adresse email ? #

Non. L’adresse email doit être unique dans votre base Klape.

L’API met-elle à jour les contacts existants ? #

Non. L’opération de création ne met pas automatiquement à jour les fiches déjà présentes.

Puis-je renseigner automatiquement le champ Projet ? #

Non, pas actuellement. Ce champ doit être rempli manuellement dans Klape.

Que se passe-t-il si je régénère ma clé ? #

L’ancienne clé est immédiatement invalidée et remplacée par une nouvelle. Vous devez mettre à jour vos automatisations.

Que se passe-t-il si je révoque ma clé ? #

La clé est désactivée sans remplacement automatique. Vous devrez en générer une nouvelle si vous souhaitez réutiliser l’API.

Est-ce que Sellsy peut ajouter automatiquement mes contacts à une campagne ? #

Pas actuellement avec l’intégration native Sellsy.

L’ajout du tag klape importe le contact dans la base, mais vous devez ensuite lui attribuer une campagne manuellement.

Comment contacter le support Klape ? #

Si vous rencontrez un problème avec l’API ou vos intégrations, contactez support@klape.io.

Précisez l’opération tentée, l’outil utilisé et le message d’erreur éventuel.

Ne transmettez jamais votre clé API au support.