E-Mail empfangen
Empfangene E-Mails sind unter Email > Emails > Receiving verfügbar, über die Inbound-Messages-API und in email.received-Webhooks. Wählen Sie zwischen zwei Einrichtungsmethoden, je nachdem, unter welcher Adresse Sie E-Mails empfangen möchten.
- Eine Weiterleitungsadresse ist ein Postfach, das wir für Sie generieren, z. B. mfzxq2lom5uxi3lb@eu1.inbound.bird.com (@us1.inbound.bird.com in der US-Region). Keine Domain, kein DNS: Sie richten in einem bestehenden Postfach eine Weiterleitungsregel auf diese Adresse ein, und wir empfangen jede weitergeleitete Nachricht.
- Empfang auf Ihrer eigenen Domain veröffentlicht MX-Einträge für eine Subdomain, die Sie kontrollieren (z. B. inbound.acme.com). Danach wird jede E-Mail an eine beliebige Adresse dieser Subdomain als eingehende Nachricht zugestellt.
Beginnen Sie mit einer Weiterleitungsadresse, wenn Sie den Empfang ausprobieren oder die E-Mails eines bestehenden Support-Postfachs weiterleiten möchten. Richten Sie den Domain-Empfang ein, wenn E-Mails direkt an Ihre eigene Domain adressiert werden sollen.
Weiterleitungsadressen
Wählen Sie unter Email > Domains > Forwarding die Schaltfläche Add forwarding address und geben Sie einen Namen ein, z. B. Support inbox. Wir generieren eine feste, zufällige Adresse. Sie können das Label später umbenennen. Das Löschen einer Weiterleitungsadresse stoppt den Empfang an dieser Adresse, ohne die anderen zu beeinflussen.
Programmatisch erledigt POST /v1/email/inbound-addresses dasselbe (CLI: bird email inbound-addresses create). Die Antwort enthält die generierte address, die id und Ihr Label.
Setzen Sie diese Adresse dann als Weiterleitungsziel dort ein, wo die E-Mail heute liegt: eine Gmail- oder Google-Workspace-Weiterleitungsregel, eine Outlook-Regel oder die Weiterleitungseinstellung Ihres Helpdesks. Wir empfangen alles Weitergeleitete, parsen es und speichern es als eingehende Nachricht.
Empfang auf Ihrer eigenen Domain
Der Domain-Empfang ist eine Funktion einer Versand-Domain. Die Domain muss daher zuerst registriert und DKIM-verifiziert sein. Verwenden Sie eine eigene Subdomain (inbound.acme.com), niemals Ihre Apex-Domain: Der Empfang wird auf der Registrierung der Domain selbst aktiviert, und Apex-MX-Einträge würden Ihre Unternehmens-E-Mails abfangen.
Öffnen Sie Email > Domains und wählen Sie Ihre Domain. Aktivieren Sie unter Receiving (Optional) den Empfang und veröffentlichen Sie die aufgelisteten MX-Einträge. Sie können den Empfang erst aktivieren, wenn DKIM verifiziert ist. Eine Domain, die bereits E-Mails für eine andere Organisation empfängt, ist ebenfalls nicht verfügbar.
Nach der Aktivierung durchläuft der Empfangsstatus denselben Lebenszyklus wie die Versandeinträge: pending, während wir DNS auf die MX-Einträge prüfen, dann verified, sobald sie korrekt aufgelöst werden. Ab diesem Zeitpunkt wird E-Mail an jeden Local-Part der Domain (support@, orders@, beliebig) als eingehende Nachricht zugestellt. Das Deaktivieren des Toggles stoppt die Zustellung eingehender E-Mails. Die MX-Einträge bleiben als Referenz auf der Domain gelistet, mit dem Status pending.
Größe eingehender Nachrichten
Bird unterstützt eingehende Nachrichten bis zu 20 MB einschließlich Anhängen, auf jeder Empfangsdomain in jeder Region. Größere Nachrichten liegen außerhalb des unterstützten Limits, selbst wenn der sendende Server eine SMTP-Bestätigungsantwort erhält. Verlassen Sie sich nicht auf deren Zustellung.
Eine zu große Nachricht kann während der SMTP-Transaktion mit 552 5.3.4 message size limit exceeded abgelehnt werden. Der sendende Server erhält diese Ablehnung und kann seinen Absender benachrichtigen. Bird kürzt eine Nachricht niemals, um ein Größenlimit einzuhalten.
Empfangene E-Mails lesen
Der Tab Receiving listet empfangene Nachrichten mit Absender, Empfänger, Betreff und Empfangszeitpunkt, neueste zuerst. Suchen Sie nach exakter Absenderadresse oder filtern Sie nach Datum. Wählen Sie eine Zeile, um die Ansichten Rendered, Text, Details und Raw zu öffnen. Der Header zeigt die SPF-, DKIM- und DMARC-Ergebnisse, die beim Eingang der Nachricht erfasst wurden.
Empfangene E-Mails werden 30 Tage aufbewahrt.
Dieselben Daten sind über die API verfügbar (CLI: bird email inbound-messages):
- GET /v1/email/inbound-messages listet Nachrichten, filterbar nach Absender, Eingangsadresse und Empfangszeitpunkt.
- GET /v1/email/inbound-messages/{id} gibt die geparsten Metadaten einer Nachricht zurück: Adressierung, Betreff, Threading-Referenzen, Authentifizierungsergebnisse und Anhang-Metadaten.
- GET /v1/email/inbound-messages/{id}/body gibt den HTML- und den Klartext-Body zurück.
- GET /v1/email/inbound-messages/{id}/attachments listet Anhänge; jeder kann einzeln heruntergeladen werden.
- GET /v1/email/inbound-messages/{id}/raw gibt die Originalnachricht exakt wie empfangen im RFC-5322-Format (MIME) zurück.
Auf empfangene E-Mails reagieren: der email.received-Webhook
Um eingehende E-Mails direkt bei Empfang zu verarbeiten (Supportanfragen routen, Antworten einlesen, einen Agenten auslösen), abonnieren Sie einen Webhook-Endpunkt für das email.received-Event. Wir lösen es nach dem Empfang und Parsen jeder Nachricht aus. Der Payload enthält die inbound_message_id, den Absender aus dem From-Header der Nachricht, Empfänger, Betreff und die in_reply_to-Referenz. Außerdem enthält er ein Gesamtergebnis authentication (pass, fail oder unknown) sowie die einzelnen SPF-, DKIM- und DMARC-Ergebnisse; Authentifizierungsergebnisse verwenden erläutert, welche davon aktuell befüllt sind. Diese Informationen ermöglichen Routing und Triage ohne zusätzlichen API-Aufruf. Wenn Sie den Body oder Anhänge benötigen, rufen Sie sie über die Inbound-Messages-API mit der inbound_message_id aus dem Event ab. Die Nachricht wird gespeichert, bevor das Event gesendet wird – die ID ist also auflösbar, sobald das Event bei Ihnen eintrifft: Rufen Sie /raw oder /body direkt aus Ihrem Handler ab, ohne Warten und ohne Polling.
Authentifizierungsergebnisse verwenden
SPF und DKIM werden geprüft, wenn eine Nachricht Bird erreicht. Header, die der Absender hinzufügt, wie z. B. eigene Authentication-Results, ändern diese Ergebnisse nicht.
Die Felder spf_pass und dkim_pass haben jeweils den Wert true, false oder null. null bedeutet, dass kein Ergebnis aufgezeichnet wurde, auch wenn eine Prüfung nicht abgeschlossen werden konnte. Eine bestandene DKIM-Signatur setzt dkim_pass auf „true", selbst wenn eine andere Signatur der Nachricht fehlschlägt. Die Felder geben keine detaillierten Ergebnis-Tokens, Signierdomains oder Selektoren aus.
DMARC-Ergebnisse sind noch nicht verfügbar. Bis dahin sind dmarc_pass und spam_score immer null, und authentication, das dmarc_pass folgt, ist immer unknown. Routen Sie aktuell nicht auf Basis von dmarc_pass === true oder authentication === "pass": Keine Nachricht erfüllt eine der beiden Bedingungen.
Um automatisiertes Routing jetzt abzusichern, fordern Sie dkim_pass === true oder spf_pass === true, und behandeln Sie false, null und fehlende Werte als nicht verifiziert. SPF- und DKIM-Bestätigungen belegen nicht, dass die signierende oder sendende Domain mit der Domain im sichtbaren From-Header übereinstimmt. Nutzen Sie sie, um nicht authentifizierte E-Mails herauszufiltern, nicht als Beweis dafür, wer die Nachricht gesendet hat.
DMARC prüft die Übereinstimmung mit der Domain im From-Header der Nachricht. Das Feld from in email.received enthält diese Header-Adresse, mit dem vom Relay geparsten Absender und dann dem Envelope-Absender als Fallbacks, wenn der Header nicht gelesen werden kann. In email_mailbox.message_received enthält from den Envelope-Absender, der eine andere Bounce-Adresse sein kann. Für Postfach-Routing auf Basis des sichtbaren Absenders rufen Sie die Metadaten der empfangenen Nachricht über die message_id des Events ab. Ein DMARC-Pass authentifiziert eine Domain; er belegt nicht, dass eine bestimmte Person die Nachricht gesendet hat.
Nächste Schritte
- Sende-Domains: Registrieren und verifizieren Sie die Domain, auf der Sie empfangen möchten.
- Webhooks: Endpunkte, Signaturen und Wiederholungsversuche für email.received.
- E-Mail-Protokoll: die Sendeseite der E-Mails-Seite.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.