Transaktionale E-Mails versenden

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.
Info
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.

ParameterBeschreibung
Typ
username*Benutzername
string
password*Passwort
string
emailId*ID der Kampagnen-E-Mail
string
email*Empfänger-E-Mail-Adresse
string
fieldsDynamische (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.

Text-Eingabefeld, welches unterschiedliche Platzhalter enthält.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

Einfacher HTTP-Request mit JSON-Rückgabe
  1. $ch = curl_init();
  2. curl_setopt($ch, CURLOPT_URL, 'https://webservice.sendnode.com/webservice/webservice/json/sendemailbyidandrecipient');
  3. curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  4. curl_setopt($ch, CURLOPT_POST, 1);
  5. curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(
  6. array (
  7.   'username' => '<BENUTZERNAME>',
  8.   'password' => '<PASSWORT>',
  9.   'emailId' => 1,
  10.   'email' => 'max.muster@example.com',
  11.   'fields' => 
  12.   array (
  13.        // Abonnentenfeld-ID / Wert
  14.       3 => 'Max',
  15.       4 => 'Mustermann',
  16.       4 => '4200375-385902',
  17.   ),
  18.   'advanced' => 
  19.   array (
  20.     'attachments' => 
  21.     array (
  22.       0 => 
  23.       array (
  24.         'key' => 'Bild1',
  25.         'content' => 'c29tZSBpbXBvcnRhbnQgZGF0YQ==',
  26.       ),
  27.       1 => 
  28.       array (
  29.         'key' => 'Bild2',
  30.         'content' => 'ZXZlbiBtb3JlIGltcG9ydGFudCBkYXRh',
  31.       ),
  32.     ),
  33.   ),
  34. )));
  35. $result = json_decode(curl_exec($ch), true);
Response
  1. {"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:
  1. Die Funktion bietet keine Geschwindigkeitsvorteile mehr gegenüber SendEMailByIDAndRecipient.
  2. Nachteile gegenüber SendEMailByIDAndRecipient:
    1. Es werden keine Statistikdaten wie beispielsweise Öffnungen und Klicks generiert.
    2. Es ist nicht möglich, Anhänge zu versenden.
Warning
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.

ParameterBeschreibung
Typ
username*Benutzername
string
password*Passwort
string
emailId*ID der Kampagnen-E-Mail
string
recipientId*Empfänger-E-Mail-Adresse
string
*Pflicht

Beispiel

Einfacher HTTP-Request mit JSON-Rückgabe
  1. $ch = curl_init();
  2. curl_setopt($ch, CURLOPT_URL, 'https://webservice.sendnode.com/webservice/webservice/json/sendemailbyidandrecipientid');
  3. curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  4. curl_setopt($ch, CURLOPT_POST, 1);
  5. curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(
  6. array (
  7.   'username' => '<BENUTZERNAME>',
  8.   'password' => '<PASSWORT>',
  9.   'emailId' => 1,
  10.   'recipientId' => 54,
  11. )));
  12. $result = json_decode(curl_exec($ch), true);