# Aggiungi un dominio di invio

> Aggiungi il tuo dominio a Emailit, pubblica i record DNS che genera, inviali a uno sviluppatore se serve e verifica il dominio per poter inviare.

Questa guida ti accompagna nell’aggiunta di un dominio di invio, nella pubblicazione dei suoi record DNS e nella sua verifica. Richiede pochi minuti di lavoro, più il tempo che il tuo provider DNS impiega a pubblicare i record.

## Prima di iniziare

- Ti serve l’accesso alle impostazioni DNS del dominio, o una persona che ce l’abbia. Puoi [inviarle i record via email](#send-the-records-to-someone-else).
- Decidi da quale dominio invierai. Usare un sottodominio come `mail.acme.com` tiene la reputazione di invio separata da quella del dominio principale. Vedi [Dominio principale o sottodominio?](/it/docs/domains/#root-domain-or-subdomain)
- Controlla che il tuo piano abbia spazio per un altro dominio. Vedi [Limiti dei domini](/it/docs/domains/limits/).
- Per l’API, usa una chiave API con **Full Access**. Le chiavi di solo invio non possono gestire i domini.

## Regole per il nome del dominio

- Inserisci il dominio senza altro: `acme.com` o `mail.acme.com`. Non includere `http://`, `https://` né il prefisso `www.`.
- Usa lettere, cifre, trattini e punti, con un dominio di primo livello di almeno due lettere. Emailit salva il nome in minuscolo.
- Sono ammessi sottodomini a qualsiasi profondità, ad esempio `eu.mail.acme.com`. Ognuno è un dominio separato con i propri record.
- Un nome si può aggiungere una sola volta per workspace. Se lo aggiungi di nuovo ricevi `409 Domain with this name already exists`.

## Aggiungi il dominio

**Pannello**

  1. **Apri Domains.** Vai a **Email API → Domains** e seleziona **Add domain**.

     Se il pulsante è disattivato, il workspace ha raggiunto il limite di domini. Il badge accanto al titolo della pagina mostra quanti ne hai usati.

  2. **Inserisci il dominio.** Nel campo **Name**, digita il dominio da cui invii, ad esempio `mail.acme.com`, e seleziona **Create**.

  3. **Controlla i record.** Emailit apre la pagina del dominio sulla scheda **DNS Setup**. Elenca ogni record con tipo, nome, valore, priorità e TTL, e un pulsante per copiare ciascun valore.

**API**

  Chiama [Crea un dominio](/it/docs/api-reference/domains/create/) con il nome del dominio.

```bash
curl https://api.emailit.com/v2/domains \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.acme.com" }'
```

  La risposta `201` include l’`id` del dominio e un array `dns_records` con tutti i record da pubblicare:

```json
{
  "object": "domain",
  "id": "dom_2kq8Vt4xLm7Rz",
  "name": "mail.acme.com",
  "verification_status": "pending",
  "manual_review_required": false,
  "spf_status": "pending",
  "dkim_status": "pending",
  "return_path_status": "pending",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.mail.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.mail.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}
```

  La risposta completa elenca tutti e sei i record, compresi DKIM, DMARC, tracciamento ed email in entrata. Quando crei il dominio puoi anche impostare questi campi facoltativi:

  | Campo | Predefinito | Descrizione |
  | --- | --- | --- |
  | `tracking_key` | `go` | Prefisso del sottodominio per il CNAME di tracciamento. Vedi [Configura un dominio di tracciamento personalizzato](/it/docs/tracking/custom-tracking-domain/). |
  | `inbound_key` | `inbound` | Prefisso del sottodominio per il record MX di ricezione. |
  | `dmarc_reports` | `false` | Aggiunge l’indirizzo di Emailit per i report al record DMARC suggerito. Solo Pro, Business e Custom; altrimenti `403 plan_required`. |

  `track_loads` e `track_clicks` non si possono attivare quando crei un dominio, perché il tracciamento richiede prima un CNAME di tracciamento verificato. Se invii `true` ricevi `422`.

Non esiste un interruttore separato per la posta in uscita o in entrata. Un dominio verificato può inviare, e riceve le email in entrata appena il suo record MX di ricezione è pubblicato. L’API accetta i flag `outgoing` e `incoming` per compatibilità, ma non cambiano il comportamento del dominio.

## Pubblica i record DNS

Aggiungi i record presso la società che ospita i DNS del tuo dominio. Spesso è il registrar (GoDaddy, Namecheap) o un servizio DNS (Cloudflare, Amazon Route 53).

| Record | Tipo | Host | Cosa fare |
| --- | --- | --- | --- |
| Return path | MX | `emailit.<domain>` | Obbligatorio. Priorità 10. |
| SPF | TXT | `emailit.<domain>` | Obbligatorio. |
| DKIM | TXT | `emailit._domainkey.<domain>` | Obbligatorio. Incolla il valore completo. |
| DMARC | TXT | `_dmarc.<domain>` | Consigliato. Saltalo se il dominio ha già un record DMARC. |
| Tracciamento | CNAME | `go.<domain>` | Solo se vuoi il tracciamento di aperture e clic. |
| Ricezione | MX | `inbound.<domain>` | Solo se vuoi ricevere email. Priorità 10. |

La maggior parte dei provider DNS vuole nel campo host solo la parte che precede il tuo dominio (`emailit`, non `emailit.acme.com`). [Record DNS](/it/docs/domains/dns-records/) riporta i valori esatti, consigli specifici per provider ed errori comuni.

Se il tuo dominio usa i DNS di Cloudflare, la pagina del dominio offre **Set up with Cloudflare**, che crea i record per te. Vedi [Configura i DNS con Cloudflare](/it/docs/domains/cloudflare/).

## Invia i record a un’altra persona

Se i DNS li gestisce un’altra persona, inviale i record via email dal pannello.

1. **Apri il dominio.** In **Email API → Domains**, seleziona il dominio.

2. **Seleziona Send to email.** Si trova nell’angolo in alto a destra del riquadro **DNS Setup**.

3. **Inserisci il suo indirizzo.** In **Recipient Email**, digita l’indirizzo del tuo sviluppatore o amministratore IT e seleziona **Send Instructions**.

Riceverà un’email da Emailit con ogni record e il suo valore. Chiedigli di avvisarti quando i record sono pubblicati, così puoi eseguire il controllo.

## Controlla i DNS e verifica

**Pannello**

  Nella pagina del dominio, seleziona **Check DNS**. Emailit cerca ogni record e aggiorna lo stato accanto a ciascuno: **OK**, **Missing**, **Invalid** o **Not checked**. Passa il puntatore su **Missing** o **Invalid** per vedere cosa ha trovato Emailit.

**API**

  Chiama [Verifica un dominio](/it/docs/api-reference/domains/verify/). Puoi usare l’ID del dominio o il suo nome.

```bash
curl https://api.emailit.com/v2/domains/mail.acme.com/verify \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  La risposta contiene il dominio aggiornato. Controlla `verification_status` e i campi `status` ed `error` di ogni elemento di `dns_records`.

> **La verifica viene eseguita solo quando la richiedi:** Emailit non verifica da solo un nuovo dominio. Dopo aver pubblicato o corretto i record, esegui di nuovo **Check DNS**. Le modifiche DNS di solito compaiono in pochi minuti, ma alcuni provider impiegano fino a 48 ore.

Il dominio è verificato quando SPF, DKIM e return path mostrano tutti **OK**. DMARC, tracciamento e ricezione sono facoltativi e non influiscono sulla verifica.

## Verifica che funzioni

- Il dominio risulta **Verified** in **Email API → Domains**, e le colonne **SPF**, **DKIM** e **Return Path** mostrano **OK**.
- Invia un messaggio di prova da un indirizzo del dominio. Nella pagina **Emails**, seleziona **Compose**, oppure chiama [Invia un’email](/it/docs/api-reference/emails/send/).

Se il dominio risulta **Pending verification**, è in attesa di revisione manuale. Riguarda i domini Pay as you go registrati da meno di 30 giorni. Vedi [Verifica del dominio](/it/docs/domains/verification/#pending-verification).

> **Nota:** Un dominio verificato non fa uscire il workspace dalla modalità sandbox. Finché il workspace non ha l’accesso alla produzione, puoi inviare solo agli indirizzi email degli account dei membri del workspace. Vedi [Accesso alla produzione](/it/docs/workspaces/production-access/).

## Risoluzione dei problemi

| Problema | Soluzione |
| --- | --- |
| **Add domain** è disattivato | Hai raggiunto il limite di domini del piano. Elimina un dominio inutilizzato o aumenta il limite. Vedi [Limiti dei domini](/it/docs/domains/limits/). |
| `The domain must be in apex format` | Rimuovi `http://`, `https://` o `www.` e assicurati che il nome termini con un dominio di primo livello reale. |
| I record risultano **Missing** dopo un’ora | Probabilmente l’host è duplicato, ad esempio `emailit.acme.com.acme.com`. Inserisci solo `emailit` nel campo host. |
| DKIM risulta **Invalid** | Una parte del valore è stata tagliata. Copialo di nuovo con il pulsante di copia. |

[Verifica del dominio](/it/docs/domains/verification/#troubleshooting) copre altri casi.

## Vedi anche

  - [Record DNS](/it/docs/domains/dns-records/): Riferimento di ogni record generato da Emailit.
  - [Verifica del dominio](/it/docs/domains/verification/): Stati, revisione manuale e ricontrolli giornalieri.
  - [Configura un dominio di tracciamento personalizzato](/it/docs/tracking/custom-tracking-domain/): Configura il tracciamento di aperture e clic.
  - [Configura le email in entrata](/it/docs/inbound/set-up/): Ricevi email sul tuo dominio.

---
Fonte: https://emailit.com/it/docs/domains/add-a-domain/