Aggiungi un dominio di invio

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.
• 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?
• Controlla che il tuo piano abbia spazio per un altro dominio. Vedi Limiti dei domini.
• 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

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" }'

{
  "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
    }
  ]
}

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

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

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

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

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.

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.

Risoluzione dei problemi

Verifica del dominio copre altri casi.

Vedi anche