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

> Verifique un dominio, publique sus registros DNS, rote las claves DKIM y configure la autenticación del remitente.

Cree una identidad por cada dominio de envío en cada región. La verificación en una región no verifica el dominio en otra. Una identidad verificada permite direcciones de remitente en ese dominio o sus subdominios. Las identidades pendientes, fallidas o suspendidas no pueden enviar.

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

## Crear y verificar un dominio

<Tabs>
  <Tab title="Console">
    Abra Email y **Sender identities**. Haga clic en **Create identity**, introduzca el dominio y abra la identidad creada. Publique los registros de **DNS records** y solicite la verificación desde la página de la identidad.
  </Tab>

  <Tab title="API">
    Envíe `POST /v1/identities`:

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

    Guarde `identity.id`. Publique las entradas de `identity.dns_records` usando exactamente sus nombres, tipos y valores. Después llame a `POST /v1/identities/{identity_id}/verify` y consulte `identity.status`.
  </Tab>

  <Tab title="CLI">
    Guarde la solicitud JSON de la pestaña API como `request-1.json`. Use su cuenta y región configuradas.

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

  <Tab title="Go">
    Guarde la solicitud JSON de la pestaña API como `request-1.json`. Configure credenciales, cuenta y región mediante las variables de entorno del 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>

Los registros con `required: true` establecen la propiedad y la firma DKIM. Los registros SPF y DMARC recomendados ayudan a los proveedores destinatarios a autenticar y evaluar el correo. Use los registros devueltos en lugar de construir nombres DNS regionales. Mantenga publicados los registros de verificación y DKIM tras verificar. Los cambios DNS pueden tardar en ser visibles para los resolutores.

<span id="rotate-dkim" />

## Rotar DKIM

Comience con `POST /v1/identities/{identity_id}/dkim/rotate`. Publique los registros del nuevo selector y mantenga el selector activo en DNS. Llame a `POST /v1/identities/{identity_id}/dkim/rotate/finalize` cuando resuelvan los nuevos registros. Durante la superposición, la respuesta expone el selector anterior y `dkim_old_expires_at`; mantenga los registros DNS anteriores hasta ese momento.

Cancele una rotación pendiente con `DELETE /v1/identities/{identity_id}/dkim/rotate`. La cancelación descarta la clave pendiente y mantiene el selector activo.

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

## MAIL FROM personalizado

Un dominio MAIL FROM personalizado controla el remitente del sobre usado para gestionar rebotes. Debe coincidir con el dominio de la identidad verificada o ser un subdominio suyo. Es independiente de la cabecera visible `From`.

Establezca `domain` con `PATCH /v1/identities/{identity_id}/mail-from-domain`, publique los registros DNS devueltos y llame al endpoint `/verify` correspondiente. Para volver al dominio de sobre de la plataforma, envíe `{"domain":null}`. La propiedad `domain` es opcional; omitirla conserva el valor y una cadena vacía no es válida.

<span id="bimi" />

## BIMI

Configure BIMI con `PATCH /v1/identities/{identity_id}/bimi`. `logo_url` debe apuntar a un logotipo SVG Tiny PS accesible públicamente por HTTPS. `vmc_url` es una URL HTTPS opcional de certificado. Publique el registro DNS BIMI y llame a `/bimi/verify` para validar los archivos referenciados. La verificación no garantiza que un proveedor de correo muestre el logotipo.

Envíe `{"logo_url":null}` para borrar BIMI. Omitir `vmc_url` conserva el certificado; `vmc_url: null` elimina solo el vínculo del certificado. No se puede establecer un certificado sin un logotipo.

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

## Inspeccionar el estado del envío

La pestaña **Metrics** de la identidad muestra tráfico, respuestas, interacción, mensajes pendientes, latencia SMTP y reputación mediante [Telemetry](/es/email/metrics). Los gráficos de reputación muestran los recuentos y tasas de las últimas 24 horas usados para restringir envíos.

Use **Settings** para administrar la recepción, la rotación DKIM, MAIL FROM y BIMI en tarjetas separadas. **DNS records** separa los registros de envío de los registros MX de recepción. Use **Recipient rules** para crear reglas de direcciones entrantes y elegir temas de Notifications por nombre. Los detalles de la identidad muestran la retención de mensajes y el bucket de adjuntos seleccionado. Consulte [Recepción de correo](/es/email/receiving) para los registros MX, el enrutamiento y los límites.

Eliminar una identidad inicia su retirada y borra los mensajes asociados, la configuración de recepción y las claves de firma. Use la zona de peligro en la pestaña **Settings** solo después de detener los envíos que dependen de ella.

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

## Grupos y alternativas de registros DNS

`dns_records` incluye registros de ambas funciones, diferenciados por `group: "sending"` y `group: "receiving"`. Los valores están listos para copiar, incluida la prioridad MX. Los registros MX y SPF de MAIL FROM personalizado pertenecen al grupo de envío.

Los registros con el mismo `alternative_group` son alternativas. Publique exactamente una alternativa para un grupo obligatorio: un registro TXT DKIM o su delegación CNAME. No pueden coexistir en el mismo nombre DNS. Durante la rotación, mantenga operativo el selector actual mientras publica una alternativa para el selector pendiente.

Use `PATCH /v1/identities/{identity_id}` para sustituir etiquetas. La omisión conserva las etiquetas; un objeto vacío las elimina. MAIL FROM y BIMI también usan PATCH: la omisión conserva cada ajuste, mientras que null lo borra. Borrar el logotipo BIMI también borra su certificado. Borrar solo `vmc_url` conserva el logotipo.


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