Mailshot permet l’envoi en nombre d’emails au moyen d’un SMTP (ou d’un service externe) dédié à cet effet. Il permet de limiter la cadence d’envoi.
Enfin, ce plugin implémente la partie send de l’API Newsletter et peut donc être utilisé avec les plugins Mailsubscribers et Newsletters pour l’envoi de Newsletters.
La question du SPAM
Avant de décrire en détail le fonctionnement du plugin, il est important de souligner que l’envoi de mails en nombre est rendu de plus en plus difficile en raison de la prédominance du SPAM. Plus de 95% des emails qui circulent sur les serveurs de courriers sont du SPAM. Les opérateurs de mails (FAI, gmail...) sont donc de plus en plus stricts dans les règles de filtrage.
En tant qu’éditeur de contenu et utilisateur de ce plugin, vous avez une responsabilité : n’envoyer du contenu qu’à des utilisateurs qui l’ont sollicité par une demande explicite. Lorsque vous ne respectez pas cette règle, vous envoyez des emails non sollicités, c’est à dire du SPAM. Et vous contribuez à renforcer les règles de filtrage des opérateurs de mail.
Cette situation généralisée entraine bien des désagréments :
- certains mails légitimes n’arrivent jamais à vos destinataires ;
- en tant qu’expéditeur régulier vous risquez d’être blacklisté, voire votre serveur risque d’être blacklisté.
C’est pour cette raison que ce plugin ne permets pas d’envoyer des mails à l’aide de la fonction mail() de PHP. Cette fonction permet l’envoi simple de mail, mais elle passe par un canal partagé entre tous les sites hébergés par un serveur. Si vous l’utilisez à mauvais escient, c’est tous les autres utilisateurs qui seront pénalisés.
C’est également pour cette raison que ce plugin propose d’utiliser un service d’envoi de mail (serveur SMTP dédié, service externe commercial) spécifique à cet usage. Ainsi, même si vos envois en nombre déclenchent - à tort ou à raison - un filtrage chez les opérateurs de mail, le reste du fonctionnement du site n’en sera pas affecté (envoi des mails d’inscriptions, de formulaire de contact, de notification de forum, de pétitions...). Utilisez cette possibilité et protégez le fonctionnement quotidien de votre site web.
Ou alors ne venez pas demander de l’aide sur vos mails en erreur, on vous aura prévenu.
Installation
L’installation du plugin nécessite le plugin Facteur qui prend en charge l’envoi des mails à l’aide d’un serveur SMTP.
Configuration
La configuration du plugin concerne le service d’envoi qui sera utilisé pour les envois en nombre ainsi que les réglages d’expéditeur (nom et email) :
Service d’envoi
Le réglage par défaut est d’utiliser le même service d’envoi que pour les autres mails (soit le serveur de mail SMTP configuré dans le plugin Facteur). Ce réglage fonctionne mais n’est pas conseillé comme indiqué plus haut.
Si aucun serveur SMTP n’est configuré par défaut, le premier choix est désactivé comme ceci :
Cette fois vous n’y couperez pas : vous devez alors absolument choisir un autre service pour l’envoi de vos emails.
Vous pouvez configurer un serveur SMTP (celui qui gère les emails de votre nom de domaine, Gmail...) (assurez vous dans tous les cas qu’il accepte que vous passiez par lui pour cet usage) :
Sinon, et c’est la solution la plus fiable, il vaut mieux utiliser un service dédié à l’envoi de mails en nombre comme Mailjet [1], Sparkpost [2] ou Mandrill [3] (disclaimer : l’auteur n’a aucun intérêt dans ces services commerciaux).
Le plugin propose aussi l’utilisation du service Mandrill, mais celui-ci est désormais soumis à l’utilisation d’un compte MailChimp payant, ce qui en restreint l’accès.
Cadence d’envoi
Dans tous les cas, que vous utilisiez un serveur SMTP ou un service externe, il est possible, voire probable, que vous soyez soumis à une cadence d’envoi maximale (nombre maximum de mails par quart-d’heure, par heure, par jour...). Dans ce cas là, convertissez cette cadence maximale en nombre de mail par jour et renseignez le champ Limiter la cadence d’envoi. La cadence sera prise en compte en espaçant l’envoi des mails de façon régulière pour ne pas dépasser cette moyenne journalière.
Envoi rapide
A contrario, si vous utilisez un service d’envoi capable d’envoyer très vite, ou de tout recevoir très vite et de mettre en attente les envois surnuméraires (c’est le cas de Mandrill notamment), vous pouvez activer l’option d’envoi rapide.
Quand cette option est cochée le plugin essaye d’envoyer aussi rapidement que possible à tous les destinataires. Notamment, en fonction du nombre d’envoi total à réaliser, il va lancer des processus parallèles pour accélérer le traitement, en étant capable par exemple d’envoyer 50 000 mails/heure si on a 200 000 destinataires.
Attention toutefois, envoyer rapidement un grand nombre de mails est une chose, mais il faut penser que cela va provoquer un pic de visites simultanées sur votre site, et que votre hébergement doit aussi être dimensionné pour absorber ce trafic supplémentaire.
Expéditeur
La dernière partie du formulaire permet de fixer les noms et emails de l’expéditeur qui apparaitra sur vos envois en nombre.
Historique des envois
Pour chaque envoi, le plugin conserve un historique de chaque adresse mail destinataire, date d’envoi, et statut (lu, cliqué, rejeté…) si il est récupéré depuis un service externe. Si vous envoyez beaucoup de lettres à beaucoup de destinataires, cela peut faire grossir la base de données de manière excessive, et dans ce cas il est préférable de purger les statistiques d’envoi pour les vieux envois.
Seul le détail des statistiques sera purgé, mais vous conserverez une statistique globale du nombre de mails reçus, lus, cliqués, rejetés…
Personnalisation du contenu des courriels
Avant chaque envoi d’un email, le plugin déclenche la personnalisation du mail à l’aide des variables qui décrivent le destinataire (voir Newsletters).
Les variables sont celles fournies par le plugin Mailsubscribers pour la description d’un inscrit :
- nom
- listes
- lang
- status
- url_unsubscribe
Pour plus de détail, voir ce que retourne la methode newsletter/subscriber de l’API Newsletter.
Lors de l’envoi à un email unique qui n’est pas forcément inscrit, le plugin essaye de remplir au mieux les variables.
Envoi d’une Info-lettre
L’envoi d’une info-lettre se fait depuis la page d’administration de l’info-lettre, tel que décrit par Newsletters. Un formulaire d’envoi est disponible :
Si la première partie du formulaire sert à faire un envoi unitaire, c’est ici la seconde partie qui nous intéresse. En sélectionnant une liste d’inscrits, on peut déclencher l’envoi en masse à cette adresse en cliquant sur le bouton « Envoyer ! » en regard du selecteur :
On reçoit alors un message de confirmation du déclenchement de l’envoi, et l’envoi en cours apparaît en bas du formulaire. Un résumé de l’avancement apparaît (exprimé en nombre de mails envoyés par rapport nombre total de destinataires). Des boutons de contrôle permettent de mettre l’envoi en pause ou d’abandonner l’envoi.
Tant qu’un envoi est en cours, la liste est rafraichie toutes les 2minutes pour afficher la progression de l’envoi.
Suivi des envois de lot
Il est possible d’avoir une vision plus détaillée des envois de lot (passés en en cours). Pour cela, utilisez le menu Publication > Suivi des envois de mails en nombre. Vous accédez alors à une page qui récapitule les envois en cours et les envois terminés :
Les lots d’envoi en cours sont affichés d’une puce orange, les envois en pause d’une puce blanche, les envois terminés d’une puce verte et les envois abandonnés d’une puce rouge.
Si on clic sur le lien Envoi N°x d’un des envois, on arrive sur une page récapitulative complète qui expose la date et l’avancement de l’envoi, le contenu HTML et texte envoyé, ainsi que la liste des destinataires :
Les destinataires sont regroupés par statut (envoi à venir, envoi réussi, email ouvert, email cliqué, envoi échoué). Il est ainsi possible de retrouver si l’email a déjà été envoyé à un destinataire particulier, ou si il l’a ouvert, ou cliqué sur un lien [4].
Gestion des erreurs
Lorsque l’envoi à un destinataire échoue, on incrémente un compteur de tentative pour ré-essayer en fin de lot. À la 5e tentative en échec l’envoi est marqué en statut fail et n’est plus relancé.
Il est possible de personnaliser ce nombre de 5 tentatives en définissant la constante define('_MAILSHOT_MAX_TRY', 5);
La gestion des bounce est prise en charge avec le service Mandrill qui notifie en HTTP pour signaler quand un envoi a été rejeté. Dans le cas de l’envoi par SMTP on ne gère pas les bounce (l’API interne le permet au moyen de la fonction newsletter/feedback mais il faut implémenter la partie relève d’une boite mail qui sert à collecter les bounces).
Pour le service Mailjet, l’API calcule les bounces.
Si la même adresse de destinataire a été vue en échec ou en bounce lors des 3 derniers envois (et que chacun de ces envois a réussi pour au moins un destinataire) cette adresse est automatiquement désabonnée de toutes les listes.
Il est possible de personnaliser ce seuil de 3 envois en définissant la constante define('_MAILSHOT_MAX_FAIL', 3);
En cas de non-déclenchement des envois :
Si l’envoi ne démarre pas ou met du temps, c’est parce que le cron de SPIP ne fonctionne pas ou pas assez souvent. Vous pouvez le forcer à la main en appelant l’url spip.php?action=cron mais en général c’est lié à un hebergeur qui bloque les appels http sortant, ou un site avec vraiment très peu de traffic.
Dans ce cas, un paliatif peut-être d’ajouter dans le fichier mes_options.php la ligne :
define('_HTML_BG_CRON_FORCE',true);
Migration depuis un ancien plugin
Lors de l’installation, le plugin regarde si les plugins SPIP-Listes ou SPIP-Lettre étaient auparavant utilisés. Si les tables correspondantes sont détectées, l’historique des envois (et des destinataires si possible) est automatiquement importé. Il contient naturellement le contenu HTML et Texte qui avait été envoyé.
Après avoir installé le plugin Mailshot et vérifié que toutes les anciens envois ont bien été importés, vous pouvez désinstaller votre ancien plugin pour supprimer ses données si vous le souhaitez.
Discussions par date d’activité
127 discussions
Bonjour à tous,
Il semble que je sois le seul, mais le plugin MailShot refuse de s’activer sur mon dédié.
SPIP est en version 3.0.7 avec Mailshot en version 1.3.5
ça charge un moment puis ce message apparaît : « Certaines actions n’ont pas été réalisées. Cela peut provenir d’une erreur lors des actions à réaliser, ou d’un affichage de cette page alors que des actions sont encore en cours. »
Parfois ce message ne s’affiche même pas et je suis obligé de renommer le plugin en ftp pour débloquer la page /ecrire/ ?exec=admin_plugin qui ne cesse de charger...(avec uniquement le header qui s’affiche).
Je précise que le plugin MailSubscribers s’active sans problème. Les autres plugins également.
Ce problème était déjà présent sous SPIP 3.0.5
Quelqu’un a-til la solution à ce problème ?
Merci
Vincent
Bonjour à tous,
J’ai un tout petit peu avancé sur mon problème grâce à l’IRC de spip.
J’ai vérifié à nouveau les droits d’accès des plugins et tout remis sur 777.
Une ultime activation qui a duré un long moment a pu réussir !!!
Est-ce que cela provenait des droits d’accès ou des requêtes trop longues de ce plugin ?!?... Mystère.
Répondre à ce message
Bonjour,
je viens d’installer MailShot, Mailsubscribers et Newsletters pour gérer nos lettres notre site à jour spip 3 et sarka.
j’ai paramétré l’envoi via smtp, ça fonctionne pour les tests mais pas avec un envoi réel. De plus, lorsque j’effectue l’inscription de nouveaux utilisateurs, ils ne reçoivent de demande de validation bien que la fonction soit activée.
j’ai donc essayer avec une api mandrill, mais j’obtiens l’erreur suivant Cf. pièce jointe.
je pense qu’il s’agit d’un pb cURL sur le serveur :est-ce bien cela ou me trompe-je ?
d’avance merci pour l’aide
cordialement
Du point de vue du plugin, l’envoi en test et l’envoi réel se font de la même façon. Si l’envoi par SMTP fonctionne en test, il doit aussi fonctionner pour l’envoi réel, aux limites fixées par le SMTP près (nombre maxi d’envoi par minute par heure...).
Pour Mandrill, en effet je vois que la librairie utilisée ne passe pas avec safe_mode et/ou open_basedir (mais je penche pour safe_mode car on l’utilise sur un hébergement avec open_basedir sans problème). Je vais voir si il y a moyen de faire mieux.
Super ;o)
et merci beaucoup pour la réactivité... Je teste sur la semaine avec des nombres d’abonnés différents en fonction des lettres, via le smtp et j’effectuerai un point le week-end prochain.
Ce que je note sur cette journée c’est le décalage notable lorsque l’on utilise le smtp... Est-ce normal ?
A suivre...
Qu’appelle-tu « décalage notable » ? Du côté du site, l’envoi n’est pas immédiat car cela passe par un cron, qui peut prendre un peu de retard si ton site a vraiment très peu de visites. Mais ensuite si il y a du retard dans l’acheminement, cela vient surement du SMTP lui même, qui peut être engorgé ou autre.
La version 1.3.5 du plugin sait fonctionner sans cUrl ou quand safe_mode/open_basedir sont activés !
Bonsoir,
Merci pour les modifs, je n’ai plus d’erreur lorsque je souhaite envoyer une lettre mais j’ai vraiment un temps d’attente que je n’arrive pas à comprendre (j’ai modifié Mailshot en lui indiquant d’utiliser Mandrill) ?
Un temps d’attente entre quoi et quoi ? Combien de temps ? 1min, 5min, 30min, plus d’une heure ?
Alors, depuis mon précédent message (15’) ça n’est pas envoyé :o) J’effectue mes tests sur une lettre qui ne dispose que d’une adresse de courriel.
C’est sur un site avec du traffic ? Ou un site de test sans visites ?
Bonjour Cédric,
Il s’agit d’un site d’établissement scolaire, en moyenne 250/300 visites par jour. Est-ce important ou pas comme trafic ?
Répondre à ce message
Bonjour,
Après ma 1re aventure (voir ci-dessous la nécessité de cURL pour utiliser Mandrill), j’ai installé ce plugin dans un second site ... pour lequel je n’ai pas la maitrise de l’hébergement, il est chez 1&1 (que je déteste encore plus cordialement maintenant).
Il semblerait, bien que cette info soit limite impossible à obtenir du support 1&1 mais de nombreux posts en attestent sur le net, que 1&1 interdise l’accès au SMTP depuis ses serveurs mutualisés, que ce soit à ses propres serveurs ou à d’autres (j’ai tenté OVH et mon propre SMTP aussi, inutile de m’expliquer le paramètrage d’un SMTP, je l’ai fait un bon million de fois dans toutes les positions possibles :-).
C’est vrai qu’en général (en tous cas dans toutes les configs que j’ai vu disons dans ces 15 dernières années) on utilise en général la fonction mail de PHP, c’est la première fois, avec ce plugin, que l’on m’impose SMTP ... Je ne discute pas le choix, qui a son intérêt. Mon problème est que démarrer un compte Mandrill pour envoyer 3 tests est un peu overkill (car le client enverra de toutes façons le mail par un autre biais) ...
J’avais donc une question sur la zone en « grisé » qui parle d’utiliser le réglage de Facteur. Il me semblait comprendre que si Facteur était réglé sur mail(), Mailshot utiliserait quand même ce réglage, je cite :
Ce qui n’est pas conseillé plus haut, c’est mail(), donc pour moi ça implique que si mail() est utilisé , ça l’utilisera, bien que pas conseillé. Hors cela ne semble pas être le cas, en fait ça ne reprend le réglage de Facteur que si c’est déjà du SMTP ... c’est bien ça ? (si oui dans ce cas à mon avis il faudrait refaire cette phrase ... voire même le message de l’interface).
Merci. Pierre.
PS : par contre si quelqu’un a réussi avec SMTP+1&1, ça m’intéresse quand même de savoir ...
Oui tu as bien compris, si le réglage par défaut est mail() il n’est pas accepté par Mailshot. Peut-être qu’on pourrait être un peu moins strict et permettre de contourner cette restriction par un
define()réservé aux développeurs en phase de test.Mais je vois tellement d’utilisateurs qui envoient leurs mails sans se poser de questions et s’étonnent ensuite que tous les mails arrivent en SPAM (y compris les mails d’inscription, de contact etc.) que je pense qu’il faut vraiment être rigide dans ce que permet le plugin.
L’envoi en nombre n’est devenu sérieusement possible qu’en passant par un fournisseur de service spécialisé dans ce domaine, sauf à se faire blacklister chez les grands fournisseurs de mail.
Oh comme je disais, je ne conteste pas ce choix qui me parait pertinent, disons plutot que je maudis 1&1 pour leur restriction SMTP qui me coince ...
Je crois que je vais ouvrir un compte Mandrill juste pour les tests de ce site :-)
Merci. Pierre.
Répondre à ce message
Bonjour,
Je tente de faire fonctionner Mailshot avec Mandrill ... sans trop de succès pour l’instant.
On a Facteur 2.3.1, MailShot 1.3.4, MailSubscribers 1.2.1 et Newsletters 1.2.2, dans spip 3.0.5.
On vient de créer un compte Mandrill, puis une API Key que l’on a reporté dans Mailshot ... Quand on tente d’envoyer une newsletter en mode test à une personne, la petite roue tourne sans fin ... aucune réaction, pas de message d’erreur ... dans l’interface Mandrill, rien non plus, aucun API Call (ni failed ni successfull) ...
Y-a-t-il autre chose qu’il faille paramètrer dans Mandrill (je m’interrogeais sur la nécessité de créer une « App » dans Mandrill ... j’ai tenté mais il considère que l’adresse de mon site n’est pas valide ... alors que le site fonctionne, bizarre mais je ne suis pas sûr de l’url qu’il faut mettre) ?
Coté Spip ... je peux voir des erreurs ou ?
Y-a-t-il un délai quand on crée un compte Mandrill ?
Devrais-je plutot démarrer avec le SMTP Mandrill ?
Que de questions ;.. :-)
Merci pour une éventuelle piste !
Pierre
Ton site ne serait pas hébergé par Free par hasard ? Si c’est le cas toutes les requetes http sortantes sont bloquées, et ça exlue entre autre d’utiliser des services externes comme Mandrill.
Bonjour,
Non pas chez Free, sur un VPS à moi. J’essaye de réfléchir si j’ai un autre cas de requetes http sortantes sur les multiples autres sites de ce VPS là ... comment pourrai-je tester ça ? un wget en ssh ?
(il me revient que sur ce même site j’ai un problème de rafraichissment d’un flux de syndication ... mais le rafraichissement manuel fonctionne donc non ...)
On pourrait tester comment Mandrill en se plaçant en ssh ?
Pierre
Bon je pense avoir trouvé le problème après avoir bien gratté ... il semblerait que Mandrill nécessite que la librairie cURL soit installée sur le serveur ... une fois installée, l’envoi marche ..
Je caressais le fol espoir que cela corrige aussi mon pbm de mise à jour de sites syndiqués ... ça n’a pas l’air.
Pierre.
Répondre à ce message
Bonsoir je suis chez OVH, j’ai un site en SPIP 3.0.4. J’ai installé le plugin « facteu »r qui fonctionne (test réalisé avec succès), j’ai installé dans le répertoire plugins « MailSubscribers 1.0.1 » je l’ai activé par contre MailShot 1.2.3 et Newsletters 1.1.2 apparaissent comme version incompatible ! Voyant cela j’ai supprimé les 2 plugins et je les téléchargé une nouvelle fois mais rien de changé.
Liste des plugins installés en image jointe
En effet, la version minimale requise est SPIP 3.0.5
Merci effectivement avec Spip 3.5 ça marche très bien, félicitations, c’est un très gros boulot !
Concernant les mails en erreur j’ai bien configuré mon adresse mail pour les retours dans le plugin « Facteur ». J’ai reçu un mail tout au début de l’envoi qui m’indiquait qu’une adresse n’existait plus et puis rien d’autre, en back office par contre « infolettres » indique 29 fail.
Y a t-i un moyen de savoir quelles adresses sont concernées ?
Désolé, j’ai trouvé la réponse en cliquant sur « envoi n°1 » au niveau « du suivi des envois en nombre », en bas de la lettre il y a la liste des messages partis et de ceux qui n’ont pas été délivrées.
Répondre à ce message
Bonjour,
Et d’abord Merci pour cet ensemble de plugin qui me sera très utile !
Je l’ai installé (dernier Spip 3.0.5, version des qques plugins dont Facteur - que je n’utilise pas - à jour) et je veux l’utiliser avec mon compte Mandrill sauf que voilà :
Validation error: {"message":{"subject":"Sorry, this field can't be left blank."}}Quel champ remplir dans l’infolettre pour que l’objet du courriel soit rempli ?
En effet, ce bug a déjà été reporté sur un site (hébergement mutualisé OVH). Je regarde cela dans le courant de la semaine.
Après analyse le bug vient du réglage « Convertir les mails en iso-8859 » du plugin Facteur. Il suffit de décocher la case pour que tout fonctionne, ou mettre à jour le plugin Mailshot en version 1.2.3 qui corrige le problème.
Répondre à ce message
Bonjour,
Félicitations (et remerciements) pour un plugin extrêmement bien pensé et facile d’emploi. Un éclaircissement (j’utilise un compte Mandrill) : quand vous parlez des fonctionnalités telles que contrôle d’ouverture d’un email ou d’action sur un lien, c’est ce qu’on voit dans l’interface de Mandrill, n’est-ce pas ? Ces infos n’apparaissent pas dans l’interface du plugin lui-même, j’ai bien saisi ?
Cordialement.
Si on parle bien ici de l’interface du plugin : Mandrill prend en compte les bounce, ouverture de mail, clic sur un lien et renvoie cette information au plugin Mailshot via une URL de callback. Le plugin Mailshot mets ensuite à jour ces informations : dans le détail d’un envoi on doit retrouver les destinataires qui ont lu le mail, ceux qui ont cliqué un lien... De ce que j’ai vu, ce feedback n’est pas immédiat, il peut donc y avoir du délai de mise à jour. Et peut-être encore des petits bugs, mais cela marchait comme ça lors de mes tests.
Ok, c’est peut-être ça alors, je revérifierai plus tard. Je me réjouis de tester ça à grande échelle, encore merci.
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires :
|
