# Configura le email in entrata

> Pubblica il record MX per le email in entrata del tuo dominio verificato, scegli il sottodominio di ricezione, verifica il record e invia un messaggio di prova.

Questa guida collega un sottodominio del tuo dominio a Emailit perché possa ricevere email. Richiede un solo record DNS e non cambia il modo in cui viene consegnata la posta del dominio principale.

## Prima di iniziare

- Un [dominio di invio verificato](/it/docs/domains/verification/) nel workspace, ad esempio `acme.com`. Le email in entrata funzionano solo sui domini verificati. Se non ne hai ancora aggiunto uno, segui [Aggiungi un dominio](/it/docs/domains/add-a-domain/).
- Accesso alle impostazioni DNS di quel dominio.
- Crediti disponibili. Ogni messaggio ricevuto costa 1 credito.
- I domini vengono creati con la posta in entrata attiva (il campo `incoming` è `true` per impostazione predefinita). Lascialo così: nel pannello non c’è un interruttore per questa impostazione.

## Scegli il sottodominio di ricezione

Emailit accetta posta per un sottodominio per dominio. Per impostazione predefinita è `inbound`, quindi gli indirizzi hanno la forma `anything@inbound.acme.com`. Puoi vedere il valore attuale nella pagina del dominio, in **Custom Subdomains** > **Inbound Subdomain**. Nel pannello il campo è in sola lettura.

Per usare un sottodominio diverso, imposta `inbound_key` con [Aggiorna un dominio](/it/docs/api-reference/domains/update/). Il valore può contenere lettere minuscole, cifre e trattini, può essere lungo da 1 a 63 caratteri e non può iniziare né finire con un trattino.

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

Con `"inbound_key": "mail"`, gli indirizzi diventano `anything@mail.acme.com` e il record MX si sposta su `mail.acme.com`. Cambiare la chiave riporta lo stato del record di ricezione in attesa, e la posta inviata al vecchio sottodominio non viene più accettata. Imposta `inbound_key` su `null` per tornare a `inbound`.

## Aggiungi il record MX

1. **Apri il dominio.** Nel pannello, vai a **Email API → Domains**, seleziona il dominio e apri la scheda **DNS Setup**.

2. **Trova il record di ricezione.** È il record MX facoltativo con nome `inbound` (o il tuo sottodominio personalizzato) e valore `inbound.emailitmail.com`. Usa i pulsanti di copia per evitare errori di battitura.

3. **Crea il record presso il provider DNS.** Aggiungi un nuovo record con questi valori:

   | Campo | Valore |
   | --- | --- |
   | Tipo | `MX` |
   | Nome / Host | `inbound` (alcuni provider vogliono il nome completo, `inbound.acme.com`) |
   | Server di posta / Valore | `inbound.emailitmail.com` |
   | Priorità | `10` |
   | TTL | Automatico, o il valore predefinito del provider |

   Non modificare i record MX del dominio principale (`acme.com`). Continuano a instradare la tua posta normale al provider di posta.

   Se il dominio usa la [configurazione con un clic di Cloudflare](/it/docs/domains/cloudflare/), puoi selezionare il record **Inbound** nella finestra di configurazione invece di aggiungerlo a mano.

4. **Controlla i DNS.** Torna alla pagina del dominio e seleziona **Check DNS**. Il record di ricezione risulta **OK** quando un record MX con priorità 10 punta a `inbound.emailitmail.com`. La maggior parte dei provider pubblica i record in pochi minuti, ma possono servire fino a 48 ore.

   Puoi controllare anche da un terminale:

```bash
dig MX inbound.acme.com +short
# 10 inbound.emailitmail.com.
```

## Invia un messaggio di prova

Da una qualsiasi casella personale, invia un’email a un indirizzo del sottodominio, ad esempio `test@inbound.acme.com`.

## Verifica che funzioni

- **Pannello:** vai a **Email API → Emails** e apri la scheda **Incoming**. Il messaggio compare entro pochi secondi con stato **Received**. Aprilo per vederne header, contenuto e allegati.
- **Eventi:** **Email API → Events** mostra un evento `email.received`. Il suo payload contiene l’ID dell’email.
- **API:** elenca i messaggi in entrata con [Elenca le email](/it/docs/api-reference/emails/list/):

```bash
curl "https://api.emailit.com/v2/emails?type=inbound" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Poi [elabora la posta ricevuta con un webhook](/it/docs/inbound/process-with-webhooks/) o [inoltrala con un’automazione](/it/docs/inbound/forward-with-automations/).

## Risoluzione dei problemi

<details>
<summary>Il record risulta Missing o Invalid</summary>

Il messaggio di stato indica cosa ha trovato Emailit. «There are no MX records at inbound.acme.com» significa che il record non è ancora pubblicato, oppure che è stato creato sul nome sbagliato (ad esempio `inbound.acme.com.acme.com` quando il provider aggiunge il dominio automaticamente). Uno stato «Invalid» elenca i record trovati e il valore atteso `10 inbound.emailitmail.com`. Correggi priorità o valore, attendi l’aggiornamento dei DNS, poi seleziona di nuovo **Check DNS**.

</details>

<details>
<summary>Ho puntato l’MX del dominio principale a Emailit</summary>

Emailit accetta posta solo per il sottodominio di ricezione. Se i record MX di `acme.com` puntano a `inbound.emailitmail.com`, la posta per `you@acme.com` viene rifiutata con `530 Authentication required`. Ripristina i record MX del dominio principale forniti dal tuo provider di posta e aggiungi il record MX solo su `inbound.acme.com`.

</details>

<details>
<summary>Il record risulta OK, ma la posta va altrove</summary>

Un altro record MX sullo stesso nome può avere la precedenza. I server di posta usano per primo il record con il numero di priorità più basso, quindi un record in più come `5 mx.example.net` su `inbound.acme.com` prevale sul `10` di Emailit. Anche un record MX wildcard (`*.acme.com`) può intercettare il sottodominio se manca il record di ricezione. Esegui `dig MX inbound.acme.com +short` e assicurati che `inbound.emailitmail.com` sia l’unica risposta. Anche un CNAME sullo stesso nome blocca i record MX: rimuovilo.

</details>

<details>
<summary>I mittenti ricevono «530 Authentication required»</summary>

Emailit non ha riconosciuto il dominio del destinatario. Controlla che l’indirizzo usi il sottodominio di ricezione attuale (dopo aver cambiato `inbound_key`, il vecchio sottodominio smette di funzionare), che il dominio sia scritto correttamente e che sia ancora verificato in **Email API → Domains**.

</details>

<details>
<summary>I mittenti ricevono «452 Insufficient credits to receive inbound email»</summary>

Il workspace ha esaurito i crediti. `452` è un errore temporaneo, quindi la maggior parte dei server mittenti continua a ritentare per ore o giorni. [Acquista crediti](/it/docs/billing/credits/) o attiva la [ricarica automatica](/it/docs/billing/auto-refill/), e i messaggi ritentati vengono accettati.

</details>

<details>
<summary>I mittenti ricevono «535 Mail server has been suspended» o «552 Message too large»</summary>

`535` significa che il workspace è sospeso; vedi [Salute degli invii](/it/docs/deliverability/sending-health/) o contatta il supporto. `552` significa che il messaggio supera i 40 MB.

</details>

## Vedi anche

  - [Elabora con i webhook](/it/docs/inbound/process-with-webhooks/)
  - [Record DNS](/it/docs/domains/dns-records/)

---
Fonte: https://emailit.com/it/docs/inbound/set-up/