# Ricevi la prima email in entrata

> Aggiungi il record MX per le email in entrata, invia un messaggio di prova al sottodominio di ricezione, trovalo nel pannello ed elaboralo con un webhook email.received e con l’API.

Questo avvio rapido configura un dominio per ricevere email, così la tua app può gestire risposte, richieste di assistenza o messaggi inoltrati. Aggiungerai un record DNS, invierai un messaggio di prova, poi lo riceverai con un webhook e ne recupererai il contenuto completo dall’API.

## Prima di iniziare

- Un dominio di invio verificato, come `acme.com`. Le email in entrata funzionano solo sui domini verificati nel tuo workspace. Vedi [Aggiungi un dominio](/it/docs/domains/add-a-domain/).
- Crediti nel workspace. Ogni email ricevuta costa 1 credito.

## Come funzionano gli indirizzi di ricezione

Emailit riceve la posta su un sottodominio del tuo dominio di invio, per impostazione predefinita `inbound`. Funziona qualsiasi indirizzo su quel sottodominio, quindi `support@inbound.acme.com` e `reply-4821@inbound.acme.com` arrivano entrambi nello stesso workspace. I record MX del dominio principale, ad esempio per Google Workspace o Microsoft 365, restano invariati.

## Aggiungi il record MX per le email in entrata

1. **Apri il dominio.** Vai a **Email API → Domains** e apri `acme.com`. Il record MX per `inbound.acme.com` è elencato insieme agli altri record DNS. È facoltativo, quindi il dominio resta verificato anche senza.

2. **Aggiungi il record presso il tuo provider DNS.**

   | Tipo | Nome | Valore | Priorità |
   | --- | --- | --- | --- |
   | MX | `inbound.acme.com` | `inbound.emailitmail.com` | 10 |

   Alcuni provider DNS vogliono solo `inbound` nel campo del nome. Altri vogliono il nome completo.

3. **Controlla i DNS.** Seleziona **Check DNS** nella pagina del dominio e attendi che il record per le email in entrata mostri **OK**. Le modifiche DNS di solito richiedono pochi minuti, ma possono servire fino a 48 ore.

Per ricevere su un sottodominio diverso, come `replies.acme.com`, imposta `inbound_key` su `replies` quando [crei](/it/docs/api-reference/domains/create/) o [aggiorni](/it/docs/api-reference/domains/update/) il dominio con l’API, poi pubblica il record MX per quel nome. Il pannello mostra il sottodominio di ricezione ma non permette di cambiarlo.

## Invia un’email di prova

Dalla tua casella personale, invia un’email a qualsiasi indirizzo del sottodominio di ricezione, ad esempio `hello@inbound.acme.com`.

Vai a **Email API → Emails** e apri la scheda **Incoming**. Il messaggio compare con lo stato **received**. Aprilo per vedere il mittente, gli header, il contenuto e gli eventuali allegati.

Se non arriva, controlla che il record MX mostri **OK** e che il dominio sia verificato. Se il workspace ha esaurito i crediti, Emailit rifiuta il messaggio con un errore temporaneo e il server del mittente riprova più tardi.

## Ricevi una notifica con un webhook

Per elaborare le email in entrata nella tua app, iscriviti all’evento `email.received`.

1. **Crea il webhook.** Vai a **Email API → Webhooks**, seleziona **Add webhook** e inserisci un nome e il tuo endpoint HTTPS, ad esempio `https://acme.com/webhooks/emailit`. Copia il secret del webhook: ti serve per verificare le firme.

2. **Scegli l’evento.** Un nuovo webhook riceve tutti gli eventi. Apri la scheda **Settings** del webhook e seleziona solo `email.received`, oppure mantieni tutti gli eventi e filtrali nel codice.

3. **Invia un’altra email di prova** a `hello@inbound.acme.com`.

Emailit invia una richiesta `POST` firmata al tuo endpoint. Il corpo è un array JSON, perché una richiesta può contenere fino a 100 eventi:

```json
[
  {
    "event_id": "evt_2pXb7Lw9QmKc4RtN8yVd3Hs",
    "type": "email.received",
    "data": {
      "object": {
        "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
        "object": "email",
        "from": "ada@example.com",
        "to": "hello@inbound.acme.com",
        "subject": "Question about my order",
        "created_at": "2026-10-01T09:30:12.418Z"
      }
    }
  }
]
```

L’evento contiene mittente, destinatario e oggetto, ma non il corpo. Verifica l’header `X-Emailit-Signature` prima di fidarti della richiesta. Vedi [Firma delle richieste](/it/docs/webhooks/request-signature/).

## Recupera l’email completa

Usa l’`id` dell’evento per recuperare il messaggio con una chiave API **Full Access**:

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

La risposta include gli header analizzati, il corpo in testo e in HTML e gli allegati:

```json
{
  "object": "email",
  "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
  "type": "inbound",
  "from": "ada@example.com",
  "to": "hello@inbound.acme.com",
  "subject": "Question about my order",
  "status": "received",
  "headers": { "...": "..." },
  "body": {
    "text": "Hi, where is my order #1042?",
    "html": "<p>Hi, where is my order #1042?</p>"
  },
  "attachments": []
}
```

Per ottenere invece il messaggio originale, chiama [`GET /emails/{id}/raw`](/it/docs/api-reference/emails/raw/). Il contenuto dei messaggi viene conservato per il periodo di conservazione del tuo piano, quindi recuperalo poco dopo l’arrivo dell’evento. Vedi [Conservazione dei dati](/it/docs/data-retention/).

## Prezzi

Ogni email ricevuta costa 1 credito, come un’email inviata. Vedi [Crediti](/it/docs/billing/credits/).

## Passaggi successivi

  - [Elabora le email in entrata con i webhook](/it/docs/inbound/process-with-webhooks/): Instrada le risposte, analizza gli allegati e associa le conversazioni.
  - [Inoltra con le automazioni](/it/docs/inbound/forward-with-automations/): Inoltra le email ricevute a una casella senza scrivere codice.
  - [Configura le email in entrata](/it/docs/inbound/set-up/): Sottodomini personalizzati e DNS nel dettaglio.
  - [email.received](/it/docs/webhooks/events/email/received/): Il riferimento completo dell’evento.

---
Fonte: https://emailit.com/it/docs/quickstart/inbound/