Configurer Sparkpost

N’hésitez pas à relire le préambule de cette rubrique avant de créer un compte sur une plateforme tierce .

Présentation

Sparkpost est une société d’envoi de mailing
https://www.sparkpost.com/

Sur les petits volumes ( < 750 emails par jour et < 15.000 par mois ), l’envoi reste gratuit (Avril 2019). Il peut être utilisé comme solution d’envoi pour les plugins SPIP Mailshot et Facteur.

Cet article a pour objectif de vous aider à bien paramétrer la plateforme.

Septembre 2018 : Sparkpost a refondu son interface, les captures ne correspondent plus à l’interface actuelle. Si un volontaire veut proposer des nouvelles captures, n’hésitez pas à me contacter.

Requis technique

La plateforme Sparkpost requiert une configuration précise sur le serveur

Il est nécessaire d’avoir ces options suivantes installées dans votre configuration PHP :

  • CURL
  • Registered Stream Socket Transports : il faut avoir la mention tls1.2

Pour vérifier sa configuration PHP, aller sur la page : http://tondomaine.xxx/ecrire/?exec=info

Chez OVH, on a automatiquement tls1.2 quand on a une config dite « stable »...ce qui se définit dans le fichier .ovhconfig qui doit être à la racine de ton hébergement...

Étape 1 : se créer un compte

Se créer un compte sparkpost et le valider.

Étape 2 : enregistrer le domaine d’envoi

  • Menu Account > Sending Domains : Ajouter votre domaine
  • Ajouter les enregistrements DNS TXT
  • Envoyer un email de postmaster@... ou abuse@...

Le but du jeu est d’avoir tout au vert comme le montre la capture suivante :

Étape 3 : générer les clés de l’API

  • Menu Account > API KEYS : générer vos clés

Dans l’exemple ci-dessus, on a créé 2 clés, l’une pour Facteur (avec l’envoi SMTP uniquement), l’une pour Mailshot (avec tous les droits). Mais vous pouvez utiliser une seule clé si vous le souhaitez.

Étape 5 : Récupérer la configuration du SMTP

  • Menu Account > SMTP RELAY

Étape 6 : Éventuellement ajouter un sous-domaine pour assurer le tracking (les statistiques)

  • Menu Account > Tracking Domaines
  • Ajouter un sous-domaine pour assurer le suivi statistique des envois avec une URL du type stat.xxx.org

Ce genre de paramétrage vous met à l’abri d’un éventuel changement de prestataire ( si demain vous changez de fournisseur)

Étape 7 : générer le webhook

Cette étape est inutile, le webhook sera rempli automatiquement après l’envoi de la 1re newsletter

  • Menu Account > Webhook

Étape 8 : Renseigner les paramètres dans les plugins SPIP Mailshot et Facteur

Aller dans la configuration des plugins

Mailshot ( ecrire/?exec=configurer_mailshot)

  • choisir Sparkpost et renseigner la clé de votre API

Facteur /ecrire/?exec=configurer_facteur (version 3.4.0 minimum)

  • Cocher et renseigner l’option pour forcer le champs From

Chez OVH en mutualisé, deux points cruciaux :

  • Configurer le port 2525 au lieu du port 587
  • Activer l’option « Forcer cette adresse d’envoi quand le From n’est pas sur le même domaine »

Si côté Sparkpost tous les voyants sont verts, il faut maintenant tester que les emails partent bien depuis SPIP.

Bonne chance !

Documentation (en anglais)

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

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