Vérification d'e-mails dans Mautic

Créer un compte gratuitOffres et crédits

Ce que fait le plugin

Le plugin vérifie les adresses e-mail des contacts Mautic et enregistre les résultats dans des champs du contact :

Chaque vérification utilise un crédit.

Le plugin est gratuit et open source (GPL-3.0-or-later). Code source, versions et tickets : https://github.com/EasyEmailVerification/plugin-mautic. Paquet Composer sur Packagist : https://packagist.org/packages/easyemailverification/plugin-mautic

L'installation nécessite un accès au serveur Mautic (shell ou Docker). Si vous ne l'avez pas, demandez à la personne qui administre votre Mautic.

Vidéo: Ce que fait le plugin

Étape 1 : vérifiez la version de Mautic

Regardez quelle version de Mautic vous utilisez (affichée en bas du menu Mautic ou dans Settings → System Info).

Étape 2 : choisissez comment Mautic se connecte

Deux options, modifiables plus tard :

Étape 3 : installez le plugin sur le serveur Mautic

Avec Composer (Mautic installé avec mautic/recommended-project), dans le répertoire de Mautic :

composer require easyemailverification/plugin-mautic:^2.0
php bin/console cache:clear

Depuis le fichier zip :

  1. Téléchargez le plugin : https://github.com/EasyEmailVerification/plugin-mautic/releases/download/v2.0.1/MauticEasyBundle-v2.0.1.zip
  2. Copiez-le dans le répertoire docroot/plugins/ de l'installation Mautic :
cp MauticEasyBundle-v2.0.1.zip /path/to/mautic/docroot/plugins/

Avec Docker (image officielle, conteneur nommé mautic) :

docker cp MauticEasyBundle-v2.0.1.zip mautic:/var/www/html/docroot/plugins/
  1. Dans le répertoire docroot/plugins/, décompressez-le pour créer le dossier MauticEasyBundle et attribuez-le à l'utilisateur du serveur web. Si un dossier MauticEasyBundle de la version 1.x s'y trouve déjà, sortez-le d'abord de plugins/ :
unzip MauticEasyBundle-v2.0.1.zip
chown -R www-data:www-data MauticEasyBundle
  1. Videz le cache de Mautic :
php /var/www/html/bin/console cache:clear

(Remplacez /var/www/html par le répertoire de votre Mautic si ce n'est pas celui de Docker par défaut. Avec Docker : docker exec -u www-data mautic php /var/www/html/bin/console cache:clear.)

Étape 4 : activez et configurez le plugin dans Mautic

  1. Dans Mautic, cliquez sur l'icône d'engrenage → Plugins.
  2. Cliquez sur Install/Upgrade Plugins. Easy Email Verification apparaît dans la liste.
  3. Ouvrez-le et réglez Published sur *Yes*.
  4. Dans l'onglet Details, sous Authentication :
  5. Clé API : choisissez *API key*, collez la clé de l'étape 2 et cliquez sur Save & Close.
  6. OAuth : choisissez *Sign in with Easy Email Verification (OAuth)* et cliquez sur Authorize. Dans la fenêtre qui s'ouvre, connectez-vous à Easy Email Verification, cliquez sur Allow et fermez la fenêtre quand elle indique que Mautic est connecté. Si rien ne s'ouvre, autorisez les fenêtres pop-up pour Mautic.
  7. Dans l'onglet Features, sous Decide by :
  8. Use the field 'Safe To Send' for decision (par défaut, plus strict) : seules les adresses sûres pour l'envoi passent ; les adresses jetables, catch-all, risquées et unknown prennent le chemin « no ».
  9. Use the field Result for decision : tout passe sauf invalid et unknown (les adresses catch-all renvoient unknown et prennent le chemin « no »).
  10. Verify on contact save (par défaut *Yes*) : un contact créé ou modifié dans le formulaire de contact de Mautic est vérifié s'il n'a pas encore de résultat ou si son e-mail a changé.
  11. Also verify on import/API (par défaut *No*) : vérifie aussi les contacts venant des imports, de l'API, des formulaires et des intégrations. Chaque contact utilise un crédit, donc un gros import peut utiliser beaucoup de crédits.
  12. Enregistrez.

La mise à jour depuis la 1.x conserve la clé API et la décision enregistrées.

Le plugin crée ces champs de contact pour stocker les résultats : eev_result, eev_reason, eev_disposable, eev_accept_all, eev_role, eev_free, eev_domain, eev_mx_record, eev_mx_domain, eev_safe_to_send, eev_did_you_mean, eev_success, eev_message, eev_http_code et eev_validate_time.

Étape 5 : utilisez-le dans une campagne

Dans le constructeur de campagnes, ajoutez la condition Easy Email Verification et reliez les deux chemins (par exemple, continuer sur « yes » et ajouter un tag ou retirer sur « no »).

Pour tester sans crédits, utilisez la méthode clé API avec la clé sandbox eev_sandbox_key et des contacts sur sandbox.easyemailverification.com : valid@, disposable@, catchall@, invalid@ et unknown@. Avec « Safe To Send », seul valid@ prend le chemin « yes » ; avec « Result », valid@, disposable@ et catchall@. Avec OAuth, chaque vérification utilise de vrais crédits.

Pour vérifier un contact tout de suite, ouvrez-le et cliquez sur Verify email now (aussi dans le menu de chaque ligne de la liste des contacts ; Verify selected, affiché quand des contacts sont sélectionnés dans la liste, en vérifie plusieurs à la fois et indique combien de crédits seront utilisés).

Lire les résultats

En cas de problème

  1. Le plugin n'apparaît pas : vérifiez le dossier (docroot/plugins/MauticEasyBundle) et son propriétaire, videz à nouveau le cache et cliquez sur Install/Upgrade Plugins. Mautic 4.4 nécessite le plugin 1.0.2.
  2. Tous les contacts prennent le chemin « no » : cherchez « Easy Email Verification » dans le journal de Mautic (var/logs/). « API error (HTTP 401) » signale une mauvaise clé (ou une clé de widget) ; « not connected with OAuth » ou « revoked or has expired » signifie qu'il faut cliquer à nouveau sur Authorize.
  3. Authorize échoue : Mautic doit être servi en https (derrière un proxy, le réglage trusted_proxies de Mautic doit l'inclure).
  4. « Running out of your credit limit » : consultez les offres sur https://www.easyemailverification.com/fr-FR/pricing
  5. Pour déconnecter OAuth : dans les réglages du plugin, réglez Disconnect from Easy Email Verification sur *Yes* et enregistrez, ou retirez Mautic des Connected apps dans le tableau de bord.

Toujours bloqué ? Écrivez à support@easyemailverification.com.

Autres intégrations