Aller au contenu principal
Tous les articles

CRM

Intégrer Swimlane à votre CRM via webhooks : guide technique

Connectez Swimlane à HubSpot, Salesforce, Pipedrive ou tout autre CRM grâce aux webhooks. Guide pas à pas pour une synchronisation automatique de vos leads LinkedIn.

Par Swimlane 6 min de lecture

L’intégration de Swimlane avec votre CRM transforme votre prospection LinkedIn en un processus fluide et automatisé. Plus de saisie manuelle, plus de leads perdus entre les outils. Voici comment configurer cette connexion.

Pourquoi Intégrer Swimlane à Votre CRM

Le Problème Sans Intégration

Sans connexion entre vos outils :

  • Saisie manuelle des contacts identifiés sur LinkedIn
  • Risque de perte d’informations importantes
  • Délai entre l’identification et l’action
  • Manque de contexte dans le CRM

Les Bénéfices de l’Intégration

Avec les webhooks Swimlane :

  • Synchronisation automatique des contacts et interactions
  • Enrichissement des données CRM avec les infos LinkedIn
  • Déclenchement de workflows automatisés
  • Vision unifiée de chaque prospect

Comprendre les Webhooks

Qu’est-ce qu’un Webhook ?

Un webhook est une notification HTTP envoyée automatiquement quand un événement se produit. Contrairement aux API où vous devez demander les données, les webhooks les envoient proactivement.

Analogie :

  • API = Vous appelez le restaurant pour savoir si votre commande est prête
  • Webhook = Le restaurant vous appelle quand c’est prêt

Les Événements Disponibles dans Swimlane

Événement Déclencheur Données envoyées
contact.created Nouveau contact détecté Profil complet
contact.updated Mise à jour d’un contact Champs modifiés
contact.scored Score recalculé Nouveau score + historique
interaction.created Nouvelle interaction Type, contenu, date
comment.posted Commentaire publié Post, commentaire, réponses

Configuration Technique

Étape 1 : Créer le Endpoint de Réception

Votre CRM ou middleware doit exposer une URL capable de recevoir les webhooks.

Exemple avec Make (ex-Integromat) :

  1. Créez un nouveau scénario
  2. Ajoutez un module “Webhooks” → “Custom webhook”
  3. Copiez l’URL générée

Exemple avec Zapier :

  1. Créez un nouveau Zap
  2. Trigger : “Webhooks by Zapier” → “Catch Hook”
  3. Copiez l’URL du webhook

Exemple code Node.js :

const express = require('express');
const app = express();

app.use(express.json());

app.post('/swimlane-webhook', (req, res) => {
  const event = req.body;

  console.log('Event received:', event.type);
  console.log('Data:', event.data);

  // Traitement selon le type d'événement
  switch(event.type) {
    case 'contact.created':
      handleNewContact(event.data);
      break;
    case 'interaction.created':
      handleNewInteraction(event.data);
      break;
    // ...
  }

  res.status(200).json({ received: true });
});

app.listen(3000);

Étape 2 : Configurer Swimlane

Dans les paramètres Swimlane :

  1. Accédez à IntégrationsWebhooks
  2. Cliquez sur Ajouter un endpoint
  3. Collez votre URL
  4. Sélectionnez les événements à envoyer
  5. Activez et testez

Étape 3 : Sécuriser la Connexion

Vérification de signature :

Swimlane signe chaque webhook avec une clé secrète. Vérifiez cette signature pour éviter les faux appels.

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');

  return signature === `sha256=${expectedSignature}`;
}

app.post('/swimlane-webhook', (req, res) => {
  const signature = req.headers['x-swimlane-signature'];

  if (!verifyWebhook(req.body, signature, process.env.SWIMLANE_SECRET)) {
    return res.status(401).json({ error: 'Invalid signature' });
  }

  // Traitement...
});

Intégration avec les CRM Populaires

HubSpot

Via Make/Integromat :

  1. Trigger : Webhook Swimlane
  2. Action : HubSpot → Create/Update Contact

Mapping des champs :

Swimlane HubSpot
full_name firstname + lastname
email email
company company
title jobtitle
linkedin_url hs_linkedin_url (custom)
swimlane_score lead_score (custom)

Workflow HubSpot recommandé :

Si score Swimlane > 70 → Assigner au commercial
Si score Swimlane 40-70 → Séquence nurturing
Si score Swimlane < 40 → Liste de veille

Salesforce

Via Zapier :

  1. Trigger : Webhooks → Catch Hook
  2. Filter : Event type = “contact.created”
  3. Action : Salesforce → Create Lead

Champs personnalisés Salesforce :

  • LinkedIn_Profile_URL__c
  • Swimlane_Score__c
  • Last_LinkedIn_Interaction__c
  • Engagement_History__c

Pipedrive

Intégration directe :

  1. Trigger : Webhook Swimlane
  2. Action : Pipedrive → Create Person + Add to Pipeline

Configuration du deal automatique :

  • Créez un deal pour chaque contact avec score > 60
  • Assignez à l’étape “LinkedIn Qualified”

Folk, Notion, Airtable

Pour les outils flexibles type base de données :

Airtable via Make :

  1. Table “LinkedIn Contacts”
  2. Colonnes mappées avec les champs Swimlane
  3. Vue filtrée par score pour priorisation

Notion via Zapier :

  1. Database “Prospects LinkedIn”
  2. Properties : Nom, Entreprise, Score, LinkedIn URL
  3. Formule pour calculer priorité

Cas d’Usage Avancés

1. Scoring Dynamique Multi-Source

Combinez le score Swimlane avec d’autres signaux :

Score final = (Swimlane × 0.4) + (Engagement email × 0.3) + (Visites site × 0.3)

Implémentation Make :

  1. Webhook Swimlane reçu
  2. Récupérer données HubSpot (email opens)
  3. Récupérer données Google Analytics (visites)
  4. Calculer score composite
  5. Mettre à jour le CRM

2. Alertes Intelligentes

Configurez des notifications temps réel :

Si score augmente de +20 en 7 jours → Slack notification
Si prospect visite 3x en 1 semaine → Email au commercial
Si interaction reçue de C-level → Alerte prioritaire

Via Slack + Make :

// Format du message Slack
{
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "🔥 *Nouveau prospect chaud*\n\n" +
                "*Nom:* ${contact.name}\n" +
                "*Entreprise:* ${contact.company}\n" +
                "*Score:* ${contact.score}/100\n" +
                "*Action:* ${interaction.type}"
      }
    },
    {
      "type": "actions",
      "elements": [
        {
          "type": "button",
          "text": { "type": "plain_text", "text": "Voir profil" },
          "url": "${contact.linkedin_url}"
        }
      ]
    }
  ]
}

3. Séquences de Nurturing Automatisées

Déclencheur : interaction.created avec score > 50

Workflow :

  1. J+0 : Ajout à la liste CRM “Warm leads”
  2. J+1 : Email personnalisé (template basé sur l’interaction)
  3. J+3 : Tâche créée pour le commercial
  4. J+7 : Si pas de réponse → Relance automatique

4. Reporting Consolidé

Envoyez les données vers votre outil de BI :

Vers Google Sheets :

  • Log de toutes les interactions
  • Calcul automatique des métriques
  • Graphiques de performance

Vers Looker/Metabase :

  • Base de données dédiée
  • Dashboards temps réel
  • Analyses de cohortes

Debugging et Maintenance

Logs des Webhooks

Dans Swimlane, consultez :

  • Historique des envois
  • Statut de chaque call (success/fail)
  • Payload envoyé
  • Réponse reçue

Erreurs Courantes

Erreur Cause Solution
400 Bad Request Payload mal formé Vérifier le parsing JSON
401 Unauthorized Signature invalide Vérifier la clé secrète
500 Server Error Bug côté réception Consulter logs serveur
Timeout Traitement trop long Répondre d’abord, traiter après

Retry Automatique

Swimlane retry automatiquement en cas d’échec :

  • 1ère tentative : immédiate
  • 2ème tentative : +5 minutes
  • 3ème tentative : +30 minutes
  • 4ème tentative : +2 heures

Après 4 échecs, le webhook est marqué en erreur.

Bonnes Pratiques

Performance

  • Répondez vite : Renvoyez un 200 OK immédiatement, traitez ensuite
  • Idempotence : Gérez les doublons (même événement reçu 2x)
  • File d’attente : Pour les gros volumes, utilisez une queue

Sécurité

  • HTTPS obligatoire : Ne pas accepter les webhooks en HTTP
  • Vérifiez les signatures : Toujours valider l’origine
  • Limitez les IPs : Si possible, whitelist les IPs Swimlane

Maintenance

  • Monitoring : Surveillez les erreurs 4xx/5xx
  • Alertes : Notification si taux d’échec > 5%
  • Documentation : Maintenez un schéma à jour

Conclusion

L’intégration webhook entre Swimlane et votre CRM automatise le flux de données et élimine les frictions. Une fois configurée, votre prospection LinkedIn alimente directement votre pipeline commercial.

Commencez simple : un webhook vers votre CRM pour créer les contacts. Puis enrichissez progressivement avec les scores, les interactions, et les workflows automatisés.


Besoin d’aide pour configurer votre intégration ? L’équipe Swimlane accompagne vos équipes techniques.

Faites-le avec Swimlane

Tout ce qu’il y a dans cet article, sans la partie manuelle.

Essayer gratuitement

À lire ensuite

CRM 5 min de lecture

L'Inbox Swimlane : vos conversations LinkedIn, en mieux

Decouvrez comment l'inbox integree de Swimlane centralise vos conversations LinkedIn avec des filtres intelligents, des templates IA, la synchronisation en temps reel et l'automatisation des campagnes.

Lire →