KKronoleadSe connecter

Documentation

Connectez Kronolead à votre CRM

Faites entrer vos leads depuis n'importe quel outil, et renvoyez-les vers votre CRM à chaque étape. Sans développeur : Zapier, Make ou n8n suffisent. L'adresse, la clé et le secret de votre compte sont dans Kronolead, écran Acquisition › Connecteurs.

1. Faire entrer des leads

Créez un connecteur « API ou webhook » : Kronolead vous donne une adresse et une clé. Envoyez-y un contact (ou une liste, ou { "contacts": [ … ] }, 200 au plus par envoi) :

POST https://kronolead.com/api/entrees/<votre-source>?org=<votre-compte>
Authorization: Bearer <votre-clé>
Content-Type: application/json

{
  "email": "camille.martin@exemple.fr",
  "prenom": "Camille",
  "nom": "Martin",
  "telephone": "06 12 34 56 78",
  "offre": "code-de-l-offre",
  "message": "Je voudrais un devis",
  "utm_source": "instagram",
  "utm_campaign": "rentree"
}
  • email ou telephone: l'un des deux est obligatoire. Un lead déjà connu est complété, jamais dupliqué.
  • prenom, nom : facultatifs (first_name, last_name, phone… sont aussi acceptés).
  • offre : le code d'une offre de Connaissances › Mes offres (facultatif).
  • utm_source, utm_medium, utm_campaign, utm_content: d'où vient la personne.

La réponse dit, ligne par ligne, ce qui a été créé, complété ou refusé. Une lecture (GET) de la même adresse avec la clé décrit ce qui est attendu.

Sans API : transférez vos e-mails de nouveau lead à l'adresse d'un connecteur « E-mails transférés »(l'IA lit chaque e-mail), importez un fichier, ou collez le code d'un formulaire sur votre site.

2. Envoyer vos leads vers votre CRM

Dans Connecteurs › Envoyer vos leads vers votre CRM, donnez une adresse https (votre CRM, ou un « webhook entrant » Zapier, Make, n8n) et choisissez les événements :

  • lead.cree : un nouveau lead entre ;
  • lead.statut : son statut change (contacté, rendez-vous, converti, perdu…) ;
  • lead.rdv : un rendez-vous est pris ou déplacé.

Chaque événement part aussitôt, en POST JSON :

POST https://votre-crm.exemple/webhook
Content-Type: application/json
X-Kronolead-Evenement: lead.statut
X-Kronolead-Signature: t=1763812345,v1=5f2c…

{
  "evenement": "lead.statut",
  "le": "2026-11-22T10:15:00.000Z",
  "lead": {
    "email": "camille.martin@exemple.fr",
    "prenom": "Camille",
    "nom": "Martin",
    "telephone": "+33612345678",
    "offre": "accompagnement",
    "offre_nom": "Accompagnement 3 mois",
    "statut": "rdv",
    "statut_libelle": "Rendez-vous pris",
    "source": "Formulaire du site",
    "canal": "instagram",
    "score": 72,
    "rdv_le": "2026-11-25T09:00:00.000Z",
    "cree_le": "2026-11-20T18:02:11.000Z",
    "notes": "Je voudrais un devis",
    "lien": "https://kronolead.com/crm/leads/camille.martin%40exemple.fr"
  }
}

Répondez par un code 2xx. Un délai de 4 secondes s'applique ; les derniers envois et leur réponse s'affichent dans l'écran, avec un bouton d'essai.

3. Vérifier la signature

Chaque envoi porte l'en-tête X-Kronolead-Signature : t=<horodatage>,v1=<signature>, où la signature est le HMAC-SHA256 de <horodatage>.<corps brut>avec le secret affiché dans l'écran. Refusez un envoi de plus de 5 minutes.

// Node.js : vérifier qu'un envoi vient bien de Kronolead
import { createHmac, timingSafeEqual } from "node:crypto";

function signatureJuste(secret, entete, corpsBrut) {
  const t = /t=(\d+)/.exec(entete)?.[1];
  const v1 = /v1=([a-f0-9]{64})/.exec(entete)?.[1];
  if (!t || !v1 || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const attendue = createHmac("sha256", secret).update(`${t}.${corpsBrut}`).digest();
  const recue = Buffer.from(v1, "hex");
  return recue.length === attendue.length && timingSafeEqual(recue, attendue);
}

4. Exporter en CSV

Leads › Exporter (CSV) télécharge tous vos leads avec les mêmes champs que les webhooks (séparateur « ; », lisible par Excel). Réservé aux managers et plus.

5. Avec Zapier ou Make, sans code

  • Vers Kronolead: déclencheur « nouveau contact » de votre CRM (HubSpot, Pipedrive, Brevo, Salesforce…), puis action « Webhooks · POST » vers l'adresse du connecteur, en JSON, avec l'en-tête Authorization: Bearer <clé>.
  • Depuis Kronolead : déclencheur « Webhooks · Catch Hook », dont vous collez l'adresse dans Kronolead ; puis action « créer ou mettre à jour un contact » de votre CRM.