Mailshot

Ce plugin prend en charge l’envoi en nombre d’info-lettres par email.

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.

N’utilisez pas le serveur SMTP de votre fournisseur de mail pour envoyer vos emails en nombre, mais uniquement un serveur SMTP dédié à ça. Si vous n’en avez pas, utilisez un prestataire d’envoi d’emails en nombre.

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) :
Configuration du plugin Mailshot

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 :

  • email
  • 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.

Notes

[1pour bénéficier des fonctions de statistiques d’envoi au sein de SPIP, il faut utiliser l’API v3 de Mailjet

[2pour bénéficier des services de Sparkpost, il faudra que votre serveur fonctionne sous php 5.5.0 minimum

[3qui nécessite maintenant un compte Mailchimp payant

[4les fonctions de tracking sont implémentées avec les services Mailjet, Sparkpost et Mandrill

Dernière modification de cette page le 13 février 2019

Discussion

103 discussions

  • Dans les logs du serveur web apparait très souvent l’appel de :
    /mailshot_webhook.api/

    Avec en plus un code retour en 403. Alors que l’on n’envoi pas de newsletter (sinon tout marche super avec les trois plugins).

    Est-ce bien normal ? Problème de config ? Pour ces appel intempestif à une URL qui n’existe pas à première vue...

    Merci de vos idées / pistes / aide.
    Julien

    Répondre à ce message

  • 1

    en voulant envoyer une infolettre à 1 destinataire, j’ai le message :
    Oups. Une erreur inattendue a empêché de soumettre le formulaire. Vous pouvez essayer à nouveau.

    Je ne sais comment faire ... Est-ce le SMTP ?

    • Bonjour,

      désolé, c’est un peux tard de vous poser cette question. Est ce que vous avez résolu votre problème ? parce que j’ai le même message d’erreur suite au passage en mode sécurité ; https au lieu de http avec mon hébergeur.

    Répondre à ce message

  • 3

    Hello cerdic :-)
    J’arrive pas à savoir la version de la lib que le plug utilise concernant sparkpost :-(
    Par contre, en lisant le change log, je viens de me rendre compte, qu’il faut au minimum php 5.5
    https://github.com/SparkPost/php-sparkpost/blob/master/CHANGELOG.md

    Donc, je propose de mettre dans paquet.xml :

    1. <necessite nom="php" compatibilite="[5.5.0;]" />

    Cela dit, c’est à réfléchir, car comme le plug est fait pour minimum spip 3.0.5, possible que cela posera des problèmes chez des utilisateurs...
    Sinon, le dire dans la doc de ton plug et de l’article d’érational concernant la configuration de Sparkpost ?
    Franck

    • Il existe une syntaxe dans paquet.xml qui permet d’ajouter des balises interprétées uniquement pour certaines versions de SPIP.

    • Ouiii, j’y pensais plus, merci Maieul :-)
      Cela dit, c’est pas forcément une bonne solution non plus, car en faite, spip 3.0 et 3.1 demande minimum php 5.1 quand à spip 3.2 c’est php 5.4, ce qui fait que, je ne peux pas me servir de cette astuce :-(
      Donc, soit, on touche à rien dans paquet.xml et c’est dans la doc du plug qu’il faut le dire, soit faut rendre le plug compatible pour php 5.4 minimum via un necessite.
      Je vais attendre la réponde de Cédric par principe, mais je pense que le mieux, c’est simplement de mettre à jour la doc :-)

    • Hello, :-)
      Cerdric, je me suis permis de mettre à jour la doc https://contrib.spip.net/Mailshot?var_mode=calcul#nh2
      A savoir que sparkpost va faire des modifs dans sont api à partir de novembre :-(
      https://www.sparkpost.com/blog/upcoming-api-transmission-endpoint-changes/

    Répondre à ce message

  • 1

    Bonjour à tous,
    J’utilise depuis quelques mois mailshot, en combinaison avec Newsletter et MailSubscribers + le service SparkPost pour l’envoi.
    Suite à une récente mise à jour, SPIP + tous mes plugins, mes Newsletters ne partent plus.
    Les tests fonctionnent, mais pas l’envoi vers les listes.
    En analysant les logs de SPIP, cela semble dû à l’erreur suivante :
    Au moment de l’envoi, Mailshot cherche à écrire en base la Newsletter et l’erreur « mysql : Unknown column ’from_name’ in ’field list’ » apparaît à ce moment-là.

    Il semblerait qu’il y ait 2 nouveaux champs dans la table Mailshots, et que ma méthode de mise à jour de plugin (simple remplacement de fichiers en FTP) n’ait pas créé ces champs.

    Que faire ? Désinstaller, puis ré-installer le plugin ? J’ai peur de perdre des données (mes anciennes Newsletters entre autres).
    Merci !

    • Bon,
      Via PhpMyAdmin, j’ai modifié la structure de la table _mailshots, en rajoutant les 2 champs (après le champ listes) :
      from_name , text (type), utf8_general_ci (interclassement)
      from_email, text (type), utf8_general_ci (interclassement)

      Et depuis, tout est rentré dans l’ordre.
      Il semblerait donc que dans ses versions plus récentes, le plugin Mailshot ait besoin de 2 champs supplémentaires dans la table _mailshots pour fonctionner correctement.

    Répondre à ce message

  • Régis

    Merci. J’ai configuré Mailshot correctement en cochant « utiliser le même service ... »
    Pour facteur, j’ai mis utiliser les réglages du site, utiliser SMTP, hôte in-v3.mailjet.com, port 587, authentification à « oui », nom utilisateur et mot de passe (clé API et clé secrète) fournis par mailjet comme paramètre SMTP, connexion sécurisée à « non », embarquer les images ...

    J’ai toujours le message « Oups. Une erreur inattendue a empêché de soumettre le formulaire. Vous pouvez essayer à nouveau. » en envoyant à 1 destinataire, et « envoi programmé » en envoyant à la liste des abonnés, mais rien n’arrive. Je ne sais que faire ...

    Répondre à ce message

  • 1

    J’ai envoyé une infolettre par l’intermédiaire de Mailjet en renseignant soigneusement les codes API et pw.
    J’ai bien le message « La newsletter a bien été envoyée à (adresse de reception) », mais le message n’est pas reçu. Que faire ?

    Répondre à ce message

  • 1

    Bonjour,
    Quelle est la tache cron qui permet de purger les détails des vieux envois ? J’ai coché Effacer le détail des anciens envois Plus vieux que 3 mois mais la table spip_mailshots_destinataires n’est pas purgée dans ma base. Merci

    • Alors, est-ce que quelqu’un ici a compris le système d’archivage des envois ?
      J’ai mis « 3 mois » pour effacer le détail des anciens envois mais je me retrouve avec des dizaines de newsletters archivées de 2008 à 2015 et des dizaines d’autres de 2015 à septembre 2016 dans la partie « Envois terminés ».
      Les détails des envois dans les 2 cas semblent identiques.

      Quelqu’un peut-il m’expliquer comment purger par lot les envois supérieurs à 3 mois ?
      Merci

    Répondre à ce message

  • 3

    Bonjour,
    Depuis environ un mois, lorsque je fais un test d’envoi de la newsletter, j’obtiens le message suivant « SMTP Error : Could not authenticate ».
    J’ai contacté le support de l’hébergeur, DRI, qui m’a assuré qu’il n’a fait de changement ni sur le serveur mail ni sur serveur web.
    D’ailleurs, les messages créés dans les boîtes email chez l’hébergeur sont bien envoyés et reçus.
    Avez-vous eu une idée d’où pourrait venir ce problème qui nous empêche d’envoyer les infolettres.
    Merci pour votre aide et tout le travail réalisé.

    • Bonjour,

      Le mot de passe est bien à jour ?
      Pas d’espace dans les renseignements du formulaire ?

    • Bonjour,
      Merci je regarde cela tout de suite.
      Bonne soirée.

    • Bonsoir,
      Merci pour la réponse rapide.
      J’ai à nouveau vérifié les informations saisies mais elles sont bien identiques à celles qui existaient lorsque les infolettres pouvaient être envoyées.
      J’ai fait aujourd’hui un envoi d’email à une liste de diffusion avec les mêmes coordonnées et le message est bien parti et arrivé.

    Répondre à ce message

  • 3

    Bonjour,
    J’utilisais pour l’instant « Ma Lettre » pour envoyer des news, avec le plugin Facteur et une liste free sous ml.free.fr, cela fonctionne bien mais je dois modifier en dur le squelette pour avoir une lettre d’accompagnement.
    J’ai voulu utiliser newsletters, donc obligé d’installer les plugins mailsubscribers et mailshot et la ça se gâte, jusque l’a j’utilisait le service de mail standard php, free n’appréciant pas vraiment l’envoi en groupe, d’ou l’utilisation de la liste ml.
    mailshot ne me donne comme choix que d’utiliser une liste prédéfinie, mailjet, sparkpost, ..
    Y a t’il une solution et si oui, comment prendre en compte ma liste free ?
    Merci par avance de votre aide.
    j’utilise SPIP 3.0.22 avec Sarka-spip 3.2.36, serveur free avec base Mysql

    Répondre à ce message

  • 2

    bonsoir,

    utilisateur de mailshot avec sparkpost depuis pas mal de temps, et à vrai dire, ne regardant pas très souvent le détail du fonctionnement qui globalement... fonctionne !

    Je me lance dans un peu de purge des inscriptions et je constate des envois « échoués » par mailshot et qui sont en bounce ou generation rejection dans sparpost... alors qu’ils ne sont plus inscrits dans mailsubscribers...

    Autrement dit, mailshot prendrait qq part dans un cache des listes d’envoi anciennes...???

    Y-a-t-il qqchose à faire pour forcer la réinitialisation de mailshot...???

    merci d’avance
    pam

    • C’est plus surement le contraire qui s’est produit : comme l’envoi à ces emails a été rejeté ou bloqué par SparkPost, mailshot a désinscrit l’adresse correspondante. Du coup il n’y aura plus d’envoi dans le futur.

    • Tu as sans doute raison, mais alors, elles sont plusieurs fois en échouées avant d’être désinscrits... et je n’arrive pas à comprendre... Je suppose qu’il y a une règle (au bout de 3 bounce ou peut-être au bout de n hardbounces et m softbounces" ?.. Quand je remonte dans l’historique des envois, je vois bien des adresses qui sont plusieurs fois dans échouées.. et qui sont aujourd’hui désinscrites...

      Est-il imaginable de trouver pour chaque adresse désinscrite la trace de ces envois et retours...?

      dans les logs bien sûr, mais on peut imaginer unepage ?

      merci en tout cas pour ces plugins...

      pam

    Répondre à ce message

Ajouter un commentaire

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom