# Criar uma campanha

> Siga o assistente de campanha de cinco etapas, da escolha das listas de contatos e do remetente ao conteúdo, ao teste e ao envio, e veja exatamente quem a recebe.

Este guia percorre o assistente de campanha etapa por etapa: escolher os destinatários, definir o remetente e o assunto, escrever o conteúdo, testar e enviar. Ele também explica quem acaba recebendo a campanha e como fazer o mesmo pela API.

## Antes de começar

- O seu workspace precisa de acesso de produção. Até lá, as campanhas não podem ser enviadas. Consulte [Acesso de produção](/pt/docs/workspaces/production-access/).
- Verifique o domínio de onde você vai enviar. Consulte [Adicionar um domínio](/pt/docs/domains/add-a-domain/).
- Crie pelo menos uma [lista de contatos](/pt/docs/audiences/) com inscritos.
- Opcional: prepare um [template](/pt/docs/templates/) para começar o conteúdo a partir dele.

## Criar a campanha

Em **Email Marketing → Campaigns**, selecione **Add campaign**, digite um nome em **Name** e selecione **Create**. O nome é só para você. O assistente abre na primeira etapa.

As etapas ficam listadas à esquerda. Uma marca de seleção mostra quais estão concluídas, e você pode voltar a qualquer etapa. **Continue** salva a etapa atual e passa para a próxima. Enquanto a campanha for um rascunho, você pode sair e voltar a ela pela lista de campanhas.

## Etapa 1: Recipients

Escolha para quem a campanha vai.

- **Audiences:** escolha uma ou mais listas de contatos. Cada opção mostra quantos inscritos ela tem. É obrigatório escolher pelo menos uma.
- **Exclude audiences:** opcionalmente, escolha listas de contatos cujos inscritos devem ficar de fora.
- **Estimated recipients:** é atualizado conforme você muda a seleção. Ele conta os contatos únicos inscritos em pelo menos uma lista selecionada, menos os inscritos em uma lista excluída.

Selecione **Continue** para salvar os destinatários.

### Quem realmente recebe a campanha

O Emailit define a lista final quando o envio começa, e não quando você escolhe as listas. Um contato recebe a campanha quando:

1. Está inscrito em pelo menos uma das listas selecionadas.
2. O status de marketing dele é **Subscribed**. Os contatos descadastrados com a ação em massa **Unsubscribe** ou com `unsubscribed: true` são ignorados.
3. O endereço dele não está na [lista de supressão](/pt/docs/suppressions/), com nenhum tipo de supressão que ainda não tenha expirado.

Cada endereço recebe uma cópia, mesmo que esteja em várias listas selecionadas. Quem entra em uma lista depois que você agenda a campanha é incluído, e quem se descadastra antes de o envio começar fica de fora.

A estimativa não desconta os contatos descadastrados globalmente nem os endereços suprimidos, então o número de e-mails enviados pode ser menor que a estimativa.

> **As listas excluídas não são aplicadas no envio:** As listas excluídas reduzem a estimativa, mas a versão atual não as aplica quando a campanha é enviada. Um contato que está em uma lista selecionada e em uma lista excluída ainda recebe a campanha. Até isso mudar, não conte com **Exclude audiences** para deixar pessoas de fora: remova-as das listas selecionadas, descadastre-as ou envie para uma lista que não as inclua.

## Etapa 2: Sender and Subject

| Campo | Obrigatório | Observações |
| --- | --- | --- |
| **From name** | Sim | O nome que os destinatários veem, por exemplo `Acme`. |
| **From email** | Sim | Um endereço em um domínio verificado neste workspace, por exemplo `news@acme.com`. |
| **Subject** | Sim | Pode incluir [tags de mesclagem](/pt/docs/campaigns/merge-tags/), por exemplo `October news for {{first_name}}`. |
| **Reply to** | Não | Para onde vão as respostas. Deixe vazio para usar o **From email**. |

Selecione **Continue** para salvar.

## Etapa 3: Content

Escolha como você quer escrever o e-mail:

| Opção | Indicada para |
| --- | --- |
| **Dragit editor** | Criar um layout com blocos de arrastar e soltar. Salva automaticamente enquanto você trabalha. |
| **Rich-text editor** | E-mails simples, centrados no texto. Digite `@` para inserir uma tag de mesclagem. |
| **HTML editor** | Colar ou escrever o seu próprio HTML. |
| **Choose from templates** | Começar a partir de um dos seus [templates](/pt/docs/templates/). O Emailit copia o conteúdo do template para a campanha, então edições posteriores não alteram o template. O assunto do template não é copiado. |

Consulte [Editores](/pt/docs/templates/editors/) para saber como cada editor funciona.

Quando a campanha tem conteúdo, a etapa mostra uma pré-visualização com estes botões:

- **Open editor** reabre o editor que você usou.
- **Remove content** apaga o conteúdo para você escolher outro editor. Trocar de editor sempre começa com o conteúdo vazio.
- **Save as template** salva o conteúdo, o assunto e o remetente como um novo template, que você pode reutilizar em outras campanhas ou enviar pela API. Digite um nome em **Name** e um alias em **Alias** e selecione **Save** ou **Save & Open**.

Adicione `{{unsubscribe_url}}` como link no seu conteúdo. No Dragit, ele aparece entre os links especiais e, no editor de texto formatado, é a variável **Unsubscribe URL**. Consulte [Descadastros](/pt/docs/audiences/unsubscribes/#the-link-in-your-content).

Selecione **Continue** quando o conteúdo estiver pronto.

## Etapa 4: Preview and test

- **Desktop** e **Mobile** mostram o e-mail em cada largura.
- **Preview as contact** preenche as tags de mesclagem com o nome, o e-mail e os campos personalizados de um contato real. Pesquise um contato por nome ou e-mail.
- **Send test** envia o e-mail para até 5 endereços.

Consulte [Testar e agendar](/pt/docs/campaigns/test-and-schedule/) para ver os detalhes e os limites. Selecione **Continue** quando estiver satisfeito.

## Etapa 5: Send

A última etapa resume **From**, **Reply to**, **Subject**, **Recipients** e **Content**, com um link **Edit** de volta para cada etapa, e executa estas verificações:

| Verificação | Resultado |
| --- | --- |
| **From**, **Subject**, **Content** | Precisam passar. **Send campaign** fica desativado até os três estarem definidos. |
| Link de descadastro | “No problems detected!” quando o HTML contém `{{unsubscribe_url}}`. Caso contrário, “Missing unsubscribe link!”. Isso não bloqueia o envio, mas corrija antes de enviar. |
| Tamanho | “Your content will be clipped as it is bigger than 100kb.” aparece quando o HTML tem mais de cerca de 102 KB. O Gmail corta mensagens mais longas e esconde o resto, incluindo o rodapé e o link de descadastro, atrás de um link. Encurte o conteúdo ou tire imagens e estilos do HTML. |

Selecione **Send campaign** e escolha:

- **Immediately** e depois **Send now**, para começar a enviar na hora.
- **Schedule**, escolha uma data e um horário em **Schedule for**, no fuso horário do seu computador, e selecione **Schedule**. O horário deve estar no futuro.

A página da campanha abre e mostra a campanha como **In process** ou **Scheduled**. Consulte [Testar e agendar](/pt/docs/campaigns/test-and-schedule/) para saber o que acontece em seguida.

## Confirmar que funcionou

- A lista de campanhas mostra a campanha em **In process** ou **Scheduled** e depois em **Sent**.
- A página da campanha mostra uma barra **Send progress** enquanto os e-mails são criados e, depois, as contagens de entrega e engajamento. Consulte [Relatórios de campanha](/pt/docs/campaigns/reports/).
- O e-mail de cada destinatário aparece em **Email API → Emails** com o seu próprio status.

## Criar uma campanha pela API

As mesmas etapas com a [API de campanhas](/pt/docs/api-reference/campaigns/), usando uma chave de API **Full Access**:

1. **Crie o rascunho** com o remetente, o assunto e o HTML.

```bash
curl https://api.emailit.com/v2/campaigns \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "October newsletter",
    "from_name": "Acme",
    "from_email": "news@acme.com",
    "reply_to": "support@acme.com",
    "subject": "October news for {{first_name}}",
    "html": "<p>Hi {{first_name}},</p><p>Here is what is new.</p><p><a href=\"{{unsubscribe_url}}\">Unsubscribe</a></p>",
    "text": "Hi {{first_name}}, here is what is new. Unsubscribe: {{unsubscribe_url}}"
  }'
```

   A resposta contém o `id` da campanha, por exemplo `cmp_4Tq9Xv2kLm8Rw`, com `status` `draft`.

2. **Defina os destinatários** com [Atualizar uma campanha](/pt/docs/api-reference/campaigns/update/). `recipients` substitui a lista atual e precisa de pelo menos uma lista de contatos.

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "recipients": [{ "audience_id": "aud_5hJ2kL8mNp4Qr" }] }'
```

3. **Envie-a** com [Enviar ou agendar uma campanha](/pt/docs/api-reference/campaigns/send/), ou agende-a com `scheduled_at`. Consulte [Testar e agendar](/pt/docs/campaigns/test-and-schedule/#use-the-api).

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

## Veja também

  - [Tags de mesclagem](/pt/docs/campaigns/merge-tags/): Personalize o assunto e o conteúdo.
  - [Testar e agendar](/pt/docs/campaigns/test-and-schedule/): Envios de teste, agendamento e cancelamento.

---
Fonte: https://emailit.com/pt/docs/campaigns/create/