Double opt-in e e-mails de confirmação

Cada lista de contatos pode enviar dois e-mails próprios:

• Double opt-in: um e-mail com um link de confirmação. As pessoas que se inscrevem só entram na lista depois de clicar nele, então cada endereço da lista pertence a alguém que pediu para estar nela.
• E-mail de confirmação: um e-mail curto de “você está inscrito”, enviado logo depois que alguém entra na lista, ou depois que a pessoa confirma, quando o double opt-in está ativado.

Os dois ficam desativados até você ativá-los, e os dois são enviados a partir do seu próprio domínio de envio verificado.

Antes de começar

• Verifique um domínio de envio. Os dois e-mails precisam de um endereço From em um dos seus domínios verificados.
• Cada e-mail custa um crédito, como qualquer outro e-mail.
• Um workspace que ainda não foi verificado só pode enviar e-mails para os próprios membros, então os e-mails de double opt-in para outras pessoas falham até o workspace ser verificado.

Ativar o double opt-in

1. Abra as configurações. Acesse Email Marketing›Audiences, abra a lista e selecione a aba Settings.

2. Defina o remetente. Em Double opt-in, digite um endereço From em um domínio verificado, como News <news@example.com>, e, opcionalmente, um Reply-to.

3. Ajuste o e-mail. Altere Subject, Heading, Text, Button text e Footer, ou mantenha os padrões. A prévia à direita é atualizada enquanto você digita.

4. Escolha para onde as pessoas vão. Opcionalmente, informe uma página em After confirming, go to. Sem ela, as pessoas veem uma página de confirmação com um link para gerenciar as inscrições delas. Ela tem o design da sua página de descadastro e abre no idioma do navegador da pessoa.

5. Ative a opção. Ative Require confirmation e selecione Save.

Salvar falha com a mensagem “Use an address on a verified sending domain of this workspace.” quando o domínio do endereço From não está verificado.

Quais inscrições pedem confirmação

O que acontece depois de uma inscrição

1. O Emailit cria o contato, se ele for novo, sem alterar um contato existente, e envia o e-mail de double opt-in. A pessoa ainda não está na lista. Quem já está inscrito não recebe nenhum e-mail, mas a URL de inscrição retorna 202 mesmo assim, para não revelar quem está na lista.
2. Quando ela abre o link, entra na lista com Subscribed ativado. Um evento subscriber.created é enviado e as automações Added to audience são iniciadas. Em seguida vem o e-mail de confirmação, se ele estiver ativado.
3. Abrir o link de novo não faz mais nada. Os links expiram depois de 30 dias. Quem não confirmou pode se inscrever de novo para receber um novo link. Os links anteriores continuam funcionando até expirarem, e basta confirmar qualquer um deles. Inscrever-se de novo logo depois da primeira vez não envia um segundo e-mail, então a URL de inscrição não pode ser usada para lotar a caixa de entrada de alguém; o primeiro link continua funcionando.

A aba Settings mostra quantas pessoas ainda não confirmaram. Se o e-mail não puder ser enviado, por exemplo porque o domínio não está mais verificado ou o workspace está sem créditos, a pessoa não é adicionada e a URL de inscrição retorna 503. Em vez disso, um formulário adiciona a pessoa na hora, para que a inscrição não se perca, e a resposta registra o erro.

Enviar um e-mail de confirmação

1. Abra as configurações. Na aba Settings da lista, vá até Confirmation email.

2. Escreva o e-mail. Digite um endereço From em um domínio verificado e ajuste os textos. Adicione Button text e Button link para levar as pessoas ao seu site, ou deixe-os vazios para um e-mail sem botão.

3. Ative a opção. Ative Send it e selecione Save.

O e-mail de confirmação vai para as pessoas que entram pela URL de inscrição, por um formulário, por um link de double opt-in ou pela página de gerenciamento de inscrições. Quando você mesmo adiciona pessoas, ele só é enviado se você pedir: marque Send the confirmation email em Add subscriber ou passe "send_confirmation_email": true para a API. Importações e mesclagens nunca o enviam.

Um e-mail de confirmação que não pôde ser enviado não desfaz a inscrição.

Variáveis

O assunto, os textos e os designs personalizados podem usar variáveis do Temple. Os valores do contato são escapados antes de entrar no e-mail.

Text e Footer mantêm as quebras de linha e aceitam HTML inline, como <a> e <strong>. Heading e Button text são texto simples. O botão do double opt-in sempre leva a {{confirm_url}}.

Criar o design do e-mail em MJML

Para alterar o layout, selecione Customize in the MJML visual editor. O editor abre com o design padrão e os seus textos atuais. Ao salvar, o e-mail passa a usar Custom design (MJML). Mude Design de volta para Default design para usar os textos de novo; o design personalizado é mantido.

Um e-mail de double opt-in personalizado precisa ter um link para {{confirm_url}}. Salvar um e-mail sem esse link falha com a mensagem “The double opt-in email must link to {{confirm_url}}.”

Testar os e-mails

Abaixo de cada prévia, digite um endereço em Send a test to e selecione Send test. O teste usa a versão salva, então salve as suas alterações primeiro. Os e-mails de teste usam valores de exemplo para o contato, e os links deles não inscrevem ninguém.

Usar a API

Atualizar uma lista de contatos define os dois e-mails. Envie apenas os campos que você quer alterar:

curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "double_opt_in": {
      "enabled": true,
      "redirect_url": "https://example.com/welcome",
      "email": { "from": "News <news@example.com>", "subject": "Confirm your subscription to {{audience_name}}" }
    },
    "confirmation_email": {
      "enabled": true,
      "email": { "from": "News <news@example.com>", "button_label": "Read the latest issue", "button_url": "https://example.com/blog" }
    }
  }'

Depois, peça a confirmação ao adicionar alguém:

curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "double_opt_in": true }'

A resposta é 202 com "status": "pending". Definir um design personalizado (email.source) pela API faz parte da fase alfa do MJML.

Veja também