Versanddomain hinzufügen

Diese Anleitung führt Sie durch das Hinzufügen einer Versanddomain, das Anlegen ihrer DNS-Einträge und ihre Verifizierung. Sie brauchen dafür ein paar Minuten, plus die Zeit, die Ihr DNS-Anbieter zum Veröffentlichen der Einträge benötigt.

Voraussetzungen

• Sie benötigen Zugriff auf die DNS-Einstellungen der Domain oder eine Person, die ihn hat. Sie können ihr die Einträge per E-Mail senden.
• Entscheiden Sie, von welcher Domain Sie senden. Eine Subdomain wie mail.acme.com hält Ihre Absenderreputation von Ihrer Hauptdomain getrennt. Siehe Hauptdomain oder Subdomain?
• Prüfen Sie, ob Ihr Tarif Platz für eine weitere Domain hat. Siehe Domain-Limits.
• Für die API verwenden Sie einen API-Schlüssel mit Full Access. Reine Sende-Schlüssel können keine Domains verwalten.

Regeln für Domainnamen

• Geben Sie die reine Domain ein: acme.com oder mail.acme.com. Lassen Sie http://, https:// und das Präfix www. weg.
• Verwenden Sie Buchstaben, Ziffern, Bindestriche und Punkte, mit einer Top-Level-Domain aus mindestens zwei Buchstaben. Emailit speichert den Namen in Kleinbuchstaben.
• Subdomains beliebiger Tiefe sind erlaubt, zum Beispiel eu.mail.acme.com. Jede ist eine eigene Domain mit eigenen Einträgen.
• Ein Name kann pro Workspace nur einmal hinzugefügt werden. Ein erneutes Hinzufügen gibt 409 Domain with this name already exists zurück.

Domain hinzufügen

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

Es gibt keinen eigenen Schalter für ausgehende oder eingehende E-Mails. Eine verifizierte Domain kann senden, und sie empfängt eingehende E-Mails, sobald ihr Inbound-MX-Eintrag angelegt ist. Die API akzeptiert die Flags outgoing und incoming aus Kompatibilitätsgründen, sie ändern aber nichts am Verhalten der Domain.

DNS-Einträge anlegen

Legen Sie die Einträge bei dem Unternehmen an, das das DNS Ihrer Domain hostet. Das ist oft Ihr Registrar (GoDaddy, Namecheap) oder ein DNS-Dienst (Cloudflare, Amazon Route 53).

Die meisten DNS-Anbieter erwarten im Host-Feld nur den Teil vor Ihrer Domain (emailit, nicht emailit.acme.com). DNS-Einträge enthält die genauen Werte, Tipps für einzelne Anbieter und häufige Fehler.

Nutzt Ihre Domain Cloudflare-DNS, bietet die Domainseite Set up with Cloudflare an, das die Einträge für Sie erstellt. Siehe DNS mit Cloudflare einrichten.

Einträge an jemand anderen senden

Wenn jemand anderes Ihr DNS verwaltet, senden Sie dieser Person die Einträge per E-Mail aus der Weboberfläche.

1. Domain öffnen. Wählen Sie unter Email API›Domains die Domain aus.

2. Send to email wählen. Die Option steht oben rechts in der Karte DNS Setup.

3. Adresse eingeben. Geben Sie in Recipient Email die Adresse Ihres Entwicklers oder IT-Administrators ein und wählen Sie Send Instructions.

Die Person erhält von Emailit eine E-Mail mit jedem Eintrag und seinem Wert. Bitten Sie sie, Ihnen Bescheid zu geben, wenn die Einträge angelegt sind, damit Sie die Prüfung starten können.

DNS prüfen und verifizieren

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

Die Domain ist verifiziert, wenn SPF, DKIM und Return-Path alle OK zeigen. DMARC, Tracking und Inbound sind optional und beeinflussen die Verifizierung nicht.

Ergebnis prüfen

• Die Domain zeigt unter Email API›Domains den Status Verified, und die Spalten SPF, DKIM und Return Path zeigen OK.
• Senden Sie eine Testnachricht von einer Adresse auf der Domain. Wählen Sie auf der Seite Emails die Option Compose oder rufen Sie E-Mail senden auf.

Zeigt die Domain Pending verification, wartet sie auf eine manuelle Prüfung. Das betrifft Domains bei Pay as you go, die vor weniger als 30 Tagen registriert wurden. Siehe Domain-Verifizierung.

Fehlerbehebung

Domain-Verifizierung behandelt weitere Fälle.

Siehe auch