Erros de envio de e-mail do Amazon SES

Este tópico analisa os tipos de erros específicos de envio de e-mail que você pode encontrar ao enviar um e-mail pelo Amazon SES. Se você tentar enviar um e-mail por meio do Amazon SES e ocorrer uma falha na chamada para o Amazon SES, o Amazon SES retornará uma mensagem de erro à sua aplicação e não enviará o e-mail. A maneira como você observa essa mensagem de erro depende da maneira como chama o Amazon SES.

• Se você chamar a API do Amazon SES diretamente, a ação Query (Consultar) retornará um erro. O erro pode ser MessageRejected ou um dos erros especificados no tópico Erros comuns da Referência da API do Amazon Simple Email Service.

• Se você chamar o Amazon SES usando um AWS SDK que utiliza uma linguagem de programação que oferece suporte a exceções, o Amazon SES pode gerar uma exceção. O tipo de exceção depende do SDK e do erro. Por exemplo, a exceção pode ser uma MessageRejectedException do Amazon SES (o nome real pode variar de acordo com o SDK) ou uma exceção geral da AWS. Independentemente do tipo de exceção, o tipo e a mensagem de erro na exceção fornecerão mais informações.

• Se você chamar o Amazon SES por meio de sua interface SMTP, a forma como você experimentará o erro vai depender da aplicação. Alguns aplicativos podem exibir uma mensagem de erro específica, enquanto outros não. Para obter uma lista de códigos de resposta SMTP retornados pelo Amazon SES, consulte Códigos de resposta SMTP retornados pelo Amazon SES.

nota

Quando ocorre falha na sua chamada para o Amazon SES para enviar um e-mail, você é será cobrado por esse e-mail.

Veja a seguir os tipos de problemas específicos do Amazon SES que podem fazer com que o Amazon SES retorne um erro ao tentar enviar um e-mail. Esses erros são uma adição aos erros gerais da AWS, como MalformedQueryString, conforme especificado no tópico Erros comuns da Referência da API do Amazon Simple Email Service.

• Email address is not verified (O endereço de e-mail não está verificado). The following identities failed the check in region (As seguintes identidades não foram aprovadas na verificação na região) região: identidade1, identidade2, identidade3: você está tentando enviar e-mail de um endereço de e-mail ou domínio que não verificou com o Amazon SES. Esse erro pode se aplicar aos endereços "From", "Source", "Sender" ou "Return-Path". Se sua conta ainda estiver na sandbox do Amazon SES, você também deverá verificar o endereço de e-mail de cada destinatário com exceção dos destinatários fornecidos pelo simulador de caixa postal do Amazon SES. Se o Amazon SES não conseguir mostrar todas as identidades com falha, a mensagem de erro terminará com reticências.

  nota

  O Amazon SES tem endpoints em várias regiões da Regiões da AWS, e o status de verificação do endereço de e-mail é separado para cada região da Região da AWS. Você deve concluir o processo de verificação para cada remetente nas Regiões da AWS que deseja usar.

• Account is paused (A conta está pausada): a capacidade da sua conta enviar e-mails está pausada. Você ainda pode acessar o console do Amazon SES e realizar a maioria das operações. No entanto, se você tentar enviar um e-mail, receberá essa mensagem.

  Se pausarmos a capacidade da sua conta enviar e-mails, enviaremos automaticamente uma notificação ao endereço de e-mail correspondente à sua conta da Conta da AWS. Para obter mais informações, consulte Perguntas frequentes sobre o processo do Amazon SES de revisão de envios.

• Throttling (Controle de utilização): sua aplicação pode estar tentando enviar muitas mensagens por segundo, ou você pode ter enviado muitos e-mails nas últimas 24 horas. Nesses casos, a mensagem de erro pode ser semelhante a um dos seguintes exemplos:

  • Daily message quota exceeded (Cota de mensagens diária excedida): você enviou o número máximo de mensagens que é permitido em um período de 24 horas. Se você excedeu sua cota diária, terá que esperar até o próximo período de 24 horas para poder enviar mais e-mails.

  • Maximum sending rate exceeded (Taxa máxima de envio excedida): você está tentando enviar mais e-mails por segundo do que é permitido pela taxa máxima de envio. Se você excedeu a sua taxa de envio, poderá continuar a enviar e-mails, mas precisará reduzir sua taxa de envio. Para obter mais informações, consulte Como lidar com um erro "Throttling - Maximum sending rate exceeded" (Controle de utilização - taxa máxima de envio excedida) no blog Messaging and Targeting (Envio de mensagens e segmentação) da AWS.

  • Maximum SigV2 SMTP sending rate exceeded (Taxa máxima de envio SMTP SigV2 excedida): você está tentando enviar mensagens usando credenciais SMTP criadas antes de 10 de janeiro de 2019; suas credenciais SMTP foram criadas usando uma versão mais antiga do AWS Signature. Por motivos de segurança, você deve excluir as credenciais que criou antes desta data e substituí-las por credenciais mais novas. Você pode excluir as credenciais mais antigas usando o console do IAM. Para obter mais informações sobre consulte Obtendo SES SMTP credenciais da Amazon para criação de um arquivo de credenciais.

  Você deve monitorar regularmente sua atividade de envio para ver se está próximo de suas cotas de envio. Para obter mais informações, consulte . Monitorando suas cotas de SES envio da Amazon. Para obter informações gerais sobre as cotas de envio, consulte Gerenciamento de limites do envio do Amazon SES. Para obter informações sobre como aumentar suas cotas de envio, consulte Aumento de suas cotas de envio do Amazon SES.

  Importante

  Se o texto de erro que explica o erro de limitação não estiver relacionado à sua cota diária ou taxa máxima de envio, pode ter havido um problema no sistema que está causando a redução da capacidade de envio. Para obter informações sobre o status do serviço, vá para o AWS Service Health Dashboard.

• Não há destinatários especificados – nenhum destinatário foi fornecido.

• There are non-ASCII characters in the email address (Há caracteres não ASCII no endereço de e-mail): a sequência de endereço de e-mail deve ser ASCII de 7 bits. Se você deseja enviar para ou de endereços de e-mail que contêm caracteres Unicode na parte de domínio de um endereço, você deve codificar o domínio usando Punycode. Punycode não é permitido na parte local do endereço de e-mail (na parte antes de @) nem no nome "amigável de". Se você quiser usar caracteres Unicode no nome "amigável de", deve codificá-lo usando a sintaxe de palavras codificadas por MIME, conforme descrito em Enviando e-mail bruto usando o Amazon SES API v2. Para obter mais informações sobre Punycode, consulte RFC 3492.

• Mail FROM domain is not verified (Domínio Mail FROM não está verificado): o Amazon SES não pôde ler o registro MX necessário para usar o domínio MAIL FROM especificado. Para obter informações sobre como configurar domínios MAIL FROM personalizados, consulte Uso de um domínio MAIL FROM personalizado.

• Configuration set does not exist (A configuração não existe): o conjunto de configurações que você especificou não existe. Um conjunto de configurações é um parâmetro opcional que você usa para publicar eventos de envio de e-mail. Para obter mais informações, consulte . Monitore o envio de e-mails usando a publicação de SES eventos da Amazon.