CreateSMSCampaign

SMS Kampagne erstellen

Request Parameter: CreateSMSCampaignRequest
Response Parameter: CreateSMSCampaignResponse

Mithilfe dieser Methode können Sie eine neue SMS Kampagne in der eworx Marketing Suite erstellen.

Diese Kampagne könne Sie anschließend in der Methode „Empfänger importieren“ – ImportSubscriber verwenden, um die neu importierten/aktualisierten Empfänger zu beschicken.

Folgende Eigenschaften müssen angegeben werden:

• Name
  • Name der SMS-Kampagne in der eworx Marketing Suite
  • Wird kein Name angegeben, wird ein Fehler vom Typ ArgumentNull erzeugt.
• Sender (maximale Länge 11 Zeichen)
  • Geben Sie hier z.B. die Antwort-Telefonnummer in folgendem Format an: 12387654321
  • Der Sender kann auch Personalisierungsbausteine enthalten.
  • Platzhalter sehen immer wie folgt aus [%InternerNameDesEmpfängerfeldes%] z.B. [%email%].
  • Die internen Namen der Empfängerfelder erhalten Sie über die Methode GetSubscriberFields.
  • Wird die maximale Zeichenlänge überschritten, wird ein Fehler vom Typ ArgumentOutOfRange erzeugt.
  • Wird kein Sender angegeben, wird ein Fehler vom Typ ArgumentNull erzeugt.
• Culture (z.B.: de, en)
• Wird keine Sprache angegeben, wird ein Fehler vom Typ ArgumentNull erzeugt.

Folgende Eigenschaften sind optional:

• Text
  • Die maximale Länge einer SMS Kampagne beträgt 460 Zeichen, wobei hier folgendes zu beachten ist:
  • Ab einer Zeichenanzahl von mehr als 160 Zeichen wird die Kampagne auf zwei SMS aufgeteilt.
  • Ab einer Zeichenanzahl von mehr als 306 Zeichen wird die Kampagne auf drei SMS aufgeteilt.
  • Wird die Zeichenlänge von 460 überschritten, wird ein Fehler vom Typ ArgumentOutOfRange erzeugt.
  • Die erlaubten Zeichen für eine SMS können Sie hier nachlesen.
    • Zeichen aus dem „Basiszeichensatz“ gelten als ein Zeichen
    • Zeichen aus der „Standardzeichensatzerweiterung“ als zwei Zeichen
  • Der Text Ihrer SMS Kampagne kann Personalisierungsbausteine enthalten
    • Platzhalter sehen immer wie folgt aus z.B. [%vorname%]
    • Die internen Namen der Empfängerfelder erhalten Sie über die Methode GetSubscriberFields
      
• ProfileId
  • Die ID der zu beschickenden Zielgruppe
  • Wird kein Wert übermittelt, wird standardmäßig die Gruppe „Alle Empfänger“ ausgewählt
• SendType
  • Manuell
  • Ereignisabhängig
  • Wird ein nicht vorhandener Typ ausgewählt, wird ein Fehler vom Typ NotSupported erzeugt.
• Created
  • Das Erstellungsdatum der Kampagne

Das Response Objekt beinhaltet die Guid (eine eindeutige ID in der eworx Marketing Suite) der Kampagne, die angelegt wurde.

Beispiel Request „SMS Kampagne erstellen“

MailworxWebServiceAgent agent = new MailworxWebServiceAgent();
CreateSMSCampaignRequest request = new CreateSMSCampaignRequest();
 
SMSCampaign smsCampaign = new SMSCampaign();
smsCampaign.Name = "Meine erste SMS Kampagne";

// The sender of the SMS campaign can also be a telephone number or a personalization element (see the comments below).
// smsCamapign.Sender = "0501212200";
// smsCamapign.Sender = "[% lastname%]"
smsCampaign.Sender = "mlwrx Crew";

smsCampaign.SendType = CampaignSendType.Manual;

// Personalisation elements are allowed in the SMS text (see the comment below).
// smsCampaign.Text = " [%mwr:briefanrede%], \r\n Erstellen Sie eine neue SMS Kampagne spielend leicht über die mailworx SOAP Schnittstelle!"; 
smsCampaign.Text = "Erstellen Sie eine neue SMS Kampagne spielend leicht über die mailworx SOAP Schnittstelle!";

smsCampaign.Culture = "de";
 
request.SMSCampaign = smsCampaign;
request.Language = "DE";
request.SecurityContext = GetSecurityContext();
 
Console.WriteLine("=== CREATING SMS CAMPAIGN ===");
 
CreateSMSCampaignResponse response = agent.CreateSMSCampaign(request);
Console.WriteLine("=== END OF CREATE CAMPAIGN ===");
Console.WriteLine(String.Format("The Id of the created SMS campaign: {0}", response.Guid));