sendMail(
subject: "Hello world!",
to: "Mr. Foobar <foo@bar.com>",
body: {{{
<h1>Hello {$receiver}<h1>
<p>...</p>
}}},
attachments: [
binary(...),
{
"cid": "attachment1",
"data": binary(...)
}
],
cc: ["info@foo.com", "bar@foo.com"],
bcc: "hidden@foobar.com"
)
Verschickt eine E-Mail mit den angegebenen Parametern. Damit diese Funktion genutzt werden kann, muss der E-Mail-Versand in der Applikation aktiviert sein.
| Name | Typ | Beschreibung | Pflicht | Default |
|---|---|---|---|---|
subject |
Zeichenkette | Der Betreff der E-Mail | ja | |
to |
Zeichenkette/List von Zeichenketten | Der oder die Empfänger der E-Mail. Bei einer Massen-E-Mail sollte aus Gründen des Datenschutzes immer nur ein einzelner Empfänger angegeben werden und die Funktion für alle Empfänger einzeln aufgerufen werden. | ja | |
body |
Zeichenkette/HTML/Binärdaten | Der Inhalt der E-Mail. | ja | |
attachments |
Liste von Binärdaten oder Beschreibungen von Anhängen (siehe unten) | Zusätzliche Inhalte die in der E-Mail mitversendet werden. | nein | [] |
cc |
Zeichenkette/List von Zeichenketten | Liste von Emfängern, die eine Kopie der E-Mail erhalten sollen | nein | [] |
bcc |
Zeichenkette/List von Zeichenketten | Liste von Emfängern, die eine Kopie der E-Mail erhalten sollen, ohne dass die anderen Empfänger ihre E-Mail-Adressen zu sehen bekommen. | nein | [] |
Typ: Wahrheitswert
Ob der E-Mail-Versand erfolgreich war.
Als Anhang kann entweder direkt ein Binärwert übergeben werden, oder ein JSON-Objekt, welches den Anhang näher beschreibt:
{
"filename": "policies.pdf",
"disposition": "attachment",
"description": "Some attachment.",
"cid": "id1",
"headers": {
"key": "value"
},
"data": $binaryData
}
Die Attribute der Beschreibung des Anhangs haben dabei die folgende Bedeutung:
"filename": Der Dateiname für den Anhang, wie er in dem E-Mail-Programm des Empfängers angezeigt werden soll. Beim Speichern des Anhangs wird dieser Dateiname dem Nutzer vorgeschlagen."disposition": "inline" oder "attachment". Bei der Angabe "inline" wird der Anhang vor dem Empfänger versteckt. Das ist sinnvoll, wenn beispielsweise ein Bild mitgeschickt wird, das in den Inhalt der E-Mail eingebettet wird. Siehe "cid"."description": Eine optionale Beschreibung des Anhangs."cid": Die Content-ID des Anhangs. Über diese ID kann beispielsweise ein angehängtes Bild in eine HTML-E-Mail eingebettet werden. Wenn als "cid" der Wert "id1" angegeben wurde, kann dieser Anhang beispielsweise über <img src="cid:id1"/> aus dem HTML-Inhalt der E-Mail referenziert werden."headers": Weitere optionale Header-Informationen, die an dem Anhang gesetzt werden."data": Der eigentliche Inhalt des Anhangs. Der Inhalt kann wie der Inhalt der E-Mail entweder eine Zeichenkette, HTML, oder Binärdaten sein.