CF7 to Mautic : j’ai créé le plugin qui manquait à WordPress
Table des matières
TL;DR — CF7 to Mautic est un plugin WordPress open-source que j’ai développé pour connecter Contact Form 7 à Mautic via OAuth2. Il envoie les soumissions de formulaires en arrière-plan sans ralentir l’expérience utilisateur, crée ou met à jour les contacts Mautic, et les assigne automatiquement aux bons segments. Disponible gratuitement sur GitHub.
Quand j’ai commencé à déployer Mautic comme outil de marketing automation pour mes clients, la première question concrète était toujours la même : comment récupérer les leads qui remplissent les formulaires WordPress directement dans Mautic ?
La réponse évidente, c’est Contact Form 7 — le plugin installé sur plus de 10 millions de sites WordPress. Sauf que le seul pont libre entre CF7 et Mautic, le plugin « CF7 Mautic Extension », a été définitivement fermé en juillet 2020. L’alternative payante (WP Fusion) est puissante mais surdimensionnée pour un simple besoin d’envoi de leads. Et passer par Zapier ou Make introduit une dépendance externe sur une infrastructure que je contrôle de bout en bout.
J’ai donc construit le plugin qui manquait. Il s’appelle CF7 to Mautic, il est open-source et je l’utilise en production sur tous mes projets WordPress + Mautic.
Pourquoi ce plugin et pas une alternative
Avant de coder quoi que ce soit, j’ai fait le tour de ce qui existait.
CF7 Mautic Extension : fermé depuis 2020, plus téléchargeable sur WordPress.org. Les forks qui circulent ne sont pas maintenus et tournent sur des versions de PHP et WordPress dépassées.
WP Fusion : excellent outil, mais il connecte CF7 à plus de 100 CRM différents. C’est un couteau suisse à 247 € par an. Pour un projet qui utilise uniquement Mautic, c’est disproportionné.
Mautic Focus / scripts de tracking : le tracking Mautic natif fonctionne sur les formulaires HTML classiques, pas sur les soumissions CF7 qui passent par AJAX.
Le besoin était simple et précis : une intégration légère, sécurisée, qui fait une seule chose bien. J’ai écrit CF7 to Mautic en une semaine, je l’ai testé en production, et je l’ai publié sur GitHub.
Ce que fait CF7 to Mautic
Capture asynchrone des formulaires
Dès qu’un visiteur valide un formulaire CF7, le plugin intercepte la soumission et planifie l’envoi vers Mautic via WP-Cron. Le traitement est entièrement asynchrone : le formulaire répond instantanément à l’utilisateur, la synchronisation avec Mautic se fait en arrière-plan quelques secondes après. Aucun ralentissement visible, aucun timeout si Mautic est momentanément lent.
Authentification OAuth2 Client Credentials
C’est le point sur lequel je ne voulais pas faire de compromis. Les intégrations basiques stockent les identifiants Mautic en clair dans wp-config.php ou dans les options WordPress. CF7 to Mautic utilise OAuth2 Client Credentials, le standard recommandé pour les échanges machine-to-machine. Le token d’accès est généré à la volée et n’est jamais exposé dans le code source ou les logs.
Création ou mise à jour du contact
Le plugin recherche d’abord si un contact existe dans Mautic avec l’adresse email soumise. Si oui, il met à jour les champs. Si non, il crée un nouveau contact. Pas de doublons, pas de contacts orphelins.
Le mapping des champs est automatique : le plugin retire le préfixe your- utilisé par CF7 dans ses champs par défaut (your-name, your-email, your-message). Le résultat correspond directement aux alias de champs standards de Mautic (firstname, email, message). Aucune configuration manuelle du mapping.
Assignation automatique à un segment Mautic
C’est la fonctionnalité la plus utile au quotidien. En ajoutant un champ caché dans n’importe quel formulaire CF7, je peux cibler le segment Mautic de destination :
[hidden segment "prospects-pau"]Chaque formulaire du site peut alimenter un segment différent. Formulaire de contact → « Prospects services web ». Formulaire newsletter → « Abonnés newsletter ». Formulaire devis → « Demandes devis ». Le tout sans toucher au code.
Tracking de formulaire Mautic
Si vous avez créé des formulaires dans Mautic pour suivre les conversions, vous pouvez associer le formulaire CF7 à son équivalent Mautic via un second champ caché :
[hidden formId "42"]Mautic enregistrera la soumission dans ses statistiques de formulaires, ce qui permet de suivre les conversions directement depuis l’interface Mautic.
Installation pas à pas
Étape 1 — Créer les identifiants OAuth2 dans Mautic
Dans votre instance Mautic, allez dans Paramètres → Intégrations → Identifiants API. Créez une nouvelle connexion de type OAuth2 — Client Credentials. Mautic génère une clé publique (Client ID) et une clé secrète (Client Secret). Notez les deux, vous en aurez besoin à l’étape suivante.
Étape 2 — Installer le plugin sur WordPress
Téléchargez l’archive ZIP depuis le dépôt GitHub. Décompressez-la et uploadez le dossier dans /wp-content/plugins/ via FTP ou le gestionnaire de fichiers de votre hébergeur. Activez le plugin depuis Extensions → Extensions installées dans WordPress.
Étape 3 — Configurer le plugin
Allez dans Réglages → CF7 to Mautic dans l’administration WordPress. Renseignez les trois champs :
- URL Mautic : l’adresse de votre instance, ex.
https://mautic.mondomaine.com - Client ID : la clé publique OAuth2 générée dans Mautic
- Client Secret : la clé secrète OAuth2
Utilisez le bouton Tester la connexion intégré au panel d’administration pour vérifier que le plugin communique correctement avec votre instance Mautic avant de mettre en production.
Étape 4 — Adapter vos formulaires CF7
Dans l’éditeur de formulaire CF7, ajoutez les champs cachés correspondant à votre configuration Mautic :
[hidden segment "nom-de-votre-segment"]
[hidden formId "identifiant-formulaire-mautic"]Le champ segment est requis pour l’assignation à un segment. Le champ formId est optionnel et n’est utile que si vous avez créé un formulaire correspondant dans Mautic pour le suivi des conversions.
Cas d’usage concrets en agence web
Formulaire de contact → qualification automatique des leads
Sur un site internet professionnel, le formulaire de contact standard alimente le segment « Prospects ». Dès la soumission, Mautic déclenche un email de bienvenue personnalisé et lance le scoring du contact. Sans aucune intervention manuelle : le commercial trouve ses leads qualifiés directement dans Mautic le lendemain matin.
Plusieurs formulaires, plusieurs segments
Sur un site avec plusieurs offres, chaque formulaire cible un segment différent : « Demande devis site vitrine », « Demande devis e-commerce », « Contact support ». Chaque segment reçoit une séquence d’emails adaptée à la demande. Le tout sans code supplémentaire — juste le champ [hidden segment "..."] dans chaque formulaire CF7.
Formulaire de téléchargement → séquence de nurturing
Un formulaire « Télécharger notre guide » alimente le segment « Téléchargements ». Mautic envoie ensuite une séquence automatisée sur 3 semaines pour accompagner le prospect vers une prise de contact. Le taux de conversion est nettement supérieur à un simple formulaire sans suite.
Questions fréquentes
Le plugin fonctionne-t-il avec Mautic Cloud ?
Oui. L’URL à renseigner dans le plugin est simplement l’URL de votre instance Mautic, qu’elle soit auto-hébergée ou dans le cloud. Tant que vous avez accès à la configuration des identifiants API OAuth2 dans Mautic, le plugin fonctionne.
Quelle version de PHP est nécessaire ?
Le plugin requiert PHP 7.4 minimum. Pour un projet en production en 2026, je recommande PHP 8.1 ou 8.2 : PHP 7.4 est en fin de vie depuis fin 2022 et ne reçoit plus de correctifs de sécurité. WordPress 6.9 fonctionne parfaitement avec PHP 8.2.
Est-il compatible avec CF7 Flamingo ?
Oui, les deux fonctionnent de façon indépendante. Flamingo stocke les soumissions dans la base de données WordPress, CF7 to Mautic les envoie à Mautic. Vous pouvez les utiliser simultanément sans conflit.
Que se passe-t-il si Mautic est temporairement inaccessible ?
Le traitement étant asynchrone via WP-Cron, la soumission du formulaire est toujours confirmée immédiatement à l’utilisateur. Les logs de débogage du plugin permettent d’identifier les erreurs d’envoi. Si Mautic est indisponible, les données ne sont pas perdues : la tâche WP-Cron peut être relancée manuellement ou via un outil comme WP Crontrol.
Comment contribuer au plugin ?
Le code est entièrement ouvert sur GitHub. Vous pouvez ouvrir une issue pour signaler un bug ou proposer une fonctionnalité, ou soumettre directement une pull request. Les retours d’utilisateurs qui déploient Mautic dans des contextes différents m’aident à améliorer le plugin.
Conclusion
CF7 to Mautic s’inscrit dans une approche que je défends pour tous mes clients : construire une infrastructure web souveraine, sans dépendance aux outils SaaS tiers. Entre le site WordPress, l’instance Mautic auto-hébergée et les formulaires CF7, tout reste sous votre contrôle. Vous êtes propriétaire de votre stack, pas locataire.
CF7 to Mautic est focalisé sur une seule chose : faire passer les leads de vos formulaires WordPress vers Mautic de manière sécurisée, asynchrone et sans friction. Pas de dépendance externe, pas d’abonnement mensuel, pas de surcharge fonctionnelle.
Si vous utilisez déjà Mautic pour vos campagnes et que votre site WordPress tourne avec Contact Form 7, c’est la pièce manquante de votre infrastructure marketing. Je l’utilise en production sur mes propres projets clients — c’est la meilleure garantie que je peux vous donner.
