Plugins & intégrations
Connecter WordPress à votre CRM : architecture et bonnes pratiques
Comment connecter proprement WordPress à HubSpot, Pipedrive, Sellsy ou un autre CRM : architecture, sync, gestion des erreurs, RGPD.
Vos formulaires WordPress alimentent vos commerciaux. Vos commerciaux travaillent dans HubSpot ou Pipedrive. Entre les deux : la galère manuelle, la double saisie, ou un connecteur Zapier qui plante quand le volume monte. Voici comment faire propre.
Trois architectures possibles
1. Connecteur SaaS (Zapier, Make, n8n)
Vous connectez WordPress et CRM via un service intermédiaire qui écoute les événements (nouveau lead, formulaire soumis) et les pousse au CRM.
Pour : démarrage rapide, no-code, fonctionne pour 90% des cas simples.
Contre : coût mensuel récurrent (Zapier facture vite), latence (parfois 1-15 min), peu de contrôle sur la gestion d’erreur, dépendance à un tiers.
2. Plugin du marché spécifique
HubSpot a son plugin WordPress officiel. Pipedrive a des intégrations communautaires. Sellsy idem.
Pour : intégration plus profonde qu’un connecteur générique, formulaires natifs côté WP.
Contre : verrouille votre setup (changer de CRM = tout refaire), souvent moins flexible que le custom, parfois mal maintenu.
3. Plugin / mu-plugin custom (mon préféré)
Vous codez l’intégration sur mesure : un bridge WordPress ↔ CRM via leur API REST, hébergé dans votre site.
Pour : contrôle total, latence quasi-nulle, gestion d’erreur fine, indépendant des SaaS tiers, scaling sans surcoût.
Contre : coût initial dev (3-8k €), maintenance à prévoir si l’API change.
Pour un volume > 100 leads/jour ou des règles métier complexes, le custom devient rapidement le bon choix.
Architecture custom recommandée
Le pattern
WP form submitted
↓
[Hook: gform_after_submission ou wpcf7_mail_sent]
↓
[Job async via Action Scheduler]
↓
[CRM API client]
↓
[Retry queue si échec]
↓
[Logger + notification admin]
Les 7 règles
1. Asynchrone obligatoire
Ne JAMAIS appeler l’API CRM dans le hook synchrone du formulaire. Si l’API CRM met 5 secondes ou plante, le formulaire échoue côté utilisateur. Toujours via une queue (Action Scheduler ou WP Background Processing).
2. Idempotence
Le job peut être rejoué (cron qui retry). Vérifier que la même action exécutée 2 fois n’écrit pas 2 contacts. Utiliser un hash unique du lead comme clé de dédoublonnage côté CRM.
3. Gestion d’erreur structurée
Catch des exceptions HTTP, log structuré (timestamp, payload, erreur), notification admin par mail au-delà d’un seuil de retry échoué.
4. Stockage des credentials hors code
API keys dans wp-config.php via define() ou via une table séparée chiffrée. JAMAIS dans le code source ou la BDD en clair.
5. Mapping de champs explicite
Une classe dédiée au mapping WP_Form_Field → CRM_Field. Centralisé, testable, modifiable sans toucher la logique d’envoi.
6. Webhook entrant pour la synchro inverse
Le CRM peut renvoyer des événements (statut lead changé, nouvelle note) → endpoint REST custom dans WordPress qui met à jour les données côté WP. Authentification par signature (HMAC).
7. RGPD natif
Demande de consentement explicite sur le formulaire (pas une case pré-cochée), stockage de la preuve de consentement (timestamp + IP + texte de la mention au moment du clic), respect des demandes d’effacement (suppression côté WP ET CRM).
Cas concret : lead form → HubSpot
Stack typique pour ce setup :
- Formulaire : Gravity Forms (le plus flexible)
- Hook :
gform_after_submission - Queue : Action Scheduler (intégré à WP nativement depuis 5.9)
- Client API : Guzzle ou wp_remote_post natif
- Endpoint HubSpot :
POST /crm/v3/objects/contacts - Idempotence : email comme identifiant unique
Code d’exemple simplifié :
add_action( 'gform_after_submission_3', function( $entry, $form ) {
as_enqueue_async_action( 'es_push_to_hubspot', [ 'entry_id' => $entry['id'] ] );
}, 10, 2 );
add_action( 'es_push_to_hubspot', function( $entry_id ) {
$entry = GFAPI::get_entry( $entry_id );
$payload = [
'properties' => [
'email' => $entry['1'],
'firstname' => $entry['2'],
'lastname' => $entry['3'],
'lead_source' => 'website_form',
],
];
$response = wp_remote_post( 'https://api.hubapi.com/crm/v3/objects/contacts', [
'headers' => [
'Authorization' => 'Bearer ' . HUBSPOT_API_KEY,
'Content-Type' => 'application/json',
],
'body' => wp_json_encode( $payload ),
'timeout' => 15,
] );
if ( is_wp_error( $response ) || wp_remote_retrieve_response_code( $response ) >= 400 ) {
// Log + retry
}
} );
Cas plus complexes : ERP, multi-systèmes
Si vous devez synchroniser à 3 systèmes (WordPress + CRM + ERP), envisagez un middleware dédié (n8n self-host, ou un microservice Node/Python) plutôt que de tout faire transiter par WordPress. WordPress sera juste émetteur d’événements.
TL;DR
- 3 options : connecteur SaaS, plugin du marché, custom
- Custom = bonne option dès que volume ou règles métier deviennent importants
- Toujours asynchrone, idempotent, avec gestion d’erreur et RGPD natif
- Pour > 3 systèmes : envisager un middleware externe
Besoin d’une intégration WordPress ↔ CRM sur mesure ? Discutons-en.
Un projet en réflexion ?
Si cet article a éclairé votre besoin, on peut en discuter de vive voix. 30 minutes, sans engagement.
Planifier un échangeÀ lire aussi
Plugins & intégrations
Connecter un objet IoT à WordPress : pattern et exemple concret
Plugins & intégrations
Automatiser ses workflows métier dans WordPress sans devenir fou
Plugins & intégrations