...

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 Mail wird geprüft, ob Ihr Mandant überhaupt der angegebene Mandant berechtigt ist, für die Domain der Absenderadresse zu versenden darf. Ist dies nicht der Fall, dann bekommen Sie wird eine entsprechende 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-Mailerzeugt.
Für die Transaktionsmails gibt es spezielle Auswertungsbausteine im Reportmanager für Backclick, so dass sowohl die Versendungen als auch die Reaktionen auf Transaktionsmails getrackt und ausgewertet werden können.
Die Transaktionsmails können personalisiert werden (über die normale Personalisierungsvariante, wie sie in Backclick funktioniert) und es ist eine Onlineansicht der Mails verfügbar.

An Transaktionsmails können auch Attachments angehangen werden. Diese müssen als Base64 kodierte Dateien angegeben werden.

Beim Versand der E-Mail haben Sie sind natürlich alle technischen Vorteile von Backclick vorhanden, 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.

Verfügbar ab Backclick-Version: 5.8.4

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

• ID Ihres Mandantendes Mandanten
• API-Key (optionale Authentifizierung, wenn nicht angegeben, dann wird die Authentifizierung über die IP-Adressen vorgenommen)
• Channel-ID (der Channel kann entweder über die Backclick-Oberfläche, oder per SOAP (Transaktions-Channel anlegen) angelegt werden)
• Kampagnen-ID
• Betreff der E-Mail
• Absenderadresse der E-Mail
• Absendername der E-Mail
• Inhalt der E-Mail (dabei können Sie kann entweder Text oder HTML angeben, Backclick erkennt den Inhalt automatischübergeben werden. Backclick kodiert die E-Mail automatisch im richtigen Format. Alternativ kann auch die ID eines Templates angegeben werden)
• Empfänger der E-Mail:
  
  • E-Mail Adresse des Empfängers
  • Persöhnliche Informationen des Empfängers
  • ID Ihres Mandanten
  • ID einer Ihrer Verteilerlisten

...

• Liste, auf welche der Empfänger zusätzlich in Backclick gespeichert werden soll
• Reply-To Adresse
• Liste der Attachments
  • Attachmentname
  • Attachmentdaten
• ID der Gutscheinliste (falls in dem Mailing ein Gutschein eingefügt werden soll, kann hier die ID der Gutscheinliste aus Backclick angegeben werden)

Optional kann auch noch der Alternativtext der E-Mail angebenangegeben werden. Wenn Sie den Inhalt und den Alternativtext angebender Alternativtext angegeben wird, 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.
• No templateId AND no newsletterContent given! => Es ist kein Inhalt für de Transaktionsmail angegeben worden.
• Template with ID N does not exist! => Das Tempalte mit der ID existiert nicht.
• Both (mailContent AND alternativeMailContent is HTML.) => Es ist sowohl im Inhalt, als auch im Alternativtext HTML angegeben worden.
• Both (mailContent AND alternativeMailContent is TEXT.) => Es ist sowohl im Inhalt, als auch im Alternativtext TEXT angegeben worden.
• Both templateId AND newsletterContent given, don't know, what to send. => Der Inhalt sowohl über Text/HTML als auch über eine Tempalte-ID angegeben worden.
• Channel with ID Ihre ID does not exist. => Der angegebene Channel für Transaktionsmails existiert nicht.
• Address was unsubscribed, anti spam option is enabled. => Wenn der Empfänger auf einer Liste gespeichert werden soll, hat als letztes eine Abmeldung stattgefunden. Der Abonnent wird nicht gespeichert.
• Address is at robinson list. => Wenn der Empfänger auf einer Liste gespeichert werden soll, befindet sich dieser auf der Robinsonliste.
• Error creating subscriber. => Es ist ein Fehler beim Anlegen des Abonnenten aufgetreten.
• Sending denied: Recipient address is on one of the black lists.=> Versand der Transaktionsmail wird verweigert, da die Adresse auf einer der Blacklisten ist.

• Error compiling newsletter template Ihre ID => Beim Erzeugen des Inhalts aus dem Tempalte ist ein Fehler aufgetreten.

• Field "fieldName" does not exist in Backclick. => Es ist ein Personalisierungsfeld angegeben, welches nicht in Backclick existiert.
• Error creating transction mail. If this error remains, please contact Backclick support. => Bitte wenden Sie sich an den Support, es ist ein Fehler aufgetreten, der bisher unbekannt ist.
• Got Attachment with no name. => Es wurde kein Name für das Attachment angegeben
• Invalid attachment data for file name "Dateiname des Attachments". => Es sind keine Daten für das Attachment angegeben worden.

Beispiel

$client = new SoapClient($wsdlUrl);
date_default_timezone_set('Europe/Berlin');
$request$transactionMail = new StdClass();
$request$transactionMail->mandatorId = 0;
$request$transactionMail->subject>channelId = utf8_encode("Betreff der E-Mail")1;
$request$transactionMail->senderName = utf8_encode("'Name des Absenders")';
$request$transactionMail->senderEmail = "user@example.com";
$request->newsletterContent = utf8_encode("<html><body>HTML-Inhalt der E-Mail</body></html>");
$request->alternativeContent 'sender@example.net';
$transactionMail->replyTo = 'reply@example.net';
$transactionMail->recipient = new StdClass();
$transactionMail->recipient->emailAddress = 'user@recipient.domain';

$transactionMail->recipient->recipientFields = array();

$recipientField = new StdClass();
$recipientField->fieldName = 'VORNAME';
$recipientField->fieldValue = utf8_encode("Alternativtext der E-Mail");
$request->subscriber'Max');
array_push($transactionMail->recipient->recipientFields, $recipientField);

$recipientField = new StdClass();
$request->subscriber->subscriberEmail$recipientField->fieldName = 'NACHNAME';
$recipientField->fieldValue = utf8_encode("recipient@example.com"'Mustermann');
$request->subscriber->mandatorId = 0;
$request->subscriber->newsletterListIds = array(1array_push($transactionMail->recipient->recipientFields, $recipientField);

$transactionMail->subject = utf8_encode('Transaktionsmail an $$VORNAME$$ $$NACHNAME$$');
$transactionMail->mailContent = utf8_encode('<html><body>Hallo $$VORNAME$$ $$NACHNAME$$</body></html>');
try {
  $result = $client->transactionMail>sendTransactionMail($request$transactionMail);
  var_dump($result);
} catch (Exception $e) {
  echo "ErrorFehler aufgetreten: " . $e->getMessage() . "\n";
}

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

 Quellcode

Damit Sie Um ein funktionsfähiges Beispiel testen können, haben wir Ihnen steht hier den der Quellcode zum Download zur Verfügung gestellt.

Beispiel für den Versand einer Transaktionsmail Transaktionsmail versenden