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:
- 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');
$transactionMail = new StdClass();
$transactionMail->mandatorId = 0;
$transactionMail->channelId = 1;
$transactionMail->senderName = 'Name des Absenders';
$transactionMail->senderEmail = '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('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.