Eingehende E-Mails einrichten

Diese Anleitung verbindet eine Subdomain Ihrer Domain mit Emailit, damit sie E-Mails empfangen kann. Dafür ist ein einziger DNS-Eintrag nötig, und an der Zustellung von E-Mails an Ihre Hauptdomain ändert sich nichts.

Voraussetzungen

• Eine verifizierte Versanddomain in Ihrem Workspace, zum Beispiel acme.com. Eingehende E-Mails funktionieren nur mit verifizierten Domains. Wenn Sie noch keine hinzugefügt haben, folgen Sie Versanddomain hinzufügen.
• Zugriff auf die DNS-Einstellungen dieser Domain.
• Verfügbare Credits. Jede empfangene Nachricht kostet 1 Credit.
• Domains werden mit aktiviertem Empfang angelegt (das Feld incoming ist standardmäßig true). Lassen Sie das so; in der Weboberfläche gibt es dafür keinen Schalter.

Inbound-Subdomain wählen

Emailit nimmt E-Mails für eine Subdomain pro Domain an. Standardmäßig ist das inbound, die Adressen sehen also aus wie anything@inbound.acme.com. Den aktuellen Wert sehen Sie auf der Domainseite unter Custom Subdomains > Inbound Subdomain. Das Feld ist in der Weboberfläche schreibgeschützt.

Um eine andere Subdomain zu verwenden, setzen Sie inbound_key mit Domain aktualisieren. Der Wert darf Kleinbuchstaben, Ziffern und Bindestriche enthalten, 1 bis 63 Zeichen lang sein und nicht mit einem Bindestrich beginnen oder enden.

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

Mit "inbound_key": "mail" werden die Adressen zu anything@mail.acme.com, und der MX-Eintrag wandert nach mail.acme.com. Wenn Sie den Schlüssel ändern, wird der Status des Inbound-Eintrags auf ausstehend zurückgesetzt, und E-Mails an die alte Subdomain werden nicht mehr angenommen. Setzen Sie inbound_key auf null, um zu inbound zurückzukehren.

MX-Eintrag hinzufügen

1. Domain öffnen. Öffnen Sie in der Weboberfläche Email API›Domains, wählen Sie Ihre Domain und öffnen Sie den Tab DNS Setup.

2. Inbound-Eintrag finden. Es ist der optionale MX-Eintrag mit dem Namen inbound (oder Ihrer eigenen Subdomain) und dem Wert inbound.emailitmail.com. Nutzen Sie die Kopierschaltflächen, um Tippfehler zu vermeiden.

3. Eintrag bei Ihrem DNS-Anbieter anlegen. Legen Sie einen neuen Eintrag mit diesen Werten an:

   Feld	Wert
   Typ	MX
   Name / Host	inbound (manche Anbieter erwarten den vollständigen Namen, inbound.acme.com)
   Mailserver / Wert	inbound.emailitmail.com
   Priorität	10
   TTL	Auto oder der Standardwert Ihres Anbieters

   Ändern Sie nicht die MX-Einträge der Hauptdomain (acme.com). Sie leiten Ihre normalen E-Mails weiterhin an Ihren Postfachanbieter.

   Wenn Ihre Domain die DNS-Einrichtung per Klick mit Cloudflare nutzt, können Sie im Einrichtungsdialog den Eintrag Inbound auswählen, statt ihn von Hand hinzuzufügen.

4. DNS prüfen. Wählen Sie auf der Domainseite Check DNS. Der Inbound-Eintrag zeigt OK, wenn ein MX-Eintrag mit Priorität 10 auf inbound.emailitmail.com zeigt. Die meisten Anbieter veröffentlichen Einträge innerhalb von Minuten, es kann aber bis zu 48 Stunden dauern.

   Sie können das auch im Terminal prüfen:

   Terminal

   dig MX inbound.acme.com +short
   # 10 inbound.emailitmail.com.

Testnachricht senden

Senden Sie von einem beliebigen privaten Postfach eine E-Mail an eine Adresse auf der Subdomain, zum Beispiel test@inbound.acme.com.

Ergebnis prüfen

• Weboberfläche: Öffnen Sie Email API›Emails und dort den Tab Incoming. Die Nachricht erscheint innerhalb von Sekunden mit dem Status Received. Öffnen Sie sie, um Header, Inhalt und Anhänge zu sehen.

• Events: Email API›Events zeigt ein Event email.received. Sein Payload enthält die E-Mail-ID.

• API: Listen Sie eingehende Nachrichten mit E-Mails auflisten auf:

  Terminal

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

Als Nächstes verarbeiten Sie empfangene E-Mails mit einem Webhook oder leiten sie mit einer Automatisierung weiter.

Fehlerbehebung

Siehe auch