Supressão de e-mails
O canal de e-mail da Messages API da Vonage inclui um recurso de supressão automática que vem ativado por padrão para todos os clientes. A supressão garante que os endereços de e-mail identificados como inválidos ou propensos a reclamações sejam adicionados à lista de supressão e nunca mais recebam mensagens. Qualquer entrega bloqueada é relatada como um evento de entrega rejeitado com o código de erro 2003, mantendo intacta sua reputação como remetente e fornecendo atualizações precisas sobre o status para cada destinatário.
Por que a supressão é importante
O envio de e-mails para endereços inválidos ou propensos a reclamações prejudica sua reputação como remetente junto aos ISPs e provedores de e-mail. Uma reputação prejudicada faz com que e-mails legítimos sejam marcados como spam ou bloqueados diretamente.
O recurso de supressão protege contra isso da seguinte forma:
- Impedir tentativas de entrega em endereços conhecidos como inválidos antes que elas cheguem aos provedores de internet.
- Registrar automaticamente novos endereços inválidos à medida que forem identificados por meio do feedback de entrega.
- Garantir que você continue recebendo informações precisas sobre o status da entrega para destinatários suprimidos, em vez de uma falha silenciosa.
Como funciona a supressão
A supressão funciona de duas maneiras: verificando as supressões existentes antes do envio e adicionando novos endereços à lista de supressão com base no feedback de entrega.
Verificação da supressão antes do envio
Sempre que uma solicitação de envio de e-mail é recebida, todos os destinatários (Para, CC e CCO) são verificados em relação à lista de exclusão antes que o e-mail seja enviado ao provedor. Isso ocorre automaticamente, sem a necessidade de configuração da Account.
Existem três resultados possíveis:
Cenário A — Nenhum destinatário é excluído
Todos os destinatários foram identificados. O e-mail é enviado normalmente e você recebe um ID de mensagem do provedor confirmando o envio.
Cenário B — Alguns destinatários são excluídos (exclusão parcial)
Um ou mais destinatários constam da lista de exclusão, mas pelo menos um não está nessa lista.
- Os destinatários suprimidos são removidos da remessa.
- O e-mail é enviado aos destinatários ativos restantes.
- É publicado um evento de supressão para cada destinatário bloqueado — rejeitado com código de erro 2003 — assim, você vê o status exato da entrega para cada destinatário, inclusive aqueles para quem não foi enviado.
- Você recebe o mesmo ID de mensagem do provedor, que abrange tanto os destinatários aos quais a mensagem foi enviada quanto aqueles para os quais o envio foi suprimido.
Cenário C — Todos os destinatários são excluídos
Todos os destinatários nos campos “Para”, “CC” e “CCO” constam na lista de exclusão.
- O e-mail não foi enviado.
- É publicado um evento de supressão para cada destinatário — rejeitado com código de erro 2003.
- Você recebe um ID de mensagem válido do provedor, que não pode ser diferenciado de uma mensagem real, para que seus sistemas possam rastrear a mensagem normalmente.
Adicionando endereços à lista de exclusão
O provedor de e-mail envia eventos de feedback de entrega (recusas e reclamações) de volta ao mecanismo de e-mail da Vonage. Esses eventos são processados para manter a lista de supressão atualizada.
O tipo de lista de supressão à qual um endereço é adicionado depende do evento recebido:
| Tipo de evento | Âmbito da supressão | Adicionado à lista de supressão |
|---|---|---|
| Rejeição definitiva | Global | Sim |
| Reclamação / Denúncia de SPAM | Por Account + identidade | Sim |
| Outras reclamações (detecção de vírus, correções de mensagens não consideradas spam, falhas no DKIM) | N/A | Não |
Referência aos tipos de supressão
A tabela a seguir mapeia os eventos de feedback de entrega do provedor aos códigos de erro da Messages API do Vonage e indica se o evento resulta em uma supressão.
| Tipo de rebote | Código de motivo da Vonage | Descrição | Status | Código de erro | Adicionado à lista de supressão |
|---|---|---|---|---|---|
| Rejeição definitiva | RECIPIENT_BLOCKED |
O endereço consta na lista de bloqueio da plataforma | Rejeitado | 2003 | Sim (global) |
| Rejeição definitiva | RECIPIENT_MISSING |
O endereço de e-mail não existe | Rejeitado | 1170 | Sim (global) |
| Rejeição definitiva | ACCOUNT_BLOCKED |
O endereço está na lista de bloqueios desta conta | Rejeitado | 2003 | Sim (global) |
| Reflexão suave | MAILBOX_FULL |
A caixa de correio do destinatário está temporariamente cheia | Rejeitado | 1180 | Não |
| Reflexão suave | CONTENT_TOO_LARGE |
A mensagem era grande demais para ser enviada | Rejeitado | 2002 | Não |
| Reflexão suave | ATTACHMENT_REJECTED |
O anexo foi rejeitado pelo servidor de destino | Rejeitado | 1382 | Não |
| Reflexão suave | GATEWAY_TIMEOUT |
O tempo limite da entrega expirou enquanto se aguardava o servidor de recebimento | Rejeitado | 1230 | Não |
| Reflexão suave | CONTENT_REJECTED |
O conteúdo foi rejeitado pelo servidor de destino | Rejeitado | 1282 | Não |
| Rejeição definitiva | UNKNOWN |
Rejeição não classificada | Rejeitado | 1330 | Sim (global) |
| Reclamação | USER_SPAM_REPORT |
O destinatário marcou o e-mail como spam | Não enviado | N/A | Sim (por Account + identidade) |
| Reclamação | OTHER_FEEDBACK |
Feedback sobre reclamações gerais | Rejeitado | — | Sim (por Account + identidade) |
| Reclamação | FRAUD_ALERT |
E-mail sinalizado como possível fraude | Rejeitado | 2001 | Não |
| Reclamação | AUTH_FAILURE |
Problema com DKIM / autenticação de e-mail | Rejeitado | 1484 | Não |
| Reclamação | NOT_SPAM_CORRECTION |
O destinatário corrigiu uma classificação incorreta de spam | N/A | N/A | Não |
| Reclamação | VIRUS_DETECTED |
E-mail sinalizado por conter um vírus | Rejeitado | 1282 | Não |
Observação: A Vonage sempre envia eventos rejeitados para o seu webhook com um código de erro 2003 para cada e-mail enviado que foi suprimido.
Status de entrega para destinatários excluídos
Quando um destinatário é suprimido, o mecanismo de e-mail publica um evento sintético de rejeição ou reclamação que reproduz o formato de um evento real do provedor. Isso significa que:
- Os sistemas a jusante (por exemplo, o conector de e-mail e os webhooks) recebem uma atualização de status corretamente formatada para cada destinatário, independentemente de as mensagens terem sido efetivamente enviadas ou não.
- É possível acompanhar o resultado completo de cada mensagem sem qualquer tratamento especial para os casos suprimidos.