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

> Peça que as pessoas confirmem o endereço antes de entrarem em uma lista de contatos e dê as boas-vindas a elas com um e-mail de confirmação. Defina o remetente, os textos ou um design MJML personalizado e teste os dois e-mails.

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](/pt/docs/domains/).
- 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](/pt/docs/audiences/manage-subscriptions/). Ela tem o design da sua [página de descadastro](/pt/docs/audiences/unsubscribe-page/#other-pages-with-this-design) 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

| Como a pessoa entra | Com o double opt-in ativado |
| --- | --- |
| A [URL de inscrição](/pt/docs/audiences/subscribe-url/) da lista | Recebe o e-mail de double opt-in e entra depois de clicar no link dele. A URL retorna `202`. |
| Um [formulário](/pt/docs/forms/) que adiciona pessoas à lista | Da mesma forma, a menos que o formulário tenha o próprio double opt-in. Nesse caso, a confirmação do formulário basta. Se o e-mail de double opt-in não puder ser enviado, o formulário adiciona a pessoa na hora. |
| **Add subscriber** no painel | **Ask them to confirm by email first (double opt-in)** vem marcado. Desmarque a opção para adicionar a pessoa na hora. |
| [Adicionar um inscrito](/pt/docs/api-reference/audiences/subscribers/add/) pela API | Só com `"double_opt_in": true`. Sem isso, a pessoa é adicionada na hora. |
| Importações, mesclagens e ações em massa de contatos | Adicionada na hora. |
| A [página de gerenciamento de inscrições](/pt/docs/audiences/manage-subscriptions/) | Adicionada na hora. O link foi enviado por e-mail à pessoa, o que já comprova o endereç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](/pt/docs/templates/temple/). Os valores do contato são escapados antes de entrar no e-mail.

| Variável | Valor |
| --- | --- |
| `{{confirm_url}}` | O link de confirmação. Só no e-mail de double opt-in. |
| `{{manage_subscriptions_url}}` | O link da pessoa para a [página de gerenciamento de inscrições](/pt/docs/audiences/manage-subscriptions/). Só no e-mail de confirmação. |
| `{{audience_name}}` | O nome público da lista ou, se ela não tiver um, o nome dela. |
| `{{email}}`, `{{first_name}}`, `{{last_name}}` | Os dados do contato. Use um valor padrão para valores vazios, como `{{first_name\|"there"}}`. |

**Text** e **Footer** mantêm as quebras de linha e aceitam HTML inline, como `<a>` e `**`. **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

> **O MJML está em alfa:** O editor visual de MJML está aberto apenas à equipe do Emailit enquanto o testamos. Todos os outros usam o design padrão, com todos os textos acima. Consulte [Editores e API de MJML](/pt/docs/templates/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](/pt/docs/api-reference/audiences/update/) define os dois e-mails. Envie apenas os campos que você quer alterar:

```bash
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:

```bash
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

  - [Página de gerenciamento de inscrições](/pt/docs/audiences/manage-subscriptions/): Permita que as pessoas escolham as próprias listas.
  - [URL de inscrição](/pt/docs/audiences/subscribe-url/): Receba inscrições do seu próprio site.

---
Fonte: https://emailit.com/pt/docs/audiences/double-opt-in/