Pular para o conteúdo principal
Conceitos

Ciclo de vida do email

Os status por que um email passa, do POST até a entrega, e os eventos que você recebe em cada um.

Do envio à entrega

O POST /emails só coloca o email na fila e responde 202 com o id. O worker tira da fila, entrega ao relay SMTP e registra cada passo como evento. Consulte os eventos em GET /emails/{id}/events ou receba-os por webhook.

  • queued: aceito e na fila.
  • scheduled: agendado para scheduledAt.
  • processing: o worker está enviando.
  • sent: o relay aceitou a mensagem.
  • delivered: o servidor do destinatário confirmou o recebimento.
GET /emails/{id}/events
{  "id": "8f3a2c1b-4d5e-4f60-9a7b-1c2d3e4f5a6b",  "events": [    { "type": "queued", "timestamp": "2026-11-10T17:02:11.204Z" },    { "type": "sent", "timestamp": "2026-11-10T17:02:11.616Z" },    { "type": "delivered", "timestamp": "2026-11-10T17:02:12.398Z" },    { "type": "opened", "timestamp": "2026-11-10T17:05:40.000Z" }  ]}

Desfechos negativos

Nem todo email chega. Quando não chega, o status final diz por quê e o endereço pode entrar na lista de supressão automaticamente.

  • bounced: o servidor recusou (bounce permanente suprime o endereço).
  • complained: o destinatário marcou como spam (o endereço é suprimido).
  • failed: o envio falhou depois das novas tentativas.
  • skipped: o endereço estava suprimido e o email não saiu.
  • cancelled: o agendamento foi cancelado antes do envio.

Engajamento

Com rastreio ligado no domínio, aberturas e cliques viram eventos opened e clicked. Eles não mudam o status de entrega.