- XF Compatibility
- 2.3.x
- 2.2.x
- Description courte
- Add SparkPost mail transport for seamless email sending with full support for bounced and unsubscribed emails via XenForo's built-in addon, including advanced click tracking and open tracking features. Setup involves configuring your SparkPost account and API key in the Email options page. Test functionality using XenForo's test system to ensure proper integration.
Ajoute une option SparkPost pour que toutes les-mails soient envoyées par vous.SparkPostaddon compte a support complet de gestion des emails renvoyés et désabonnements utilisant l'API des événements SparkPost - pas de boîte mail requise.ConfigurationSi vous n'avez pas encore fait cela, vous devrez configurer un domaine de diffusion pour votre forum dans votre compte SparkPost. Il est recommandé que vous configuriez également un domaine par défaut d'atterrissage. Vous serez ensuite obligé de créer une clé API avec les permissions suivantes:
Notez que le classeur de transport doit être \SwiftSparkPost\Transport - si ce n'est pas le cas, cela signifie que vous n'avez pas installé ou activé correctement l'addon.
Il existe également un deuxième système de test qui permet de spécifier s'il faut envoyer des emails transactionnels ou non. Aller à l'interface d'administration > Outils > Tester SparkPost
Cochez la case pour envoyer des emails transactionnels - décochez-la pour envoyer des emails non transactionnels.
Dans tous les cas, examinez les en-têtes des emails que vous recevez pour vérifier qu'ils ont bien été envoyés via SparkPost et pour valider l'existence/absence du header List-Unsubscribe.Emails transactionnels et non transactionnelsTransactionnelles emails sont des emails automatisés envoyés par un système pour communiquer avec un client ou un utilisateur du site sur des informations pertinentes à leur compte ou l'utilisation de votre site. Ils sont généralement spécifiques à un utilisateur individuel et sont généralement importants pour l'utilisateur pour la continuité de l'utilisation de votre site.
Exemples d'emails transactionnels sont :
Par défaut, SparkPost marque tous les emails envoyés via leur API comme "non-tranactionnels". Ce filtre change cela et met à jour toutes les emails du forum pour qu'ils soient tranactionnels sauf pour:
Vous NE N'AVEZ PAS À CONFIGurer une "Adresse e-mail de rebounce" (sauf si vous n'avez pas d'hôte de rebounce par défaut configuré) ou une "Adresse e-mail des abonnements supprimés" dans vos options d'e-mails. Vous NE N'AVEZ PAS À Activer le "Gestionnaire d'e-mails automatisé" ou l'option "Activer la gestionnaire d'e-mails automatisée" - SparkPost ne transmet pas les emails rebounced ni les notifications des abonnements par e-mail - nous queryons leur API pour déterminer les informations sur les rebounce / abonnement.
La gestion des abonnements supprimés est un peu plus sophistiquée que le système standard de XenForo - puisque nous distinguons entre les emails transactionnels et non transactionnels et qu'ils sont gérés différemment.
Notez que si nous recevons un rebounce hard pour les emails transactionnels, l' compte utilisateur sera désactivé pour prévenir la transmission d'e-mails supplémentaires.Listes de suppressionQuand SparkPost reçoit un retour de réception dur d'un e-mail envoyé ou une demande List-Unsubscribe, il placera cette adresse e-mail sur une liste de suppression, ce qui signifie que vous ne pourrez plus envoyer d'e-mails à cette utilisateur. Cela est en place pour protéger votre réputation de relai - puisqu'envoyer d'e-mails à une adresse invalide ou désabonnée est un indicateur de spam qui pourrait vous voir bloqué par certains fournisseurs d'e-mail.
Il faut être vigilant : si un compte forum d'un utilisateur a été désactivé en raison des retours de réception, il sera probablement ajouté à la liste de suppression de SparkPost. Si vous réactivez leur compte sans changer l'adresse e-mail, ils pourraient ne pas recevoir d'e-mails de votre site car l'envoi à eux est bloqué par SparkPost.
Si vous êtes sûr que l'email est maintenant valide, vous pouvez le supprimer de la liste de suppression de SparkPost - dans la console d'administration de SparkPost -https://app.sparkpost.com/lists/suppressionsRappelez-vous que les deux listes sont séparées - une pour les emails transactionnels et l'autre pour ceux qui ne le sont pas.
- []*Messagerévènements : Seulement lecture[]Transmissions : Lecture/Ecriture[]*Note, la version actuelle vous instruit de permettre l'autorisation Permission Send via SMTP API, mais cela estpasrequis - ces instructions seront supprimés dans une version futures.
- []]*Click Trackingactiveusestrackingsurtoallslinksdanslesemailsenvoyés[]]*Open Trackingajoute une image de suivi à toutes les emails envoyés pour suivre les ouvertures[]]*Messages Evenements Taille du Lotspermet de configurer le nombre d'événements que le système essaiera de récupérer dans chaque lot. En général, vous ne devriez pas besoin de le ajuster du niveau par défaut.[]]*Mode Testajouter '.sink.sparkpostmail.com' à toutes les adresses e-mail de destinataire pour tester la communication avec SparkPost sans envoyer d'e-mails réels aux destinataires.
Notez que le classeur de transport doit être \SwiftSparkPost\Transport - si ce n'est pas le cas, cela signifie que vous n'avez pas installé ou activé correctement l'addon.
Il existe également un deuxième système de test qui permet de spécifier s'il faut envoyer des emails transactionnels ou non. Aller à l'interface d'administration > Outils > Tester SparkPost
Cochez la case pour envoyer des emails transactionnels - décochez-la pour envoyer des emails non transactionnels.
Dans tous les cas, examinez les en-têtes des emails que vous recevez pour vérifier qu'ils ont bien été envoyés via SparkPost et pour valider l'existence/absence du header List-Unsubscribe.Emails transactionnels et non transactionnelsTransactionnelles emails sont des emails automatisés envoyés par un système pour communiquer avec un client ou un utilisateur du site sur des informations pertinentes à leur compte ou l'utilisation de votre site. Ils sont généralement spécifiques à un utilisateur individuel et sont généralement importants pour l'utilisateur pour la continuité de l'utilisation de votre site.
Exemples d'emails transactionnels sont :
- []création et activation des comptes emails[]*réinitialisation des mots de passe et authentification à deux facteurs[]*nvigation et alertes de compte[]notifications résultant des abonnements ou des options d'alerte auxquelles le utilisateur a opté[]reçus de commande et notifications d'expédition[]]*site de notices légales et importantes
- []*[newsletters[]offres de vente[]*nouveaux mises à jour du produit[]]*email conçu pour augmenter l'engagement des utilisateurs et l'inscription, etc
Par défaut, SparkPost marque tous les emails envoyés via leur API comme "non-tranactionnels". Ce filtre change cela et met à jour toutes les emails du forum pour qu'ils soient tranactionnels sauf pour:
- []*[E-mails envoyés via l'UI d'administration - Communication > Envoyer à des utilisateurs[]
- []emails non-tranquilistes ont une en-tete List-Unsubscribe ajoutee (qui surclasse l'en-tete ajoute par XenForo) pour les demandes d'abandon de suscription un clic dans certains clients email. Les emails transtionnels ne contiennent pas cette en-tete.[]il y a des listes de suppression séparées pour les emails transactionnels et non-transactionnels. Si quelqu'un désabonne des emails non-transactionnels, vous pouvez toujours leur envoyer des emails transactionnels importants comme les abonnements au forum et les rappels de mot de passe. Cependant, si quelqu'un désabonne ou bloque l'envoi d'emails transactionnels, vous devriez désactiver leur compte, car vous ne pourrez plus les contacter sur des sujets importants du forum.
Vous NE N'AVEZ PAS À CONFIGurer une "Adresse e-mail de rebounce" (sauf si vous n'avez pas d'hôte de rebounce par défaut configuré) ou une "Adresse e-mail des abonnements supprimés" dans vos options d'e-mails. Vous NE N'AVEZ PAS À Activer le "Gestionnaire d'e-mails automatisé" ou l'option "Activer la gestionnaire d'e-mails automatisée" - SparkPost ne transmet pas les emails rebounced ni les notifications des abonnements par e-mail - nous queryons leur API pour déterminer les informations sur les rebounce / abonnement.
La gestion des abonnements supprimés est un peu plus sophistiquée que le système standard de XenForo - puisque nous distinguons entre les emails transactionnels et non transactionnels et qu'ils sont gérés différemment.
Notez que si nous recevons un rebounce hard pour les emails transactionnels, l' compte utilisateur sera désactivé pour prévenir la transmission d'e-mails supplémentaires.Listes de suppressionQuand SparkPost reçoit un retour de réception dur d'un e-mail envoyé ou une demande List-Unsubscribe, il placera cette adresse e-mail sur une liste de suppression, ce qui signifie que vous ne pourrez plus envoyer d'e-mails à cette utilisateur. Cela est en place pour protéger votre réputation de relai - puisqu'envoyer d'e-mails à une adresse invalide ou désabonnée est un indicateur de spam qui pourrait vous voir bloqué par certains fournisseurs d'e-mail.
Il faut être vigilant : si un compte forum d'un utilisateur a été désactivé en raison des retours de réception, il sera probablement ajouté à la liste de suppression de SparkPost. Si vous réactivez leur compte sans changer l'adresse e-mail, ils pourraient ne pas recevoir d'e-mails de votre site car l'envoi à eux est bloqué par SparkPost.
Si vous êtes sûr que l'email est maintenant valide, vous pouvez le supprimer de la liste de suppression de SparkPost - dans la console d'administration de SparkPost -https://app.sparkpost.com/lists/suppressionsRappelez-vous que les deux listes sont séparées - une pour les emails transactionnels et l'autre pour ceux qui ne le sont pas.