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

# Identidades de remetente

> Verifique um domínio, publique seus registros DNS, rotacione chaves DKIM e configure a autenticação do remetente.

Crie uma identidade para cada domínio de envio em cada região. Verificar em uma região não verifica o domínio em outra. Uma identidade verificada permite endereços de remetente naquele domínio ou em seus subdomínios. Identidades pendentes, com falha ou suspensas não podem enviar.

<span id="create-and-verify-a-domain" />

## Criar e verificar um domínio

<Tabs>
  <Tab title="Console">
    Abra Email e **Sender identities**. Clique em **Create identity**, informe o domínio e abra a identidade criada. Publique os registros mostrados em **DNS records** e solicite a verificação na página da identidade.
  </Tab>

  <Tab title="API">
    Envie `POST /v1/identities`:

    ```json theme={null}
    {"name":"example.com","tags":{"environment":"production"}}
    ```

    Salve `identity.id`. Publique as entradas de `identity.dns_records` usando exatamente seus nomes, tipos e valores. Depois chame `POST /v1/identities/{identity_id}/verify` e consulte `identity.status`.
  </Tab>

  <Tab title="CLI">
    Salve a solicitação JSON da aba API como `request-1.json`. Use sua conta e região configuradas.

    ```bash theme={null}
    basaltic email identity create --from-file request-1.json
    ```
  </Tab>

  <Tab title="Go">
    Salve a solicitação JSON da aba API como `request-1.json`. Configure credenciais, conta e região pelas variáveis de ambiente do SDK.

    ```go theme={null}
    package main

    import (
    	"context"
    	"encoding/json"
    	"fmt"
    	"os"

    	basaltic "github.com/basaltic-sh/sdk-go"
    	"github.com/basaltic-sh/sdk-go/email"
    )

    func readJSON(path string, value any) error {
    	data, err := os.ReadFile(path)
    	if err != nil {
    		return err
    	}
    	return json.Unmarshal(data, value)
    }

    func run() error {
    	ctx := context.Background()
    	cfg, err := basaltic.NewConfig(ctx)
    	if err != nil {
    		return err
    	}
    	client := email.New(cfg)
    	var request1 email.CreateIdentityRequest
    	if err := readJSON("request-1.json", &request1); err != nil {
    		return err
    	}
    	result1, err := client.CreateIdentity(ctx, &request1)
    	if err != nil {
    		return err
    	}
    	fmt.Printf("%+v\n", result1)
    	return nil
    }

    func main() {
    	if err := run(); err != nil {
    		fmt.Fprintln(os.Stderr, err)
    		os.Exit(1)
    	}
    }
    ```
  </Tab>
</Tabs>

Registros com `required: true` estabelecem a propriedade e a assinatura DKIM. Registros SPF e DMARC recomendados ajudam os provedores destinatários a autenticar e avaliar emails. Use os registros retornados em vez de montar nomes DNS regionais. Mantenha os registros de verificação e DKIM publicados após verificar. Alterações DNS podem levar algum tempo para ficar visíveis aos resolvedores.

<span id="rotate-dkim" />

## Rotacionar DKIM

Comece com `POST /v1/identities/{identity_id}/dkim/rotate`. Publique os registros do novo seletor mantendo o seletor ativo no DNS. Chame `POST /v1/identities/{identity_id}/dkim/rotate/finalize` depois que os novos registros resolverem. Durante a sobreposição, a resposta expõe o seletor antigo e `dkim_old_expires_at`; mantenha os registros DNS antigos até esse horário.

Cancele uma rotação pendente com `DELETE /v1/identities/{identity_id}/dkim/rotate`. O cancelamento descarta a chave pendente e mantém o seletor ativo.

<span id="custom-mail-from" />

## MAIL FROM personalizado

Um domínio MAIL FROM personalizado controla o remetente do envelope usado para tratar retornos de falha. Ele deve ser igual ao domínio da identidade verificada ou um subdomínio dele. É separado do cabeçalho visível `From`.

Defina `domain` com `PATCH /v1/identities/{identity_id}/mail-from-domain`, publique os registros DNS retornados e chame o endpoint `/verify` correspondente. Para voltar ao domínio de envelope da plataforma, envie `{"domain":null}`. A propriedade `domain` é opcional; a omissão preserva o valor e uma string vazia é inválida.

<span id="bimi" />

## BIMI

Configure BIMI com `PATCH /v1/identities/{identity_id}/bimi`. `logo_url` deve apontar para um logo SVG Tiny PS acessível publicamente por HTTPS. `vmc_url` é uma URL HTTPS opcional de certificado. Publique o registro DNS BIMI e chame `/bimi/verify` para validar os arquivos referenciados. A verificação não garante que um provedor de email exibirá o logo.

Envie `{"logo_url":null}` para limpar BIMI. Omitir `vmc_url` preserva o certificado; `vmc_url: null` remove somente o vínculo do certificado. Não é possível definir um certificado sem um logo.

<span id="inspect-sending-health" />

## Inspecionar a saúde do envio

A aba **Metrics** da identidade mostra tráfego, feedback, engajamento, mensagens pendentes, latência SMTP e reputação por meio de [Telemetry](/pt/email/metrics). Os gráficos de reputação acompanham as contagens e taxas das últimas 24 horas usadas nas restrições de envio.

Use **Settings** para gerenciar recebimento, rotação DKIM, MAIL FROM e BIMI em cards separados. **DNS records** separa registros de envio dos registros MX de recebimento. Use **Recipient rules** para criar regras de endereços recebidos e escolher tópicos de Notifications pelo nome. Os detalhes da identidade mostram a retenção de mensagens e o bucket de anexos selecionado. Consulte [Recebimento de email](/pt/email/receiving) para registros MX, roteamento e limites.

Excluir uma identidade inicia sua remoção e apaga as mensagens associadas, a configuração de recebimento e as chaves de assinatura. Use a zona de perigo na aba **Settings** somente depois de interromper os envios que dependem dela.

<span id="dns-record-groups-and-alternatives" />

## Grupos e alternativas de registros DNS

`dns_records` inclui registros das duas funções, diferenciados por `group: "sending"` e `group: "receiving"`. Os valores estão prontos para copiar, incluindo a prioridade MX. Os registros MX e SPF do MAIL FROM personalizado pertencem ao grupo de envio.

Registros com o mesmo `alternative_group` são alternativas. Publique exatamente uma alternativa para um grupo obrigatório: um registro TXT DKIM ou sua delegação CNAME. Eles não podem coexistir no mesmo nome DNS. Durante a rotação, mantenha o seletor atual funcionando enquanto publica uma alternativa para o seletor pendente.

Use `PATCH /v1/identities/{identity_id}` para substituir tags. A omissão preserva as tags; um objeto vazio as remove. MAIL FROM e BIMI também usam PATCH: a omissão preserva cada configuração, enquanto null a limpa. Limpar o logo BIMI também limpa seu certificado. Limpar apenas `vmc_url` mantém o logo.


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