Este informativo orienta como tratar erros de Permanent Failure (500) em envios via AWS SES. Quando um e-mail para a houseTI falha (conta inexistente ou migração, por exemplo), a AWS o classifica como Hard Bounce e o adiciona à Suppression List, impedindo novos envios.

Importante: A Suppression List é específica por Conta AWS e por Região. O desbloqueio deve ocorrer exatamente onde o envio foi originado.

Passo 1: Validar Identidade e Região

Antes de qualquer ação, garanta que você está operando na conta e região corretas.

• Verificar usuário e conta ativa:

  Bash

  aws sts get-caller-identity
  

• Verificar região configurada:

  Bash

  aws configure get region
  

Passo 2: Diagnóstico (Consultar Destinatário)

Confirme se o e-mail do destinatário está realmente na lista e qual o motivo (BOUNCE ou COMPLAINT).

• Comando de consulta:

  Bash

  aws sesv2 get-suppressed-destination --email-address usuario@dominio.com.br
  

• Nota: Se receber um erro NotFoundException, verifique se a região ou a conta AWS estão corretas.

Passo 3: Remoção da Suppression List

Se o e-mail foi localizado no passo anterior, proceda com a exclusão para liberar novos envios.

• Comando de remoção:

  Bash

  aws sesv2 delete-suppressed-destination --email-address usuario@dominio.com.br
  

• Para forçar uma região específica (Ex: us-east-1):

  Bash

  aws sesv2 delete-suppressed-destination --region us-east-1 --email-address usuario@dominio.com.br
  

  (O sucesso deste comando não gera retorno de texto no console).

Passo 4: Validação do Destinatário

Não reenvie o e-mail imediatamente. Certifique-se de que o ambiente de destino na houseTI está pronto para receber mensagens.

• Validar registros MX do domínio:

  Bash

  nslookup -type=mx dominio.com.br
  # OU
  dig mx dominio.com.br
  

Boas Práticas e Observações Técnicas

1. Tipos de Supressão

• Account-level: Gerenciada por você (procedimento acima).

• Global Suppression List: Gerenciada pela AWS. Se o e-mail estiver nesta lista, a remoção manual não é possível.

2. Como evitar novos bloqueios

• Validação Prévia: Nunca dispare e-mails para contas que ainda não foram criadas no ambiente houseTI.

• Tratamento de Erros:

  • Erro 4xx (Temporário): Permitir novas tentativas (retry).

  • Erro 5xx (Permanente): Interromper o envio imediatamente para evitar impacto no Bounce Rate.

• Monitoramento: Acompanhe constantemente o Bounce Rate e Complaint Rate no console do SES para evitar que a conta entre em revisão pela AWS.

Dica de Suporte: Se o comando de remoção retornar NotFoundException, os motivos mais comuns são:

1. Você está autenticado na Conta AWS errada (Ex: Homologação em vez de Produção).

2. A região do CLI não coincide com a região onde o envio falhou.

3. O e-mail já foi removido anteriormente.