# Testar e agendar uma campanha

> Envie e-mails de teste, pré-visualize uma campanha como um contato real, envie agora ou agende, cancele um agendamento e acompanhe o que acontece durante o envio.

Antes de uma campanha sair, confira-a na sua própria caixa de entrada e com dados reais de contatos. Depois, envie-a na hora ou escolha um horário. Esta página trata do teste, do agendamento, do cancelamento de um agendamento e do que acontece durante o envio da campanha, no painel e pela API.

## Enviar um teste

Os envios de teste vão para os seus próprios endereços, para você conferir o e-mail em caixas de entrada e clientes de e-mail reais.

1. **Abra a etapa de teste.** No assistente de campanha, acesse **Preview and test**.

2. **Digite os endereços.** Em **Send test**, digite até 5 endereços, separados por vírgulas, espaços ou ponto e vírgula, por exemplo `me@acme.com, colleague@acme.com`.

3. **Envie.** Selecione **Send test**. A confirmação diz “Test email is being sent.”

Os envios de teste são diferentes da campanha real:

- **As tags de mesclagem usam dados fictícios.** `{{email}}` vira o endereço de teste. Nome, sobrenome e campos personalizados ficam vazios. Para conferir valores reais, use [Preview as contact](#preview-as-a-contact).
- **O link de descadastro não descadastra ninguém.**
- **Carregamentos e cliques não são rastreados**, e os testes não contam no relatório da campanha.
- **Limites:** até 5 endereços por teste e 3 testes por minuto. A campanha precisa ter um **From email** antes.
- **Workspaces no modo sandbox** só podem enviar testes para os endereços das contas dos membros do workspace. Consulte [Acesso de produção](/pt/docs/workspaces/production-access/).

Os e-mails de teste aparecem em **Email API → Emails** como os outros e-mails enviados.

## Pré-visualizar como um contato

Na mesma etapa, **Preview as contact** renderiza a campanha com os dados de um contato. Pesquise um contato por nome ou e-mail, e a pré-visualização mostra o assunto e o conteúdo como essa pessoa vai vê-los, com “Previewing as” e o nome dela acima. Alterne entre **Desktop** e **Mobile** para conferir as duas larguras.

Use-a para identificar nomes vazios, chaves de campos personalizados erradas e tags que não foram substituídas. Consulte [Tags de mesclagem](/pt/docs/campaigns/merge-tags/).

## Enviar agora ou agendar

Na etapa **Send**, selecione **Send campaign** e escolha quando:

| Opção | O que acontece |
| --- | --- |
| **Immediately** | Selecione **Send now**. A campanha passa para **In process** e o envio começa na hora. |
| **Schedule** | Escolha uma data e um horário em **Schedule for** e selecione **Schedule**. A campanha passa para **Scheduled**. |

Ao agendar:

- **O horário está no fuso horário do seu computador.** O campo vem preenchido com a próxima hora cheia. O Emailit armazena o horário em UTC.
- **Ele deve estar no futuro.** Caso contrário, a caixa de diálogo mostra “Pick a time in the future.”
- **O envio começa em até um minuto depois do horário.** O Emailit procura campanhas a enviar a cada minuto.
- **Os destinatários são definidos quando o envio começa**, então quem entra ou sai das suas listas de contatos nesse meio-tempo é contado corretamente.
- **A campanha fica bloqueada.** Só os rascunhos podem ser editados. Para alterar uma campanha agendada, cancele o agendamento antes.

## Cancelar um agendamento

1. **Encontre a campanha.** Em **Email Marketing → Campaigns**, abra a aba **Scheduled**.

2. **Cancele.** No menu da linha, ou no topo da página da campanha, selecione **Cancel Schedule** e confirme.

A campanha volta para **Draft**, sem horário de envio, para que você possa editá-la e enviá-la ou agendá-la de novo. Não é possível cancelar nos últimos 5 minutos antes do horário agendado. Nesse caso, o painel mostra “Campaign cannot be canceled less than 5 minutes before scheduled time.”

## Durante o envio da campanha

Quando o envio começa, o Emailit seleciona os destinatários, ignora os endereços descadastrados e suprimidos e cria um e-mail por destinatário, em lotes. Enquanto isso, a página da campanha mostra:

- Um card **In process**: “This campaign is still sending. Counts update as messages move through delivery.”
- **Send progress**: a parcela dos e-mails criados que já saiu da fila, por exemplo “1,200 of 5,000 created messages have left the unprocessed queue.”
- As contagens em tempo real de **Sent**, **Delivered**, **Attempted**, **Not processed**, **Bounced**, **Suppressed** e **Complained**. Consulte [Relatórios de campanha](/pt/docs/campaigns/reports/#metrics).

Quando o e-mail de cada destinatário estiver criado, o status muda para **Sent**. A entrega continua depois disso: os e-mails para servidores temporariamente indisponíveis recebem novas tentativas por até cerca de 21 horas, e os carregamentos e cliques continuam chegando. O relatório é atualizado à medida que eles chegam.

Uma campanha que começou a ser enviada não pode ser interrompida pelo painel, então teste-a antes de enviar.

## Usar a API

Envie um rascunho na hora com [Enviar ou agendar uma campanha](/pt/docs/api-reference/campaigns/send/):

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

```json
{
  "object": "campaign",
  "id": "cmp_4Tq9Xv2kLm8Rw",
  "name": "October newsletter",
  "status": "sending",
  "message": "Campaign send initiated"
}
```

Para agendar, passe `scheduled_at` como data e hora ISO 8601 no futuro. Um timestamp Unix também funciona. Só os rascunhos podem ser agendados:

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scheduled_at": "2026-10-15T09:00:00Z" }'
```

```json
{
  "object": "campaign",
  "id": "cmp_4Tq9Xv2kLm8Rw",
  "name": "October newsletter",
  "status": "scheduled",
  "scheduled_at": "2026-10-15T09:00:00Z",
  "message": "Campaign is scheduled"
}
```

| Erro | Causa |
| --- | --- |
| `403` | O workspace ainda não tem acesso de produção. |
| `422` “Invalid scheduled_at” | `scheduled_at` não é uma data válida no futuro. |
| `422` “Campaign cannot be scheduled” | A campanha não é um rascunho. |

[Cancelar uma campanha](/pt/docs/api-reference/campaigns/cancel/) muda uma campanha `draft` ou `sending` para `canceled`. Os e-mails que já foram criados para os destinatários são enviados mesmo assim. Para voltar uma campanha agendada para rascunho, use **Cancel Schedule** no painel.

Acompanhe o andamento com os [eventos de webhook](/pt/docs/webhooks/event-types/) `campaign.scheduled`, `campaign.queued`, `campaign.sending`, `campaign.sent` e `campaign.canceled`.

## Veja também

  - [Relatórios de campanha](/pt/docs/campaigns/reports/): O que cada métrica significa.
  - [Criar uma campanha](/pt/docs/campaigns/create/): O assistente completo.

---
Fonte: https://emailit.com/pt/docs/campaigns/test-and-schedule/