# Header und Metadaten > Ergänzen Sie API-Versände um eigene E-Mail-Header und List-Unsubscribe, sehen Sie, welche Header Emailit hinzufügt oder umschreibt, und hängen Sie Metadaten an, die in Webhooks zurückkommen. Diese Seite beschreibt zwei Wege, einer per E-Mail-API gesendeten E-Mail eigene Informationen hinzuzufügen: `headers`, die Teil der Nachricht werden, die der Empfänger erhält, und `meta`, das Emailit mit der E-Mail speichert und in der API und in Webhooks zurückgibt. Sie listet außerdem die Header auf, die Emailit hinzufügt, umschreibt oder entfernt. ## Eigene Header hinzufügen Übergeben Sie `headers` als Objekt aus Header-Namen und String-Werten: ```json { "from": "Acme ", "to": "ada@example.com", "subject": "Receipt for order 1042", "text": "Thanks for your order.", "headers": { "X-Entity-Ref-ID": "order-1042", "X-Acme-Account": "881" } } ``` - Verwenden Sie für From, To, Cc, Bcc, Reply-To und Subject die Felder der Anfrage, nicht `headers`. - Setzen Sie keine Header, deren Namen mit `X-Emailit-` beginnen. Emailit verwendet sie intern. Eine Nachricht, die bereits `X-Emailit-ID` enthält, gilt zum Beispiel als verarbeitet und überspringt das Umschreiben der Header und die DKIM-Signatur durch Emailit. - Header, die Emailit selbst setzt, etwa `Message-ID` und `Date`, werden ersetzt, auch wenn Sie sie mitsenden. Siehe nächster Abschnitt. ## Header, die Emailit hinzufügt oder ändert | Header | Was Emailit tut | | --- | --- | | `Message-ID` | Setzt ihn auf ``, denselben Wert wie `message_id` in der Antwort auf den Versand. Eine von Ihnen angegebene `Message-ID` wird ersetzt. | | `Date` | Setzt ihn, wenn Emailit die Nachricht zum ersten Mal für die Zustellung verarbeitet. | | `Subject` | Schreibt den endgültigen Betreff und kodiert Nicht-ASCII-Zeichen. | | `Return-Path` | Setzt eine Bounce-Adresse auf Ihrer Return-Path-Subdomain `emailit.`, damit Bounces zu Emailit zurückkommen und SPF aligned ist. | | `DKIM-Signature` | Signiert die Nachricht mit dem DKIM-Schlüssel Ihrer Domain. Für Feedback-Loops zu Beschwerden kann eine zweite Signatur für `emailitmail.com` hinzukommen. | | `Received` | Fügt Trace-Header für die API und den Mailserver von Emailit hinzu. | | `X-Emailit-ID` | Fügt das Token der E-Mail hinzu. | | `Feedback-ID` | Fügt eine Kennung hinzu, die Postfachanbieter in Beschwerdeberichten verwenden. | | `X-Emailit-Meta` | Fügt Ihre `meta`-Werte Base64-kodiert hinzu, wenn Sie `meta` senden. | | `X-Emailit-Tracking` | Fügt die angeforderten Einstellungen hinzu, wenn Sie das Tracking mit `tracking` aktivieren. | | `Bcc` | Entfernt ihn, damit BCC-Empfänger verborgen bleiben. | | `Reply-To` | Entfernt ihn, wenn er dieselbe Adresse wie From nennt. | | `Content-Disposition` | Entfernt ihn auf der obersten Ebene der Nachricht. Anhangsteile behalten ihren. | Das [SMTP-Relay](/de/docs/smtp/headers/) schreibt Nachrichten, die Sie per SMTP einliefern, auf dieselbe Weise um. ## List-Unsubscribe zu Massen-E-Mails hinzufügen Postfachanbieter wie Gmail und Yahoo erwarten bei Werbe- und anderen Massen-E-Mails eine Abmeldung mit einem Klick. [Kampagnen](/de/docs/campaigns/) fügen sie automatisch hinzu. Für Newsletter oder Digests, die Sie per API senden, fügen Sie beide Header selbst hinzu: ```json { "from": "Acme ", "to": "ada@example.com", "subject": "Acme weekly digest", "html": "

This week at Acme…

", "headers": { "List-Unsubscribe": ", ", "List-Unsubscribe-Post": "List-Unsubscribe=One-Click" } } ``` - Die `https`-URL muss eine `POST`-Anfrage mit dem Body `List-Unsubscribe=One-Click` annehmen und die Person ohne Bestätigung abmelden (RFC 8058). - Machen Sie jede URL empfängerspezifisch, damit Ihr Endpunkt weiß, wen er abmelden soll. - Emailit nimmt `List-Unsubscribe` und `List-Unsubscribe-Post` in die DKIM-Signatur auf, was Anbieter für die Abmeldung mit einem Klick verlangen. Die übrigen Anforderungen finden Sie unter [Wie erfülle ich die Anforderungen von Gmail und Yahoo an Massenversender?](/de/docs/kb/gmail-yahoo-bulk-sender-requirements/). Wenn sich jemand abmeldet, senden Sie dieser Person nichts mehr. Sie können sie auf Ihre [Sperrliste](/de/docs/suppressions/) setzen, damit Emailit künftige Versände blockiert. ## Metadaten anhängen `meta` ist ein Objekt aus String-Schlüsseln und String-Werten, das Emailit mit jeder E-Mail speichert. Verknüpfen Sie damit eine E-Mail mit Datensätzen in Ihrem eigenen System. ```json { "from": "Acme ", "to": "ada@example.com", "subject": "Receipt for order 1042", "text": "Thanks for your order.", "meta": { "order_id": "1042", "customer_id": "cus_881", "kind": "receipt" } } ``` Wandeln Sie Zahlen und Boolesche Werte vor dem Senden in Strings um. Emailit gibt `meta` zurück: - In [E-Mail abrufen](/de/docs/api-reference/emails/get/), [Metadaten abrufen](/de/docs/api-reference/emails/meta/) und [E-Mails auflisten](/de/docs/api-reference/emails/list/). - In Webhook-Events zur E-Mail: unter `data.object.meta` bei `email.accepted`, `email.scheduled`, `email.canceled` und den Zustell-Events sowie unter `data.object.email.meta` bei `email.loaded` und `email.clicked`. Ein Zustell-Event mit Metadaten sieht so aus (gekürzt): ```json [ { "type": "email.delivered", "data": { "object": { "id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa", "object": "email", "to": "ada@example.com", "subject": "Receipt for order 1042", "status": "delivered", "meta": { "order_id": "1042", "customer_id": "cus_881", "kind": "receipt" } } } } ] ``` Beim [erneuten Senden](/de/docs/email-api/retry-and-forward/) einer E-Mail bleiben ihre Metadaten erhalten. Eine Weiterleitung erstellt eine neue E-Mail ohne sie. > **Metadaten reisen mit der Nachricht:** Emailit schreibt `meta` außerdem als Base64-kodierten Header `X-Emailit-Meta` in die Nachricht. Wer die Rohnachricht ansieht, kann ihn also dekodieren. Legen Sie keine Secrets, Tokens oder sensiblen personenbezogenen Daten in `meta` ab. ## E-Mails später wiederfinden Sie können E-Mails nicht nach `meta` durchsuchen oder filtern. So finden Sie eine E-Mail wieder: - **IDs speichern.** Speichern Sie die `id` oder bei mehreren Empfängern die Zuordnung `ids` neben Ihrem eigenen Datensatz und rufen Sie die E-Mail mit [E-Mail abrufen](/de/docs/api-reference/emails/get/) ab. - **Liste filtern.** [E-Mails auflisten](/de/docs/api-reference/emails/list/) filtert nach `to`, `from`, `subject`, `status`, `created_at`, `updated_at`, `spam_score`, `api_key_id` und `sending_domain_id`. Siehe [Filtern und Sortieren](/de/docs/api-reference/filtering/). - **Separate API-Schlüssel verwenden.** Geben Sie jeder Anwendung oder Funktion ihren eigenen [API-Schlüssel](/de/docs/developers/api-keys/) und filtern Sie dann nach `api_key_id` oder unter **Email API → Emails** nach **API key**. - **Webhook-Events zuordnen.** Lesen Sie `meta` aus jedem Event, um es beim Eintreffen dem richtigen Datensatz zuzuordnen. ## Siehe auch - [E-Mail senden](/de/docs/email-api/send-email/) - [SMTP-Header](/de/docs/smtp/headers/) - [Webhook-Event-Typen](/de/docs/webhooks/event-types/) - [Lexikon der E-Mail-Header](/de/docs/dictionary/email-headers/) --- Quelle: https://emailit.com/de/docs/email-api/headers-and-metadata/