> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Email

> Verifique identidades de remetente, envie emails, configure o recebimento e acompanhe os resultados das mensagens.

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](/pt/authentication).

<span id="sender-identities" />

## 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.

<span id="sending-and-receiving" />

## 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](/pt/email/permissions).

<span id="resource-references" />

## 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`.

<CardGroup cols={2}>
  <Card title="Identidades de remetente" href="/pt/email/identities">Verify a domain, publish its DNS records, rotate DKIM keys, and configure sender authentication.</Card>
  <Card title="Envio de email" href="/pt/email/sending">Send messages, handle acceptance and partial bulk results, and inspect delivery outcomes.</Card>
  <Card title="Templates de email" href="/pt/email/templates">Create text and HTML templates and send personalized messages to one or many destinations.</Card>
  <Card title="Conjuntos de configuração e supressões" href="/pt/email/configuration-sets">Control sending, engagement tracking, dedicated IP selection, and suppression exceptions.</Card>
  <Card title="Recebimento de email" href="/pt/email/receiving">Route recipient addresses to Notifications topics and retrieve accepted email safely.</Card>
  <Card title="IPs dedicados e pools" href="/pt/email/dedicated-ips">Allocate sending addresses, manage movable pool membership, and warm up traffic.</Card>
  <Card title="Métricas de email" href="/pt/email/metrics">Read sending, feedback, engagement, backlog, and latency through Telemetry.</Card>
  <Card title="Permissões" href="/pt/email/permissions">IAM actions and cross-service grants.</Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.