Transaktionale E-Mails versenden
Einleitung
Die folgenden Funktionen dienen dem Versand transaktionaler, also ereignisgesteuerter E-Mails – etwa im Zusammenhang mit einer Registrierung, einer Passwortanforderung oder einer Bestellung im Online-Shop. Solche transaktionalen Mails werden individuell an die jeweils hinterlegte Empfängeradresse gesendet.
Die E-Mail muss vom Typ Kampagnen-Mail sein und vor dem Versand über die hier aufgeführten Funktionen aktiviert werden – entweder über die Oberfläche im Reiter Versand oder mit der Funktion ActivateEmail.
Kampagnen-Mails die bereits aktiv waren und anschließend passiert wurden, müssen mit der Funktion ReactiveEmail aktiviert werden.
Funktionen
SendEMailByIDAndRecipient
Sendet eine aktivierte E-Mail vom Typ Kampagnen-Mail an die angegebene Empfänger-E-Mail-Adresse. Der Empfänger muss dafür nicht in MAILINGWORK vorhanden sein.
| Parameter | Beschreibung | Typ |
| username* | Benutzername | string |
| password* | Passwort | string |
| emailId* | ID der Kampagnen-E-Mail | string |
| email* | Empfänger-E-Mail-Adresse | string |
| fields | Dynamische (Feld-)Inhalte | array |
| advanced['attachments'] | Anhang (maximal 3MB) | array |
* Pflicht
Um der E-Mail empfängerspezifische Inhalte hinzuzufügen, kannst du die Feld-Aliasse in den Text schreiben bzw. über die Eingabehilfen hinzufügen.
Fließtext, welcher Platzhalter für Vorname, Nachname und Bestellnummer enthält.
Die Zuweisung beim API-Call erfolgt über den Parameter fields. Dort gibst du den zur Feld-ID korrespondierenden Wert mit.
Beispiel
- $ch = curl_init();
- curl_setopt($ch, CURLOPT_URL, 'https://webservice.sendnode.com/webservice/webservice/json/sendemailbyidandrecipient');
- curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
- curl_setopt($ch, CURLOPT_POST, 1);
- curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(
- array (
- 'username' => '<BENUTZERNAME>',
- 'password' => '<PASSWORT>',
- 'emailId' => 1,
- 'email' => 'max.muster@example.com',
- 'fields' =>
- array (
- // Abonnentenfeld-ID / Wert
- 3 => 'Max',
- 4 => 'Mustermann',
- 4 => '4200375-385902',
- ),
- 'advanced' =>
- array (
- 'attachments' =>
- array (
- 0 =>
- array (
- 'key' => 'Bild1',
- 'content' => 'c29tZSBpbXBvcnRhbnQgZGF0YQ==',
- ),
- 1 =>
- array (
- 'key' => 'Bild2',
- 'content' => 'ZXZlbiBtb3JlIGltcG9ydGFudCBkYXRh',
- ),
- ),
- ),
- )));
- $result = json_decode(curl_exec($ch), true);
- {"error":0,"message":"successfully executed","result":1}
SendEMailByIDAndRecipientAsync
Sendet eine aktivierte E-Mail vom Typ Kampagnen-Mail an eine E-Mail-Adresse. Der Empfänger muss nicht in MAILINGWORK vorhanden sein.
Hinweise zur Funktion:
Die Funktion bietet keine Geschwindigkeitsvorteile mehr gegenüber SendEMailByIDAndRecipient.
Nachteile gegenüber SendEMailByIDAndRecipient:
Es werden keine Statistikdaten wie beispielsweise Öffnungen und Klicks generiert.
Es ist nicht möglich, Anhänge zu versenden.
Diese Funktion wird demnächst entfernt. Bitte verwende SendEMailByIDAndRecipient.
SendEmailByIdAndRecipientId
Sendet eine aktivierte E-Mail vom Typ "Kampagnen-Mail" an einen in Mailigwork vorhandenen Abonnenten.
| Parameter | Beschreibung | Typ |
| username* | Benutzername | string |
| password* | Passwort | string |
| emailId* | ID der Kampagnen-E-Mail | string |
| recipientId* | Empfänger-E-Mail-Adresse | string |
*Pflicht
Beispiel
- $ch = curl_init();
- curl_setopt($ch, CURLOPT_URL, 'https://webservice.sendnode.com/webservice/webservice/json/sendemailbyidandrecipientid');
- curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
- curl_setopt($ch, CURLOPT_POST, 1);
- curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(
- array (
- 'username' => '<BENUTZERNAME>',
- 'password' => '<PASSWORT>',
- 'emailId' => 1,
- 'recipientId' => 54,
- )));
- $result = json_decode(curl_exec($ch), true);