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“
C#
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));