Newsletter per SOAP importieren

Wir bieten Ihnen die Möglichkeit, aus Ihrem bestehenden Content Management System, Forum oder zum Beispiel aus Ihrem Board heraus automatisch erstellte Newsletter in unser System zu importieren und anschließend versenden zu lassen. Im Folgenden werden die einzelnen XML Elemente erklärt:

Erklärung der XML-Elemente

XML-Element	Option	Erklärung
group		Gruppennummer, für welche der Import bestimmt ist
format	TEXT	Textformat
	HTML	HTML-Format
rsspublication	Y	News soll im RSS Feed veröffentlicht werden.
	N	News soll nicht im RSS Feed veröffentlicht werden.
senddate	TT.MM.JJJJ	Versanddatum, z.B.
sendtime	HH:MM:SS	Versandzeitpunkt, z.B.
status	CREATED	Status im Workflow ist "Newsletter wird bearbeitet" Der NL wird nicht versendet. Sie müssen diesen noch fertig bearbeiten und manuell einen Versandauftrag anlegen.
	APPROVED	Status im Workflow ist "Newsletter ist erstellt" Der NL wird nicht versendet. Sie müssen noch manuell einen Versandauftrag anlegen.
	TOSEND	Status im Workflow ist: "Versandauftrag angelegt" Nur in diesem Status wird der NL automatisch versendet.
mailpriority	LOW	Priorität der versendeten Mail ist niedrig.
	NORMAL	Priorität der versendeten Mail ist normal.
	HIGH	Priorität der versendeten Mail ist hoch.
title		Betreff der versendeten Mail
campaign_name		Name der Kampagne zu der dieser Newsletter zugeordnet werden soll.
content		Inhalt des Newsletters
attachments		Anhänge (z.B. eingebettetes Bild oder eine PDF Datei)
	location	URL zum Anhang
	location	URL zum Anhang 2

Komplettes XML Beispiel eines Newsletters (Quelltext)

<?xml version="1.0" encoding="UTF-8"?>
<order>
    <group>3422</group>
    <format>TEXT</format>
    <rsspublication>Y</rsspublication>
    <senddate>24.06.2009</senddate>
    <sendtime>13:00:00</sendtime>
    <status>TOSEND</status>
    <mailpriority>NORMAL</mailpriority>
    <title>Aktueller Newsletter #34</title>
    <campaign_name>Standard-Kampagne</campaign_name>
    <content><![CDATA[BeispielFeed newstroll.de
http://www.newstroll.de

+---------------------------------------------------------------------+
Antworten, Kommentare oder Kritik veroeffentlichen Sie bitte
im Forum unter http://www.newstroll.de
+---------------------------------------------------------------------+

Hallo liebe Internetterinnen und Internetter,
sehr geehrte Damen und Herren,

soeben wurde ..........

+---------------------------------------------------------------------+
IMPRESSUM
+---------------------------------------------------------------------+

Copyright 1999-2005 by NEWSTROLL
Redaktion NEWSTROLL

Chefredakteur: Andre Mundo (V.i.S.d.P.)
eMail: info@newstroll.de - Web: http://www.newstroll.de

Copyright-Hinweis: Artikel aus diesem Feed düfen nur unter der
Angabe [Quelle: www.newstroll.de] weiterverwendet werden!

Newsfeed powered by NEWSTROLL - http://www.newstroll.de/
newstroll.de - Newsletterhosting, -Marketing und -Service]]></content>
</order>
<attachments>
    <location>http://www.newstroll.de/Funktionen.pdf</location>
    <location>http://www.newstroll.de/Preise.pdf</location>
</attachments>

Um den Newsletter nun zu importieren, legen Sie die XML Datei auf Ihrem Server ab und nutzen Sie den nachfolgenden PHP Code. Die Variable $xml_uri ist nun die URL zu Ihrer XML-Datei auf Ihrem Server. Bitte stellen Sie sicher, dass diese von außen lesbar ist.

PHP -SOAP Code-Schnipsel zum Import eines Newsletters

<?php
try {
    ini_set("soap.wsdl_cache_enabled", "0");
    $client = new SOAPClient('http://www.newstroll.de/app/ws/2010-02/?wsdl',
        array(
        'login' => '**USERNAME**',
        'password' => '**PASSWORD**','exceptions' => 1)
        );

    $securityToken = '**IHRTOKEN**';

    $xml_uri = 'http://ihredomain.de/newsletter/newsletter.xml';
    echo $client->importNewsletter($securityToken,$xml_uri);

} catch (SOAPFault $f) {
    echo $f->faultstring;
}
?>

Ein auf Ihr System personalisiertes Beispiel finden Sie unter -> Verwaltung -> Integration / Tools -> SOAP

Probleme und Fehlermeldungen

Bei Problemen mit der Schnittstelle wenden Sie sich bitte an unseren Support. Folgende Fehler-Codes gibt unsere SOAP Schnittstelle zurück:

0 - Speicherung nicht möglich. Systemfehler
1 - Erfolgreich importiert
2 - XML Datei nicht gefunden
3 - Gruppe nicht gefunden
4 - Fehlende Authorisierung
5 - Keine Versandzeit angegeben
6 - Kein Betreff angegeben
7 - Kein Inhalt angegeben

Bin echt froh, dass es dieses Feature gibt. Erzeuge so den NL komplett aus meinem CMS heraus und muss mich um den NL so überhaupt nicht mehr kümmern.

Klasse Feature! Spart echt 'ne Menge Zeit.