Double Opt-In

Visão geral

O double opt-in exige que novos contatos confirmem o endereço de e-mail antes de ficarem inscritos. Quando ativado em uma lista de contatos, todo contato recém-adicionado recebe um e-mail de confirmação com um link de verificação. Só depois de clicar no link ele passa a ficar totalmente inscrito.

Por que usar double opt-in?

• Garante que os endereços de e-mail são válidos e pertencem ao inscrito
• Reduz taxas de bounce e reclamações de spam
• Melhora a entregabilidade e a reputação do remetente
• Ajuda na conformidade com regulamentações de e-mail marketing (LGPD, GDPR, CAN-SPAM)

Como funciona

1. O contato é adicionado

   Quando um contato é adicionado a uma lista com double opt-in ativado (pelo dashboard, pela API ou por importação de CSV), ele é criado com o status Pendente, em vez de ser inscrito imediatamente.

2. O e-mail de confirmação é enviado

   Um e-mail de confirmação é enviado automaticamente ao contato com um link de verificação único. O link é assinado com HMAC-SHA256 e expira em 7 dias.

3. O contato confirma

   O contato clica no link de verificação do e-mail e confirma a inscrição na página de confirmação.

4. O contato fica inscrito

   O status do contato muda de Pendente para Inscrito e ele passa a receber seus e-mails.

Ativando o double opt-in

Pelo dashboard

1. Acesse Contatos e selecione uma lista de contatos
2. Clique na aba Double Opt-In
3. Ative o double opt-in
4. Personalize o e-mail de confirmação (opcional)
5. Salve as alterações

Pela API

Crie uma lista de contatos com double opt-in ativado:

curl -X POST https://app.madmail.com.br/api/v1/contactBooks \
  -H "Authorization: Bearer us_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter Subscribers",
    "doubleOptInEnabled": true,
    "doubleOptInFrom": "Newsletter <hello@yourdomain.com>",
    "doubleOptInSubject": "Please confirm your subscription"
  }'

Ou ative em uma lista já existente:

curl -X PATCH https://app.madmail.com.br/api/v1/contactBooks/{contactBookId} \
  -H "Authorization: Bearer us_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "doubleOptInEnabled": true
  }'

Status dos contatos

Com o double opt-in ativado, os contatos podem ter três status:

Personalizando o e-mail de confirmação

Você pode personalizar três aspectos do e-mail de confirmação:

Endereço de remetente

Defina um remetente personalizado para os e-mails de confirmação. O endereço precisa usar um dos seus domínios verificados.

{
  "doubleOptInFrom": "Newsletter <hello@yourdomain.com>"
}

Se não for definido, o e-mail de confirmação será enviado pelo primeiro domínio verificado disponível.

Assunto

Personalize o assunto do e-mail. O padrão é “Please confirm your subscription”.

{
  "doubleOptInSubject": "Confirm your subscription to our newsletter"
}

Template do e-mail

O corpo do e-mail de confirmação pode ser personalizado no editor de e-mails do Madmail (pelo dashboard) ou enviando o conteúdo JSON do editor pela API.

Variáveis do template

As variáveis a seguir podem ser usadas no template do e-mail de confirmação:

Reenviando e-mails de confirmação

Se um contato ainda não confirmou a inscrição, você pode reenviar o e-mail de confirmação pelo dashboard:

1. Abra sua lista de contatos e localize o contato pendente
2. Clique no botão Reenviar ao lado do contato

Cada reenvio gera um novo link de confirmação, com uma nova janela de validade de 7 dias.

Boas práticas