Referência
Status de e-mail
Todos os status de e-mail do Emailit, o que significam, se ainda podem mudar, qual evento de webhook enviam e o que fazer em seguida.
Cada e-mail tem um status que mostra em que ponto do ciclo de vida ele está. Esta página lista os 14 status, como um e-mail passa de um para outro e o que fazer quando um e-mail para onde você não esperava. O status é apenas o estado mais recente; o histórico completo fica na página de detalhes do e-mail e nos eventos.
Referência de status
“Final” significa que o Emailit não vai mais mudar o status por conta própria. Ainda é possível tentar enviar de novo um e-mail com status final, o que cria um novo e-mail com um novo ID.
| Status | Dica no painel | Final | Evento de webhook | Significado e o que fazer |
|---|---|---|---|---|
accepted |
Accepted for delivery | Não | email.accepted |
Armazenado e na fila para entrega. Normalmente avança em segundos. Os e-mails enviados por SMTP não emitem email.accepted. |
scheduled |
Scheduled for delivery in the future | Não | email.scheduled |
Aguardando o horário de scheduled_at. Você pode alterar o horário ou cancelá-lo até 3 minutos antes do envio. |
delivered |
Delivered to the recipient’s mail server | Não | email.delivered |
O servidor de destino aceitou a mensagem. Ela ainda pode passar a loaded ou clicked, e um relatório de bounce ou uma reclamação posteriores podem mudá-la para bounced ou complained. |
loaded |
Email content was loaded by the recipient | Não | email.loaded |
A imagem de rastreamento foi carregada (uma abertura). Requer o rastreamento de carregamentos em um domínio de rastreamento verificado. |
clicked |
A link in the email was clicked | Não | email.clicked |
Um link rastreado foi clicado. Requer o rastreamento de cliques em um domínio de rastreamento verificado. |
attempted |
Delivery attempted but resulted in a temporary failure | Não | email.attempted |
O servidor de destino respondeu com um erro temporário. O Emailit tenta de novo automaticamente; consulte o cronograma de novas tentativas. |
bounced |
Email permanently failed to deliver | Sim | email.bounced |
O servidor de destino rejeitou a mensagem de forma permanente, um relatório de bounce chegou depois ou as novas tentativas se esgotaram. Confira o endereço antes de enviar para ele de novo. Consulte Bounces e reclamações para saber quando o endereço é suprimido automaticamente. |
failed |
Failed to deliver due to a specific error | Sim | email.failed |
Um erro de processamento, e não uma resposta do servidor do destinatário. Raro. Tente enviar de novo pela API. |
rejected |
Accepted for delivery but rejected after | Sim | email.rejected |
O Emailit se recusou a enviá-lo depois de aceitá-lo, porque um workspace não verificado só pode enviar para membros. |
suppressed |
Recipient is on the suppression list | Sim | email.suppressed |
Não enviado porque o endereço está na sua lista de supressão. Remova a supressão só se tiver certeza e tente de novo. |
received |
Incoming email was accepted | Sim | email.received |
Uma mensagem foi recebida no seu subdomínio de recebimento. |
complained |
A complaint was registered for this email | Sim | email.complained |
O destinatário marcou o e-mail como spam e o provedor dele informou isso. O endereço é adicionado às supressões, a menos que as suas configurações de supressão automática excluam as reclamações. Não envie e-mails para ele de novo. |
canceled |
Canceled: pulled from the send queue when possible | Sim | email.canceled |
Você o cancelou no painel ou pela API. O cancelamento é feito em regime de melhor esforço. |
held |
Email is being held | Sim | email.held |
O Emailit não o enviou. Veja por que um e-mail é retido, corrija a causa e tente de novo. |
Os webhooks recebem email.canceled e email.held quando estão inscritos em todos os eventos, ou quando você os adiciona à lista de eventos do webhook pela API. Consulte Tipos de eventos.
Ciclo de vida
A maioria dos e-mails segue este caminho:
- Criado. Um envio pela API cria o e-mail como
accepted, ou comoscheduledquandoscheduled_atestá no futuro. Os envios por SMTP também começam comoaccepted. Os e-mails recebidos são criados comoreceivede nunca mudam. - Verificado. Antes de cada tentativa de entrega, o Emailit verifica o workspace, o domínio, a chave de API, os créditos, a lista de supressão e a pontuação de spam. Uma verificação com falha encerra o e-mail como
held,rejectedousuppressed, sem enviá-lo. - Entregue ou adiado. A tentativa de entrega é bem-sucedida (
delivered), falha temporariamente (attempted, e depois recebe novas tentativas) ou falha permanentemente (bounced). - Engajamento. Se o rastreamento estiver ativado, aberturas e cliques levam um e-mail entregue a
loadede depois aclicked. - Relatórios tardios. Um relatório de bounce que chega depois da entrega muda o status para
bounced. Uma reclamação de spam o muda paracomplained.
Em qualquer momento antes da entrega, um e-mail scheduled, accepted ou attempted pode passar a canceled.
A escada de engajamento
Os status de entrega e de engajamento só avançam:
accepted, scheduled ou attempted → delivered → loaded → clicked
Um evento posterior nunca faz um e-mail descer na escada. Se um clique for registrado, o e-mail continua clicked mesmo que cheguem mais aberturas. Uma abertura ou um clique pode pular à frente de delivered, porque prova que a mensagem chegou. Os status que encerram a entrega (bounced, failed, rejected, suppressed, complained e canceled) nunca são substituídos por aberturas ou cliques.
Cronograma de novas tentativas para attempted
Quando um servidor de destino responde com um erro temporário (uma resposta 4xx, como 421 ou 451, um timeout ou um erro de conexão), o e-mail passa a attempted e o Emailit tenta de novo. Cada espera é o dobro da anterior:
| Depois da tentativa com falha | Próximo passo |
|---|---|
| 1 | Tentar de novo depois de 10 minutos |
| 2 | Tentar de novo depois de 20 minutos |
| 3 | Tentar de novo depois de 40 minutos |
| 4 | Tentar de novo depois de 80 minutos |
| 5 | Tentar de novo depois de 160 minutos |
| 6 | Tentar de novo depois de 320 minutos |
| 7 | Esperar 640 minutos e depois marcar o e-mail como bounced |
São 7 tentativas de entrega ao longo de cerca de 21 horas. Quando elas se esgotam, o e-mail é marcado como bounced com “Maximum number of delivery attempts (7) has been reached”, e o destinatário é adicionado às supressões com o motivo too many soft fails, a menos que as suas configurações de supressão automática excluam os bounces.
Cada tentativa aparece na aba Deliveries do e-mail com a resposta do servidor, e cada uma envia um evento email.attempted que inclui smtp_code, smtp_enhanced_code e smtp_response. Algumas respostas temporárias que indicam claramente um problema permanente, como uma caixa de e-mail desativada, são tratadas como bounce imediatamente. Quando um provedor está limitando o ritmo, o Emailit também pode pausar brevemente as entregas para ele; essas linhas dizem “Delivery delayed due to…”.
Por que um e-mail é retido
Um e-mail retido foi tirado da fila de envio sem ser enviado. A aba Deliveries do e-mail mostra qual foi o motivo:
| Motivo | Mensagem na aba Deliveries | O que fazer |
|---|---|---|
| Workspace suspenso | Mail server has been suspended. No e-mails can be processed at present. Contact support for assistance. | Confira a saúde de envio e fale com o suporte. |
| Domínio de envio pausado | Sending from this domain is paused. Contact support for assistance. | A taxa de bounce do domínio estava alta demais. Consulte Saúde de envio. |
| Créditos insuficientes | Workspace has not enough email credits to send this email. | Compre créditos ou ative a recarga automática. |
| Pontuação de spam alta demais | Held because Rspamd scored this message 8.4, which is at or above the threshold of 7. | Leia a verificação de spam do e-mail, corrija o conteúdo e tente de novo. |
| Chave de API configurada para reter | Credential is configured to hold all messages authenticated by it. | As mensagens enviadas com essa chave são retidas de propósito. Fale com o suporte. |
Os e-mails retidos não são liberados automaticamente. Depois de corrigir a causa, selecione Retry no e-mail ou chame Tentar enviar um e-mail de novo. A nova tentativa cria um novo e-mail com o mesmo conteúdo e cobra os créditos de novo.
Por que um e-mail é rejeitado
Enquanto o seu workspace não tiver acesso de produção, você só pode enviar para os e-mails das contas dos membros do workspace. A API retorna 403 e o SMTP retorna 550 para os outros destinatários no momento do envio, então na maioria das vezes você vê o erro em vez de um e-mail. O status rejected aparece quando a mesma verificação falha mais tarde, no momento da entrega, por exemplo em um e-mail agendado antes. A aba Deliveries mostra “Unverified workspaces can only send to workspace members’ account emails” e o endereço bloqueado.
Regras para novas tentativas
| Botão Retry no painel | API Tentar enviar um e-mail de novo | |
|---|---|---|
| Status | held, suppressed |
bounced, failed, suppressed, held |
| Idade | Menos de 30 dias | Menos de 30 dias |
| Conteúdo | Não pode ter sido apagado pela retenção de dados | Não pode ter sido apagado |
| Resultado | Um novo e-mail com um novo ID; o original não é alterado | Igual; a resposta inclui original_id |
Para um e-mail suprimido, primeiro remova o endereço da sua lista de supressão, senão a nova tentativa é suprimida de novo.