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 wird eine entsprechende Fehlermeldung erzeugt.
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 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 des 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 kann entweder Text oder HTML ü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
- 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 angegeben werden. Wenn der Alternativtext angegeben wird, dann muss der Inhalt "HTML" und der Alternativtext "Text" sein.
Folgende Fehlermeldungen können bei fehlerhaften Requests auftreten:
Beispiel
$client = new SoapClient($wsdlUrl);
date_default_timezone_set('Europe/Berlin');
$transactionMail = new StdClass();
$transactionMail->mandatorId = 0;
$transactionMail->channelId = 1;
$transactionMail->senderName = 'Name des Absenders';
$transactionMail->senderEmail = '[email protected]';
$transactionMail->replyTo = '[email protected]';
$transactionMail->recipient = new StdClass();
$transactionMail->recipient->emailAddress = '[email protected]';
$transactionMail->recipient->recipientFields = array();
$recipientField = new StdClass();
$recipientField->fieldName = 'VORNAME';
$recipientField->fieldValue = utf8_encode('Max');
array_push($transactionMail->recipient->recipientFields, $recipientField);
$recipientField = new StdClass();
$recipientField->fieldName = 'NACHNAME';
$recipientField->fieldValue = utf8_encode('Mustermann');
array_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->sendTransactionMail($transactionMail);
var_dump($result);
} catch (Exception $e) {
echo "Fehler aufgetreten: " . $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