Ricevi la prima email in entrata

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.
• 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 o aggiorni 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:

[
  {
    "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.

Recupera l’email completa

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

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:

{
  "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. 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.

Prezzi

Ogni email ricevuta costa 1 credito, come un’email inviata. Vedi Crediti.

Passaggi successivi