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

L’intégration de Warmr 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 Warmr à 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 Warmr :

• 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 Warmr

É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('/warmr-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 Warmr

Dans les paramètres Warmr :

1. Accédez à Intégrations → Webhooks
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 :

Warmr 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('/warmr-webhook', (req, res) => {
  const signature = req.headers['x-warmr-signature'];

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

  // Traitement...
});

Intégration avec les CRM Populaires

HubSpot

Via Make/Integromat :

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

Mapping des champs :

Warmr	HubSpot
full_name	firstname + lastname
email	email
company	company
title	jobtitle
linkedin_url	hs_linkedin_url (custom)
warmr_score	lead_score (custom)

Workflow HubSpot recommandé :

Si score Warmr > 70 → Assigner au commercial
Si score Warmr 40-70 → Séquence nurturing
Si score Warmr < 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
• Warmr_Score__c
• Last_LinkedIn_Interaction__c
• Engagement_History__c

Pipedrive

Intégration directe :

1. Trigger : Webhook Warmr
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 Warmr
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 Warmr avec d’autres signaux :

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

Implémentation Make :

1. Webhook Warmr 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 Warmr, 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

Warmr 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 Warmr

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 Warmr 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 Warmr accompagne vos équipes techniques.