Aller au contenu principal

Intégrations Données & Productivité

Enregistrez chaque lead dans une feuille de calcul, une base de données ou votre propre point de terminaison API. Configurez depuis Paramètres → Intégrations.

Google Sheets​

Ajoutez une nouvelle ligne à une Google Sheet pour chaque lead qui entre dans LeadHub.

Étape 1 — Créer un Projet Google Cloud​

  1. Allez sur console.cloud.google.com.
  2. Cliquez sur Nouveau Projet, nommez-le LeadHub et créez-le.
  3. Recherchez Google Sheets API et Activez-la.
  4. Activez également Google Drive API.

Étape 2 — Créer des Identifiants OAuth​

  1. Dans la Console Cloud, allez dans APIs & Services → Identifiants.
  2. Cliquez sur Créer des Identifiants → OAuth client ID.
  3. Définissez le Type d'Application sur Application Web.
  4. Sous URI de redirection autorisés, ajoutez : https://yourdomain.com/oauth/google-sheets/callback
  5. Cliquez sur Créer et copiez le Client ID et le Client Secret.

Étape 3 — Préparer Votre Google Sheet​

  1. Créez une nouvelle Google Sheet (ou ouvrez-en une existante).
  2. Ajoutez des en-têtes de colonnes à la ligne 1 — suggestion : ID | Prénom | Nom | E-mail | Téléphone | Entreprise | Source | Pipeline | Étape | Score | Créé le
  3. Copiez l'ID de la Feuille depuis l'URL : https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

Étape 4 — Configurer dans LeadHub​

  1. Allez dans Paramètres → Intégrations → Google Sheets.
  2. Renseignez :
    ChampValeur
    Client IDDe l'étape 2
    Client SecretDe l'étape 2
    ID de la FeuilleDe l'étape 3
    Nom de l'OngletLe nom de l'onglet, ex. : Sheet1
  3. Cliquez sur Se Connecter avec Google pour compléter le flux OAuth.

Chaque nouveau lead ajoute une ligne avec tous ses détails.

Notion​

Créez une nouvelle page (entrée de base de données) dans une base de données Notion pour chaque lead.

Étape 1 — Créer une Intégration Notion​

  1. Allez sur notion.so/my-integrations.
  2. Cliquez sur + Nouvelle intégration.
  3. Donnez-lui un nom (LeadHub) et sélectionnez votre espace de travail.
  4. Copiez le Token d'Intégration Interne (commence par secret_).

Étape 2 — Partager Votre Base de Données avec l'Intégration​

  1. Ouvrez la base de données Notion où vous souhaitez stocker les leads.
  2. Cliquez sur Partager (en haut à droite) → recherchez le nom de votre intégration → cliquez sur Inviter.

Étape 3 — Obtenir l'ID de Votre Base de Données​

Depuis l'URL de la base de données : https://www.notion.so/yourworkspace/DATABASE_ID?v=...

L'ID de Base de Données est la chaîne de 32 caractères avant le ?.

Étape 4 — Configurer dans LeadHub​

  1. Allez dans Paramètres → Intégrations → Notion.
  2. Renseignez :
    ChampValeur
    Token APIToken d'Intégration Interne de l'étape 1
    ID de Base de DonnéesDe l'étape 3
  3. Cliquez sur Enregistrer & Tester.

LeadHub crée une nouvelle page dans la base de données. Assurez-vous que votre base de données dispose de propriétés correspondantes : Nom, E-mail, Téléphone, Source, Entreprise.

Airtable​

Ajoutez un nouvel enregistrement à une base Airtable pour chaque lead.

Étape 1 — Obtenir Votre Clé API et les Détails Base/Table​

  1. Allez sur airtable.com/account → faites défiler jusqu'à la section API → générez un Token d'Accès Personnel.
    • Activez les portées : data.records:write, schema.bases:read
    • Sélectionnez la base que vous souhaitez utiliser
  2. Ouvrez votre base Airtable et obtenez l'ID de Base depuis l'URL : https://airtable.com/BASE_ID/tblXXX/...
  3. Notez le Nom de Table (le nom de l'onglet dans votre base).

Étape 2 — Préparer Votre Table Airtable​

Assurez-vous que la table dispose de champs pour : Name, Email, Phone, Source, Company, Pipeline, Stage, Score.

Étape 3 — Configurer dans LeadHub​

  1. Allez dans Paramètres → Intégrations → Airtable.
  2. Renseignez :
    ChampValeur
    Clé APIToken d'Accès Personnel de l'étape 1
    ID de BaseDe l'étape 2
    Nom de TableNom exact de la table (sensible à la casse)
  3. Cliquez sur Enregistrer & Tester.

Webhook Générique​

Envoyez des données de lead à n'importe quelle URL — votre propre serveur, une intégration personnalisée, une fonction serverless, ou tout point de terminaison acceptant des requêtes HTTP POST.

Étape 1 — Préparer Votre Point de Terminaison​

Votre point de terminaison doit :

  • Accepter des requêtes HTTP POST
  • Accepter Content-Type: application/json
  • Retourner un code de statut HTTP 2xx en cas de succès

Étape 2 — Configurer dans LeadHub​

  1. Allez dans Paramètres → Intégrations → Webhook Générique.
  2. Renseignez :
    ChampValeur
    URL WebhookL'URL complète de votre point de terminaison
    Clé Secrète(Optionnel) Une chaîne secrète ajoutée en tant qu'en-tête X-LeadHub-Signature
  3. Cliquez sur Enregistrer & Tester.

Structure de la Charge Utile​

{
  "event": "lead.created",
  "id": "lead_01HXZ3...",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "[email protected]",
  "phone": "+1 555 000 1234",
  "company": "Acme Corp",
  "source": "facebook_lead_ads",
  "pipeline": "Sales",
  "stage": "New",
  "score": 72,
  "tags": ["webinar", "hot"],
  "custom_fields": {},
  "created_at": "2025-06-15T14:23:00Z"
}

Vérification de la Signature​

Si vous définissez une Clé Secrète, chaque requête inclut l'en-tête :

X-LeadHub-Signature: sha256=HMAC_SHA256(secret, payload_body)

Vérifiez cela dans votre point de terminaison pour vous assurer que les requêtes proviennent de LeadHub.

Push API REST​

Envoyez des données de lead à un point de terminaison API RESTful avec méthode HTTP, en-têtes et mappage de champs configurables.

Étape 1 — Identifier Votre Point de Terminaison API​

Vous avez besoin de :

  • L'URL du point de terminaison complète (ex. : https://api.yourapp.com/v1/leads)
  • La méthode HTTP : POST, PUT ou PATCH
  • Tout en-tête d'authentification requis (ex. : Authorization: Bearer YOUR_TOKEN)

Étape 2 — Configurer dans LeadHub​

  1. Allez dans Paramètres → Intégrations → Push API REST.
  2. Renseignez :
    ChampValeur
    URL du Point de TerminaisonURL complète du point de terminaison API
    Méthode HTTPPOST, PUT ou PATCH
    En-têtesObjet JSON des en-têtes, ex. : {"Authorization": "Bearer abc123"}
  3. Cliquez sur Enregistrer & Tester.

Remarques​

  • LeadHub envoie la même charge utile JSON que le Webhook Générique.
  • Utilisez cette intégration lorsque vous avez votre propre API interne ou une API SaaS personnalisée non supportée nativement.
  • Nouvelles tentatives : jusqu'à 3 tentatives en cas d'échec, avec backoff exponentiel.

Dépannage​

ProblèmeSolution
Erreur OAuth Google SheetsAssurez-vous que l'URI de redirection correspond exactement, y compris https://
Notion "objet introuvable"L'intégration n'est pas partagée avec la base de données — revérifiez l'étape 2
Incompatibilité de champ AirtableLes noms de champs sont sensibles à la casse — vérifiez les noms exacts dans Airtable
Webhook retournant 4xxVérifiez que votre point de terminaison accepte Content-Type: application/json
Push API REST ne se déclenche pasVérifiez le cron job de file d'attente — voir le Guide d'Hébergement Partagé
Incompatibilité de signatureAssurez-vous de calculer HMAC-SHA256 sur le corps brut de la requête