Beschreibung
Diese Funktion bietet die Möglichkeit, den letzten Newsletter einer Verteilerliste an einen beliebigen Empfänger zu versenden, ohne dass der Empfänger dabei im System sein muss. Der Newsletter wird vollständig personalisiert und an die angegebenen Empfänger versendet. Die Anzahl der Empfänger ist dabei nicht limitiert, vermeiden Sie es aber zu viele Empfänger anzugeben, da ansonsten ein Timeout des HTTP-Protokolls auftreten kann.
Verfügbar ab Backclick-Version: 5.8.1
Um die Funktion aufzurufen 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)
- Empfänger des letzten Newsletters, die Empfänger sind ein Array und haben weitere Angaben, die gemacht werden können oder müssen
- E-Mail Adresse
- Verteilerlisten, die ID's der Listen, zu denen der letzte Newsletter versendet werden soll
- Persönliche Daten des Empfängers, diese sind für die Personalisierung des Newsletters erforderlich und werden als Array angegeben optionale Angabe
- Name des Felds
- Wert des Felds
Als Ergebnis bekommen Sie ein Objekt, welches die Information enthält, ob die E-Mails erfolgreich generiert worden sind. Eine fehlerhafte Angabe der Verteilerliste wird dabei nicht als Fehler ausgewertet. Wenn bei dieser Funktion also ein FALSE zurückgegeben wird, dann ist bei der Generierung der E-Mail ein Fehler aufgetreten.
Folgende Fehlermeldungen können bei fehlerhaften Requests auftreten:
- No recipients given. => Sie haben keine Empfänger in dem Request angegeben.
Beispiel
$client = new SoapClient($wsdlUrl);
$sendLastNewsletterRequest = new StdClass();
$sendLastNewsletterRequest->mandatorId = 0;
$sendLastNewsletterRequest->recipients = array();
$recipient = new StdClass();
$recipient->emailAddress = "user@example.com";
$recipient->newsletterListIds = array(1);
$recipient->subscriberFields = array();
$subscriberField = new StdClass();
$subscriberField->fieldName = utf8_encode ("VORNAME");
$subscriberField->fieldValue = utf8_encode ("Marcel");
array_push($recipient->subscriberFields, $subscriberField);
$subscriberField = new StdClass();
$subscriberField->fieldName = utf8_encode ("NACHNAME");
$subscriberField->fieldValue = utf8_encode ("Hartwig");
array_push($recipient->subscriberFields, $subscriberField);
array_push($sendLastNewsletterRequest->recipients, $recipient);
try {
$result = $client->sendLastNewsletter($sendLastNewsletterRequest);
var_dump($result);
} catch (Exception $e) {
echo "Fehler aufgetreten: " . $e->getMessage() . "\r\n";
}
object(stdClass)#6 (1) {
["success"]=>
bool(true)
}
Quellcode
Um ein funktionsfähiges Beispiel testen können, steht hier der Quellcode zum Download zur Verfügung.