Guia prático
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.
-
Abra a etapa de teste. No assistente de campanha, acesse Preview and test.
-
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. -
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. - 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.
Os e-mails de teste aparecem em Email APIEmails 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.
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
-
Encontre a campanha. Em Email MarketingCampaigns, abra a aba Scheduled.
-
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.
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:
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY"{
"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:
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" }'{
"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 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 campaign.scheduled, campaign.queued, campaign.sending, campaign.sent e campaign.canceled.