- XF Compatibility
- 2.3.x
- 2.2.x
- Descrição curta
- 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.
Adiciona uma opção de transporte de e-mail SparkPost para que todos os e-mails sejam enviados por você.SparkPostcadastro.
Este adendo tem suporte completo para o tratamento de emails rebatidos e desinscritos usando a API dos eventos do SparkPost - sem necessidade de caixa postal.ConfiguraçãoSe ainda não havia feito isso, você precisará configurar um domínio de envio para seu fórum em sua conta SparkPost. É recomendado que também configure um domínio de rebatimento padrão.
Você então precisará criar uma chave API com as seguintes permissões:
Note que o classe de transporte de email deve ser \SwiftSparkPost\Transport - se não for, então você não instalou ou ativou o addon corretamente.
Também existe uma segunda ferramenta de teste que permite especificar se enviar emails transacionais ou não-transacionais. Vá para o UI do administrador > Ferramentas > Teste SparkPost
Ative a caixa de seleção para enviar email transacional - desative para enviar não-transacional.
Em todos os casos, você deve examinar os cabeçalhos dos emails que recebe para verificar se foi enviado via SparkPost e validar a presença/ausência do header List-Unsubscribe.Emails Transacionais vs Email Não TransacionaisTransacionale-mails são e-mails automatizados enviados por um sistema para comunicar-se com um cliente ou usuário de uma página sobre informações relevantes para sua conta ou uso do seu site. Eles são geralmente específicos a um usuário individual e são frequentemente importantes para o usuário para o uso contínuo do seu site.
Exemplos de e-mails transacionais são:
Por padrão, o SparkPost marca todos os emails enviados através de sua API como "não-transacionais". Este addon altera esse comportamento e define todas as mensagens do fórum como transacionais, exceto:
Você NÃO precisa configurar uma "Endereço de email de rejeição" (a menos que você não tenha um domínio de rebote padrão configurado) ou "Endereço de email de desinscrição" em suas opções de e-mail. Também não precisa habilitar o "Gerenciador de e-mail automático" ou as opções "Habilitar gerenciamento de e-mail automático" - a SparkPost não envia emails de rebota ou notificações de desinscrição por email - nós fazemos uma consulta à API para determinar informações sobre rebota / desinscrição.
A manutenção de desinscrição é um pouco mais sofisticada do que o sistema padrão XenForo - já que diferenciamos entre emails transacionais e não-transacionais e os tratamos de maneira diferente.
Note que se recebemos um rebote duradouro para emails transacionais, a conta do usuário será desativada para prevenir a envio de mais emails.Lista de supressãoQuando o SparkPost recebe um hard bounce de uma e-mail enviada ou uma solicitação List-Unsubscribe, ele colocará esse endereço de e-mail em uma lista de supressão, o que significa que você não pode mais enviar email para essa usuária. Isso está em vigor para proteger sua reputação de envio - já que continuar enviando emails para um endereço inválido ou desinscrito é um indicador de spam que poderia vê-lo bloqueado por alguns provedores de e-mail.
O ponto a ser observado é que se uma conta do fórum de usuários foi desativada devido a bounces, ela provavelmente terá sido adicionada à lista de supressão SparkPost também. Se você reativar sua conta sem alterar o endereço de email, eles podem não receber mais emails da sua página porque enviar para eles está bloqueado pelo SparkPost.
Se você estiver certo de que o email agora é válido, você pode removê-los da lista de supressão do SparkPost - no console de administração do SparkPost -https://app.sparkpost.com/lists/suppressionsLembre-se apenas que existem duas listas separadas - uma para e-mails de transação e outra para e-mails não-transacionais.
Este adendo tem suporte completo para o tratamento de emails rebatidos e desinscritos usando a API dos eventos do SparkPost - sem necessidade de caixa postal.ConfiguraçãoSe ainda não havia feito isso, você precisará configurar um domínio de envio para seu fórum em sua conta SparkPost. É recomendado que também configure um domínio de rebatimento padrão.
Você então precisará criar uma chave API com as seguintes permissões:
- [*Mensagens de Eventos: Somente leitura[Transmissões: Leitura/Escrita[*N]*(Nota, versão atual instrui você para permitir o acesso ao permission de Send via SMTP API, mas isso énãorequisitos - essas instruções serão removidos em uma versão futura.)
- []*Tracking de Cliqueliga rastreamento de clique em todos os links em e-mails enviados[]*Open Trackingadiciona uma imagem rastreamento em todas as emails enviados para rastrear aberturas[]*Eventos de Mensagem Sizing do Lotepermite que você configure como muitos eventos o sistema tentará recuperar em cada lote. Em geral, você não deve precisar ajustá-lo do valor padrão.[]*Modo de Testesanp.sink.sparkpostmail.com
Note que o classe de transporte de email deve ser \SwiftSparkPost\Transport - se não for, então você não instalou ou ativou o addon corretamente.
Também existe uma segunda ferramenta de teste que permite especificar se enviar emails transacionais ou não-transacionais. Vá para o UI do administrador > Ferramentas > Teste SparkPost
Ative a caixa de seleção para enviar email transacional - desative para enviar não-transacional.
Em todos os casos, você deve examinar os cabeçalhos dos emails que recebe para verificar se foi enviado via SparkPost e validar a presença/ausência do header List-Unsubscribe.Emails Transacionais vs Email Não TransacionaisTransacionale-mails são e-mails automatizados enviados por um sistema para comunicar-se com um cliente ou usuário de uma página sobre informações relevantes para sua conta ou uso do seu site. Eles são geralmente específicos a um usuário individual e são frequentemente importantes para o usuário para o uso contínuo do seu site.
Exemplos de e-mails transacionais são:
- []*criação e ativação de emails de conta*recibos de compra e notificações de despacho[]*notas legais e importantes sobre o site
- [newsletter[*vendas ofertas[*nova atualização de produto[]*e-mail projetado para aumentar a engajamento do usuário e o processo de onboarding, entre outros
Por padrão, o SparkPost marca todos os emails enviados através de sua API como "não-transacionais". Este addon altera esse comportamento e define todas as mensagens do fórum como transacionais, exceto:
- []*E-mails enviados pelo painel administrativo - Comunicação > Enviar e-mail para usuários[]*Bem-vindo(a) emails
- [emails não transacionais adicionam o cabeçalho List-Unsubscribe (sobrescreve o adicionado pelo XenForo) para solicitações de desconto único em alguns clientes de e-mail. Emails transacionais não contêm este cabeçalho.[*há listas de supressão separadas para e-mails transacionais e não-transacionais. Se alguém se inscrever em lista negra para e-mails não-transacionais, você ainda pode enviar eles sobre assinaturas de fóruns e resets de senha. No entanto, se alguém se inscrever ou bloquear você nos e-mails transacionais, você deve desativar sua conta, pois mais tarde não será possível enviar e-mail a eles sobre informações importantes do fórum.
Você NÃO precisa configurar uma "Endereço de email de rejeição" (a menos que você não tenha um domínio de rebote padrão configurado) ou "Endereço de email de desinscrição" em suas opções de e-mail. Também não precisa habilitar o "Gerenciador de e-mail automático" ou as opções "Habilitar gerenciamento de e-mail automático" - a SparkPost não envia emails de rebota ou notificações de desinscrição por email - nós fazemos uma consulta à API para determinar informações sobre rebota / desinscrição.
A manutenção de desinscrição é um pouco mais sofisticada do que o sistema padrão XenForo - já que diferenciamos entre emails transacionais e não-transacionais e os tratamos de maneira diferente.
Note que se recebemos um rebote duradouro para emails transacionais, a conta do usuário será desativada para prevenir a envio de mais emails.Lista de supressãoQuando o SparkPost recebe um hard bounce de uma e-mail enviada ou uma solicitação List-Unsubscribe, ele colocará esse endereço de e-mail em uma lista de supressão, o que significa que você não pode mais enviar email para essa usuária. Isso está em vigor para proteger sua reputação de envio - já que continuar enviando emails para um endereço inválido ou desinscrito é um indicador de spam que poderia vê-lo bloqueado por alguns provedores de e-mail.
O ponto a ser observado é que se uma conta do fórum de usuários foi desativada devido a bounces, ela provavelmente terá sido adicionada à lista de supressão SparkPost também. Se você reativar sua conta sem alterar o endereço de email, eles podem não receber mais emails da sua página porque enviar para eles está bloqueado pelo SparkPost.
Se você estiver certo de que o email agora é válido, você pode removê-los da lista de supressão do SparkPost - no console de administração do SparkPost -https://app.sparkpost.com/lists/suppressionsLembre-se apenas que existem duas listas separadas - uma para e-mails de transação e outra para e-mails não-transacionais.