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.
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
Damit Sie ein funktionsfähiges Beispiel testen können, haben wir Ihnen hier den Quellcode zum Download zur Verfügung gestellt.