E-Mails über die LivingAPI versenden

Über die beiden Methoden App.send_mail() und Record.send_mail() können Sie direkt E-Mails versenden.

Wenn Sie aus Ihren LivingApps heraus E-Mail versenden, sind diese immer der jeweiligen LivingApp zugeordnet, und damit unter Versendete E-Mails zu finden. Die trifft auch auf die E-Mails zu, die sie über diese beiden Methoden versenden. Beim Versand über Record.send_mail() wird die versendete E-Mail jedoch auch noch dem Datensatz zugeordnet, für den die E-Mail versendet wurde.

Bei Aufruf dieser Methoden müssen alle Argumente per Keyword übergeben werden. Argumente die E-Mail-Adressen sind unterstützen als Format sowohl eine reine E-Mail-Adresse als auch eine E-Mail-Adresse mit Anzeige-Name, also entweder

name@example.org

oder

Vorname Nachname <name@example.org>

Folgende Argumente werden unterstützt:

from: String oder None

Absender der E-Mail.

Dieses Argument gibt den Absender der E-Mail an. Es enthält die E-Mail-Adresse der Person oder Organisation, die die E-Mail sendet. Dieses Argument zeigt an, wer die Nachricht verfasst hat.

Es wird jedoch nur der Anzeige-Name dieser E-Mail-Adresse verwendet, die E-Mail-Adresse selber ist jedoch immer benachrichtigung@living-apps.de. D.h. wenn Sie hier als Absender-E-Mail-Adresse Vorname Nachname <name@example.org> eingeben, wird die E-Mail von der Absender-E-Mail-Adresse Vorname Nachname <benachrichtigung@living-apps.de> versendet werden. Wird dieser Parameter nicht übergeben (oder None) wird LivingApps-Benachrichtigungssystem <benachrichtigung@living-apps.de> verwendet.

reply_to: String oder None

E-Mail-Adresse für Antworten (falls abweichend).

Dieses Argument gibt die E-Mail-Adresse an, an die Antworten gesendet werden sollen. Dies kann eine andere Adresse als die im from-Argument sein.

Sie können es verwenden, wenn Sie möchten, daß Antworten an eine andere E-Mail-Adresse gesendet werden. (Was normalerweise immer der Fall ist, da die Absender-Adresse ja immer benachrichtigung@living-apps.de ist).

to: String oder None

Hauptempfänger.

Dieses Argument enthält die E-Mail-Adresse(n) der Hauptempfänger der E-Mail. Dies sind die Personen, an die die E-Mail direkt gerichtet ist. Es ist auch möglich mehrere E-Mail-Adressen anzugeben, diese müssen dann durch Kommas getrennt angegeben werden.

Wird None übergeben, so wird die E-Mail nicht versendet.

cc: String oder None

Weitere Empfänger, für alle sichtbar.

Dieses Argument wird verwendet, um andere Personen zu informieren, die die E-Mail erhalten sollen, aber nicht die Hauptempfänger sind. Die im cc-Argument übergebenen Adressen sind für alle Empfänger der E-Mail sichtbar. cc wird häufig genutzt, um Personen in den Verteiler aufzunehmen, die die Information erhalten sollen, ohne direkt involviert zu sein.

Auch hier können möglich mehrere E-Mail-Adressen durch Kommas getrennt übergeben werden.

bcc: String oder None

Weitere Empfänger, für andere unsichtbar.

Dieses Argument erlaubt es, E-Mails an Empfänger zu senden, ohne daß die anderen Empfänger diese Adressen sehen können. Die im bcc-Argument übergebenen E-Mail-Adressen sind für andere Empfänger unsichtbar. Dies ist nützlich, wenn man eine E-Mail an eine große Gruppe senden möchte, ohne daß die E-Mail-Adressen der Empfänger für alle sichtbar sind.

Auch hier können möglich mehrere E-Mail-Adressen durch Kommas getrennt übergeben werden.

subject: String oder None

Der Betreff der E-Mail.

Der Betreff sollte eine kurze Bechreibung oder Zusammenfassung des Inhalts der E-Mail enthalten. Er sollte kurz und prägnant sein, und dem Empfänger eine Vorstellung davon geben, worum es in der E-Mail geht (und dies idealerweise auch noch Wochen oder Monate später).

Ein gut formulierter Betreff hilft, die E-Mail effizient zu organisieren und priorisieren, sowohl für den Absender als auch für den Empfänger.

body_text: String oder None

Der Inhalt der E-Mail als Text.

Diese ist der Hauptteil einer E-Mail, der die eigentliche Nachricht enthält.

Ist dieses Argument nicht angegeben oder None wird eine Text-Version automatisch aus body_html erzeugt.

Sie sollten jedoch bei body_text immer eine Text-Version des Nachrichten-Inhalts übergeben, da die automatisch erzeugte Version möglicherweise nicht optimal formatiert ist, und Empfänger aus Sicherheitsgründen die Anzeige der HTML-Version unterbunden haben.

body_html: String oder None

Der Inhalt der E-Mail als HTML.

Mit der HTML-Version können Sie eine ansprechend formattierte Version der Nachricht erzeugten, und Bilder, Links und andere Design-Elemente verwenden.

body_html sollte dabei eine vollständige HTML-Seite (d.h. inklusive <html>- und <head>-Element) sein. Dies ermöglicht es Ihnen auch CSS-Stylesheets einzubinden.

Um die Darstellung in E-Mail-Programmen zu verbessern und zu verhindern, daß das E-Mail-Programm Ihre CSS-Angaben ignoriert wird vor der Versendung der E-Mail der Inhalt der CSS-Stylesheets in style-Attribute verlagert.

attachments: File oder None

Eine Datei, die zusammen mit der E-Mail gesendet wird.

E-Mail-Anhänge sind ein nützliches Werkzeug, um zusätzliche Informationen, Dokumente und Dateien effizient und direkt zu kommunizieren. Bei größeren Dateien sollten Sie jedoch dem Empfänger besser über ein Anzeige-Template die Möglichkeit geben, diese Datei direkt herunterzuladen.