# Campanhas

> As campanhas enviam um e-mail aos inscritos das suas listas de contatos. Conheça os requisitos, os status, o custo em créditos e o que a lista de campanhas e a API permitem fazer.

Uma campanha envia um e-mail, como uma newsletter ou o comunicado de um produto, para todos os inscritos nas listas de contatos que você escolher. Você a monta em um assistente de cinco etapas no painel, testa, envia na hora ou agenda o envio e acompanha os resultados no relatório dela.

## Antes de enviar

| Requisito | Por quê |
| --- | --- |
| **Acesso de produção** | Os workspaces novos começam no modo sandbox, em que as campanhas não podem ser enviadas. Solicite o acesso em **Workspace → Settings → Requests**. Consulte [Acesso de produção](/pt/docs/workspaces/production-access/). |
| **Um domínio de envio verificado** | O **From email** deve usar um domínio que você verificou neste workspace. Consulte [Adicionar um domínio](/pt/docs/domains/add-a-domain/). |
| **Uma lista de contatos com inscritos** | As campanhas são enviadas para [listas de contatos](/pt/docs/audiences/). Adicione pessoas manualmente, [importe-as](/pt/docs/contacts/import-export/) ou colete-as com uma [URL de inscrição](/pt/docs/audiences/subscribe-url/). |
| **Um link de descadastro** | Coloque `{{unsubscribe_url}}` no seu conteúdo. Consulte [Descadastros](/pt/docs/audiences/unsubscribes/). |
| **Créditos suficientes** | Cada e-mail de campanha custa 2 créditos. |

Para que os carregamentos e os cliques apareçam no relatório, o domínio de envio também precisa de um subdomínio de rastreamento verificado. Com ele configurado, os e-mails de campanha são rastreados automaticamente. Consulte [Rastreamento de aberturas e cliques](/pt/docs/tracking/).

## Como funciona

1. **Crie a campanha.** Em **Email Marketing → Campaigns**, selecione **Add campaign** e dê um nome a ela. Os destinatários nunca veem o nome.
2. **Siga o assistente:** **Recipients**, **Sender and Subject**, **Content**, **Preview and test** e **Send**. Consulte [Criar uma campanha](/pt/docs/campaigns/create/).
3. **Envie ou agende.** O Emailit define os destinatários quando o envio começa e cria um e-mail por destinatário. Consulte [Testar e agendar](/pt/docs/campaigns/test-and-schedule/).
4. **Leia o relatório.** Entregas, carregamentos, cliques e descadastros aparecem na página da campanha à medida que acontecem. Consulte [Relatórios de campanha](/pt/docs/campaigns/reports/).

## Créditos

Uma campanha cria um e-mail por destinatário, e cada um custa 2 créditos. Uma campanha para 10.000 inscritos usa 20.000 créditos. Os créditos saem primeiro dos créditos mensais incluídos no seu plano e depois dos créditos comprados. Consulte [Como funcionam os créditos](/pt/docs/billing/credits/) e os [preços](/pricing/).

## Status da campanha

| Status | Valor na API | Significado |
| --- | --- | --- |
| **Draft** | `draft` | Em edição. Só os rascunhos podem ser enviados, agendados ou excluídos. |
| **Scheduled** | `scheduled` | Aguardando o horário de envio. Você pode cancelar o agendamento até 5 minutos antes. |
| **In process** | `queued`, `sending` | O envio começou e o Emailit está criando os e-mails dos destinatários. |
| **Sent** | `sent` | Todos os e-mails dos destinatários foram criados e passados para a entrega. Entregas, carregamentos e cliques continuam sendo atualizados depois. |
| **Canceled** | `canceled` | A campanha foi cancelada pela API antes de terminar o envio. |
| **Archived** | `archived` | Uma campanha enviada que você tirou do caminho. O relatório dela continua disponível. |

As mudanças de status geram eventos `campaign.*`, como `campaign.scheduled`, `campaign.sending` e `campaign.sent`, que você pode receber com [webhooks](/pt/docs/webhooks/event-types/).

## A lista de campanhas

**Email Marketing → Campaigns** lista as suas campanhas com as abas **All**, **Draft**, **Scheduled**, **In process**, **Sent** e **Archived**. As campanhas canceladas aparecem em **All**. As colunas mostram o nome (**Name**), o **Status**, os horários de **Last updated**, **Created** e **Sent** e as estatísticas (**Stats**) com as contagens de enviados, clicados e descadastrados. A pesquisa busca no nome e no assunto.

Selecionar um rascunho abre o assistente. Selecionar qualquer outra campanha abre o relatório dela.

O menu da linha oferece estas ações:

| Ação | Disponível para | O que faz |
| --- | --- | --- |
| **Rename** | Todas as campanhas | Altera o nome interno. |
| **Duplicate** | Todas as campanhas | Cria um novo rascunho com o mesmo remetente, assunto e conteúdo. O nome padrão é o nome original mais “ (Copy)”. Os destinatários não são copiados, então escolha as listas de contatos de novo. |
| **Save as template** | Campanhas com conteúdo | Salva o conteúdo, o assunto e o remetente como um novo [template](/pt/docs/templates/). |
| **Cancel Schedule** | Agendadas | Volta a campanha para **Draft**. Não é possível nos últimos 5 minutos antes do horário de envio. |
| **Archive** | Enviadas | Move a campanha para a aba **Archived**. |
| **Unarchive** | Arquivadas | Volta a campanha para **Draft**. |
| **Delete** | Rascunhos | Exclui a campanha. Essa ação não pode ser desfeita. |

## Usar a API

A [API de campanhas](/pt/docs/api-reference/campaigns/) cobre o mesmo ciclo de vida. Ela exige uma chave de API **Full Access**.

| Endpoint | Use para |
| --- | --- |
| [Criar uma campanha](/pt/docs/api-reference/campaigns/create/) | Criar um rascunho com `name`, `subject`, `from_email`, `from_name`, `reply_to`, `html` e `text`. |
| [Atualizar uma campanha](/pt/docs/api-reference/campaigns/update/) | Alterar o conteúdo ou definir `recipients`, uma lista de objetos `{ "audience_id": "aud_…" }`. |
| [Enviar ou agendar uma campanha](/pt/docs/api-reference/campaigns/send/) | Enviar agora, ou passar um `scheduled_at` no futuro para agendar um rascunho. |
| [Cancelar uma campanha](/pt/docs/api-reference/campaigns/cancel/) | Cancelar um rascunho ou uma campanha que ainda está sendo enviada. |
| [Listar](/pt/docs/api-reference/campaigns/list/), [obter](/pt/docs/api-reference/campaigns/get/) e [excluir](/pt/docs/api-reference/campaigns/delete/) | Consultar e limpar campanhas. Filtre a lista por `status`. |

Você pode usar o nome de uma campanha em vez do ID `cmp_` dela na URL. Enviar a partir de um workspace sem acesso de produção retorna `403`. As estatísticas das campanhas estão disponíveis apenas no painel.

## Próximos passos

  - [Criar uma campanha](/pt/docs/campaigns/create/): Siga o assistente de cinco etapas.
  - [Tags de mesclagem](/pt/docs/campaigns/merge-tags/): Personalize os assuntos e o conteúdo.
  - [Testar e agendar](/pt/docs/campaigns/test-and-schedule/): Envie testes e depois envie agora ou mais tarde.
  - [Relatórios de campanha](/pt/docs/campaigns/reports/): Todas as métricas, abas e exportações.

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