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 1ère 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)

Portfolio

updated on 2 October 2019

Discussion

11 discussions

  • 2

    Je rencontre un souci avec Sparkpost. Il filtre les domaines d’envoi. De ce fait, les formulaires de contact ne fonctionnent plus car l’expéditeur est l’adresse mail renseignée par le visiteur.

    Une solution a-t-elle été trouvé à ce problème ?

    • Les versions récentes du facteur possèdent une option qui permet de forcer le from si le domaine renseigné n’est pas celui du site. L’adresse du reply reste celle du visiteur.
      Cela permet d’utiliser des plateformes d’envois et de conserver les mêmes fonctionnalités.

    • Je n’avais pas vu cette nouveauté.

      Tout est rentré dans l’ordre, merci beacoup !

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom