Configura le email in entrata

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 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.
• 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. 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.

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, 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:

   Terminal

   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:

  Terminal

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

Poi elabora la posta ricevuta con un webhook o inoltrala con un’automazione.

Risoluzione dei problemi

Vedi anche