Beschreibung

Eine Transaktionsmail ist eine einzelne E-Mail, die durch Backclick versendet werden soll. Sie ist weder an eine Kampagne, noch an eine Verteilerliste gebunden. Vor dem Versand der E-Mail wird geprüft, ob der angegebene Mandant berechtigt ist, für die Domain der Absenderadresse zu versenden. Ist dies nicht der Fall, dann bekommen Sie eine Fehlermeldung. Eine Transaktionsmail wird weder getrackt, noch werden Veränderungen oder Personalisierungen vorgenommen. Sie müssen den Inhalt der E-Mail also selber vollständig aufbereiten. Backclick nimmt den Auftrag des Versands nur entgegen, generiert und versendet die E-Mail.

Beim Versand der E-Mail haben Sie natürlich alle technischen Vorteile von Backclick, d.h. die E-Mail wird RFC-Konform generiert und wenn DKIM für die Absenderdomain konfiguriert ist, dann wird die E-Mail auch entsprechend signiert.

Um eine Transaktionsmail zu versenden, müssen Sie folgende Parameter angeben:

ID des Mandanten
Betreff der E-Mail
Absenderadresse der E-Mail
Absendername der E-Mail
Inhalt der E-Mail (dabei kann entweder Text oder HTML übergeben werden. Backclick kodiert die E-Mail automatisch im richtigen Format)
Empfänger der E-Mail:
- E-Mail Adresse des Empfängers
- ID des Mandanten
- ID einer Verteilerliste

Optional können Sie auch noch den Alternativtext der E-Mail angeben. Wenn Sie Alternativtext angeben, dann muss der Inhalt "HTML" und der Alternativtext "Text" sein.

Folgende Fehlermeldungen können bei fehlerhaften Requests auftreten:

Invalid domain of sender address ("example.com"). If you want to send email for this domain, please contact your admin. => Die angegebene Absenderdomain darf unter dem Mandanten nicht verwendet werden.

Beispiel

$client = new SoapClient($wsdlUrl);
$request = new StdClass();
$request->mandatorId = 0;
$request->subject = utf8_encode("Betreff der E-Mail");
$request->senderName = utf8_encode("Name des Absenders");
$request->senderEmail = "user@example.com";
$request->newsletterContent = utf8_encode("<html><body>HTML-Inhalt der E-Mail</body></html>");
$request->alternativeContent = utf8_encode("Alternativtext der E-Mail");
$request->subscriber = new StdClass();
$request->subscriber->subscriberEmail = utf8_encode("recipient@example.com");
$request->subscriber->mandatorId = 0;
$request->subscriber->newsletterListIds = array(1);
try {
  $result = $client->transactionMail($request);
  var_dump($result);
} catch (Exception $e) {
  echo "Error: " . $e->getMessage() . "\n";
}

object(stdClass)#2 (1) {
  ["success"]=>
  bool(true)
}

Quellcode

Um ein funktionsfähiges Beispiel testen können, steht hier der Quellcode zum Download zur Verfügung.

Beispiel für den Versand einer Transaktionsmail