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 Ihr Mandant überhaupt für die Domain der Absenderadresse versenden darf. 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 Ihres Mandanten
- Betreff der E-Mail
- Absenderadresse der E-Mail
- Absendername der E-Mail
- Inhalt der E-Mail (dabei können Sie entweder Text oder HTML angeben, Backclick erkennt den Inhalt automatisch)
- Empfänger der E-Mail:
- E-Mail Adresse des Empfängers
- ID Ihres Mandanten
- ID einer Ihrer Verteilerlisten
Optionional können Sie auch den Alternativtext der E-Mail angeben. Wenn Sie den Inhalt und den Alternativtext angeben, dann muss der Inhalt "HTML" und der Alternativtext "Text" sein.
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.
Beispiel für den Versand einer TransaktionsmailTransaktionsmail versenden