Skip to main content
Email gerencia identidades de remetente verificadas, mensagens enviadas, templates, conjuntos de configuração, supressões, pools de IPs e emails recebidos. As regras de recebimento encaminham emails aceitos para tópicos de Notifications. O serviço é regional. O endpoint de São Paulo é https://email.sa-saopaulo-1.basaltic.sh. Chamadas autenticadas usam um token bearer e o identificador da conta em X-Account-Id; consulte Autenticação.

Identidades de remetente

Uma identidade começa pendente e retorna os registros DNS necessários para verificar a propriedade e configurar DKIM. Publique esses registros no seu provedor DNS e solicite a verificação. Somente identidades verificadas podem enviar. A verificação pertence à região em que a identidade foi criada.

Envio e recebimento

As APIs de envio aceitam o conteúdo diretamente ou renderizam um template armazenado. Registros de mensagens, registros de rejeição e métricas de Telemetry mostram partes diferentes do ciclo de envio. A aceitação de uma solicitação de envio não confirma que a mensagem chegou à caixa de entrada do destinatário. Para emails recebidos, habilite o recebimento na identidade e configure regras de destinatário. Salvar uma regra exige email:CreateRecipientRule na identidade e notifications:Publish no tópico de destino. Ler os metadados de mensagens recebidas é uma permissão separada de ler o conteúdo ou baixar anexos. Consulte Permissões de Email.

Referências de recursos

Seletores de solicitação como identity, template, configuration_set e ip_pool aceitam um UUID, um nome no escopo da conta ou o CRN do recurso correspondente. Os nomes são imutáveis. Os caminhos de recursos para identidades, mensagens, templates, conjuntos de configuração, pools de IPs, IPs dedicados e supressões usam UUIDs. IPs dedicados pertencem à conta e podem ficar sem pool ou ser movidos entre pools. O campo anulável ip_pool é uma referência de recurso com id, crn e name. Gerencie os membros na aba Member IPs do pool; desvincular um IP mantém sua alocação na conta. Conjuntos de configuração expõem o vínculo com o pool como uma referência opcional ip_pool.

Identidades de remetente

Verify a domain, publish its DNS records, rotate DKIM keys, and configure sender authentication.

Envio de email

Send messages, handle acceptance and partial bulk results, and inspect delivery outcomes.

Templates de email

Create text and HTML templates and send personalized messages to one or many destinations.

Conjuntos de configuração e supressões

Control sending, engagement tracking, dedicated IP selection, and suppression exceptions.

Recebimento de email

Route recipient addresses to Notifications topics and retrieve accepted email safely.

IPs dedicados e pools

Allocate sending addresses, manage movable pool membership, and warm up traffic.

Métricas de email

Read sending, feedback, engagement, backlog, and latency through Telemetry.

Permissões

IAM actions and cross-service grants.