termo · amazon ses

O que é o Amazon SES e como ele afeta o e-mail da aplicação?

Amazon Simple Email Service, ou Amazon SES, é a infraestrutura da AWS para enviar e-mail por uma interface de API ou SMTP e receber e-mail. Para uma equipe de aplicação, escolher o SES significa assumir mais do que a chamada de envio: identidades verificadas, configuração regional, permissões IAM, tratamento de cotas, composição de mensagens, ingestão de eventos, resposta a bounce e reclamação, supressão e monitoramento operacional. A aceitação pelo SES significa que a AWS tentará a entrega; ela não prova a chegada à caixa de entrada. Trate o SES como uma camada de transporte e feedback dentro de um sistema maior de e-mail da aplicação.

Entenda os limites do serviço

O SES aceita e-mail da aplicação por APIs da AWS ou por um endpoint SMTP e pode montar uma mensagem MIME a partir de campos estruturados ou aceitar uma mensagem montada pelo remetente. Isso o torna infraestrutura, não um fluxo de produto completo. Sua aplicação ainda decide quem pode enviar, qual tenant é dono de um domínio, como templates e dados de destinatários são tratados, quando novas tentativas são seguras e o que os usuários veem após o sucesso de uma requisição. Uma arquitetura útil separa três estados: a aplicação aceitou um job, o SES aceitou uma mensagem e um servidor de e-mail de recebimento aceitou ou rejeitou a mensagem. Esses estados ocorrem em momentos diferentes e exigem identificadores diferentes. Armazene seu próprio ID de job imutável ao lado do identificador da mensagem do SES para que novas tentativas de webhook e investigações de suporte possam ser conciliadas sem adivinhar a partir de linhas de assunto ou dados de destinatários.

Verifique as identidades antes de enviar

A AWS define uma identidade verificada como um domínio ou endereço de e-mail usado com o SES. Antes de enviar, a identidade de From, Source, Sender ou Return-Path deve atender às regras de verificação do SES. A verificação de domínio costuma ser a escolha duradoura para uma aplicação, porque pode autorizar endereços sob esse domínio e suporta autenticação no nível do domínio. A verificação não é uma caixa marcada uma única vez que possa ser copiada para todos os deploys. O status da identidade e a configuração do Easy DKIM são regionais, então um domínio verificado em uma região da AWS não fica automaticamente pronto em outra. Construa o onboarding como uma máquina de estados: solicite a identidade, mostre os registros DNS exatos, consulte o status oficial no provedor e só permita envios em produção depois que a região escolhida informar sucesso. Preserve a política de SPF e DMARC existente quando o DNS for compartilhado com outro remetente e nunca crie um segundo registro SPF por conveniência.

Torne a região parte da configuração de e-mail

Os recursos e os limites operacionais do SES são regionais. Identidades verificadas, status de sandbox, cota diária, taxa máxima de envio, configuração do Easy DKIM, configuração de supressão e destinos de feedback podem variar entre regiões. Uma credencial válida na AWS não torna uma identidade portável para outro endpoint do SES. Coloque a região ao lado da conta do provedor e da identidade na configuração, em vez de escondê-la em um padrão genérico de ambiente. Para failover, prepare a região secundária antes de um incidente: verifique a identidade, publique os registros DKIM, obtenha acesso de produção e cotas adequadas, configure os destinos de eventos, teste os identificadores de mensagem e o processamento de webhooks e confirme que o comportamento de supressão está entendido. Caso contrário, trocar apenas o endpoint durante uma indisponibilidade pode substituir um incidente por falhas de verificação, throttling ou feedback ausente.

Escolha entre API e SMTP de forma deliberada

A AWS suporta envio em produção pela API do SES e pela interface SMTP. A API se encaixa em aplicações que já usam a autenticação e os SDKs da AWS e expõe operações estruturadas e de mensagem bruta. O SMTP se encaixa em softwares que já falam SMTP, mas as credenciais SMTP do SES são diferentes das chaves de acesso comuns da AWS e continuam sendo regionais. A escolha não elimina a necessidade de filas, idempotência, tratamento de timeouts ou regras seguras de novas tentativas. Se a conexão falhar antes de a sua aplicação receber uma resposta, o provedor ainda pode ter aceitado a mensagem. Evite tentar novamente às cegas uma requisição do usuário com um novo identificador da aplicação. Enfileire uma vez, guarde a resposta do provedor quando houver e faça os workers tentarem novamente um job estável. Use uma operação de mensagem bruta só quando precisar de controle exato do MIME e valide os cabeçalhos e o comprimento das linhas antes de entregar a mensagem ao SES.

Trate o sandbox e as cotas como restrições em tempo de execução

Novas combinações de conta e Region do SES podem estar no sandbox. A AWS atualmente documenta limites do sandbox de 200 entregas a destinatários por 24 horas e um e-mail por segundo, com o envio restrito a destinatários verificados, exceto pelo simulador de caixa postal. As cotas de produção variam conforme a conta, a Region e o caso de uso aprovado. As cotas contam destinatários, não requisições de API; assim, uma requisição endereçada a dez destinatários consome dez unidades. Leia a cota real de cada Region ativa e projete backpressure considerando tanto a franquia diária móvel quanto a taxa de envio. Um throttling do provedor deve adiar um job na fila, não criar envios duplicados nem aparecer como um sucesso sem explicação. Solicite acesso à produção e limites realistas antes do lançamento e faça testes de carga com destinatários controlados. Não descreva o sandbox como um plano gratuito e não suponha que a aprovação em uma Region se aplique a outra.

Construa o estado de entrega a partir de eventos

Uma operação de envio bem-sucedida no SES significa que a requisição foi aceita e que o SES tentará a entrega. Não significa que o destinatário abriu a mensagem, que a viu na caixa de entrada nem mesmo que o servidor de destino a aceitou. A publicação de eventos do SES pode informar envios, entregas, bounces, reclamações, rejeições, falhas de renderização, atrasos, inscrições, aberturas e cliques por meio de destinos configurados na AWS. A distinção operacionalmente importante é que um evento de entrega representa a aceitação pelo servidor de e-mail do destinatário, enquanto os eventos de bounce e de reclamação exigem respostas de política. Faça a ingestão de eventos de forma idempotente, porque os sistemas de entrega podem reenviar notificações. Preserve o identificador de mensagem do provedor e o horário do evento, rejeite payloads de webhook malformados e torne as transições de estado monotônicas sempre que possível. Aberturas e cliques são sinais opcionais de engajamento, com limitações de privacidade e de cliente; eles não devem redefinir se a entrega no transporte ocorreu.

Trate bounces, reclamações e supressão

Suprimir destinatários sabidamente ruins ou que não querem receber protege tanto os usuários quanto a conta de envio. A AWS oferece supressão global, no nível da conta, no nível do configuration set e, mais recentemente, no nível do tenant, mas o escopo exato depende da configuração e da região. Sua aplicação ainda precisa de uma política clara para os destinatários. Endereços com bounce permanente devem parar de receber novas tentativas rotineiras, reclamações devem acionar supressão imediata e a remoção deve exigir evidências de que o endereço é válido e de que o destinatário espera o e-mail. Em um produto multi-tenant, decida se a supressão vale para a conta inteira ou é isolada antes de fazer o onboarding de clientes, porque a supressão compartilhada pode fazer o resultado de um tenant afetar o envio de outro. Mantenha os endereços brutos fora de analytics e logs gerais. Os sistemas operacionais podem precisar do endereço para aplicar a supressão, mas painéis e experimentos devem usar medidas agregadas ou pseudonimizadas.

Aplique o menor privilégio e isole os tenants

As políticas de IAM podem restringir quais operações do SES um principal pode chamar e podem limitar os endereços de From, de destinatário ou de Return-Path nas ações de envio. As políticas de autorização de envio resolvem outro problema: permitem que o dono de uma identidade delegue o uso de uma identidade verificada, e podem ser revogadas de forma independente. Para uma única aplicação, prefira um principal apenas com as ações de envio e de monitoramento de que a carga de trabalho realmente precisa. Não dê credenciais da AWS a um navegador. Um produto de e-mail multi-tenant também precisa de autorização na camada de aplicação, porque uma conta SES compartilhada não entende automaticamente o seu modelo de workspaces. Verifique se o tenant autenticado é dono de um domínio From verificado antes de enviar ao SES, restrinja o escopo das chaves de API e dos registros de mensagens a esse tenant e faça identificadores de outros tenants não retornarem dados. O IAM do provedor e a autorização da aplicação são controles complementares, não substitutos.

Use uma checklist de prontidão para produção

Antes do lançamento, registre a conta da AWS, a região, o ARN da identidade, o status de verificação, o status do DKIM, o estado do sandbox, a cota diária, a taxa máxima de envio, o destino de eventos, o escopo da supressão e o responsável pelas credenciais. Teste uma entrega normal, um bounce do simulador de caixa postal, um teste de reclamação quando suportado, uma resposta de throttling, um reenvio de evento e um timeout do provedor após o envio. Confirme que os workers da fila não duplicam um job estável, que um evento de entrega atualiza a mensagem correta e que um bounce permanente impede outro envio rotineiro. Configure alarmes para requisições rejeitadas, throttling, falhas de ingestão de eventos, mudanças em bounces e reclamações e margem de cota. Revise a configuração sempre que uma nova região, domínio, tipo de tenant ou classe de mensagem for introduzido. Essa checklist transforma o SES de uma dependência oculta em um subsistema explícito, com responsáveis e modos de falha observáveis.

Decida onde o SendHQ se encaixa

Teams can integrate SES directly when they want AWS-native control and are prepared to build the surrounding application layer. SendHQ offers a narrower, workspace-scoped email contract with verified sending domains, scoped API keys, single and batch sends, inbound inboxes, delivery-event access, and suppression workflows. Its public API requires the From domain to belong to the workspace and be verified, and it records accepted messages for later inspection. SendHQ also manages the sending side: each workspace gets an isolated sending tenant, bounces and complaints are suppressed automatically, and reputation guardrails throttle or pause a sender whose feedback turns unhealthy. Recipient-side filtering still applies to every sender. Neither direct SES nor SendHQ establishes inbox placement, so assess both on controls, observability, ownership, and fit for your application's workflow.

Perguntas frequentes

O Amazon SES é uma API de e-mail ou um servidor SMTP?

Ele oferece tanto uma API HTTPS quanto uma interface SMTP. Escolha com base nas necessidades de autenticação e de composição de mensagens da sua aplicação, mantendo filas, identificadores de job estáveis, processamento de eventos e supressão fora da chamada de transporte.

Preciso verificar um domínio para usar o Amazon SES?

Você deve verificar cada identidade usada como endereço de From, Source, Sender ou Return-Path. Uma identidade de endereço de e-mail pode funcionar em casos limitados, enquanto a verificação de domínio geralmente é mais prática para endereços controlados pela aplicação e para o DKIM.

Uma resposta de sucesso do SES significa que o e-mail foi entregue?

Não. Significa que o SES aceitou a requisição e tentará a entrega. Um evento de entrega posterior significa que o servidor de e-mail do destinatário aceitou a mensagem, e nenhum dos dois estados prova que a mensagem chegou à pasta da caixa de entrada.

As cotas do Amazon SES são compartilhadas entre regiões?

Não. A AWS documenta como regionais as cotas de envio, o status de sandbox, as identidades verificadas, a configuração do DKIM e a configuração de supressão. Prepare e teste todas as regiões que podem receber tráfego de produção, em vez de trocar de endpoint durante um incidente.

O que uma aplicação deve armazenar depois de enviar pelo SES?

Armazene um ID de job da aplicação estável, o identificador de mensagem do SES quando aceita, o provedor e a região, o estado atual, os timestamps e os eventos de entrega normalizados. Mantenha o conteúdo das mensagens e os dados dos destinatários fora de logs e analytics amplos.

Quando uma equipe deve usar o SendHQ em vez do SES direto?

Use o SES direto quando a equipe quiser ser dona da integração com a AWS e de todos os controles ao redor. Considere o SendHQ quando chaves com escopo por workspace, verificações de propriedade de domínio, caixas de entrada para e-mail de entrada, recursos de mensagens, eventos de entrega e fluxos de supressão forem primitivas úteis para a aplicação.

Fontes