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
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.