SendTriggerMailAction

SendTriggerMailAction übergeben

Mit der SendTriggerMailAction kann der Versand individualisierter Trigger-Mails an die übermittelten Empfänger angestoßen werden.

Eigenschaften:

ExecuteWith
Gibt an, ob die Aktion für neue, aktualisierte oder alle importierten Abonnenten ausgeführt werden soll.
Typ der Eigenschaft: ExecuteWith

CampaignId
Die Id der zu versendenden E-Mail Kampagne. Diese Kampagne muss ereignisabhängig sein und den Typ „Individualisierte Inhalte“ aufweisen.
Typ der Eigenschaft: GUID

ConsiderDOIStatus
Gibt an, ob der Double-Opt-In Status beim Versand berücksichtigt werden soll. Ist diese Eigenschaft auf TRUE, dann werden nur Empfänger mit den Werten „Extern dokumentiert“ und „Double-Opt-In bestätigt“ beschickt. Alle anderen werden ausgeschlossen und scheinen im SendTriggerMailsResponse unter Errors auf. Ist die Eigenschaft FALSE, dann wird der Double-Opt-In Status nicht berücksichtigt und alle Abonnenten beschickt. Wird kein Wert angegeben, so wird standardmäßig FALSE verwendet.
Typ der Eigenschaft: BOOL

ConsiderSubscriberExclusionCriterias
Gibt an, ob die Ausschlusskriterien beim Versand berücksichtigt werden sollen. Ist diese Eigenschaft auf TRUE, dann werden abgemeldete und deaktivierte Empfänger sowie Abonnenten auf der Blacklist oder Robinsonliste vom Versand ausgeschlossen. Diese Empfänger scheinen dann im SendTriggerMailsResponse unter Errors auf. Ist die Eigenschaft auf FALSE, dann werden keinerlei Ausschlusskriterien geprüft und keine Empfänger vom Versand ausgeschlossen. Wird kein Wert angegeben, so wird standardmäßig FALSE verwendet.
Typ der Eigenschaft: BOOL

IgnoreCulture
Gibt an, ob Empfänger mit anderer Sprache beschickt werden sollen. Ist diese Eigenschaft auf TRUE gesetzt, dann werden alle Abonnenten beschickt, auch wenn sie nicht die gleiche Sprache wie die E-Mail Kampagne haben (zB wenn deutschsprachige Empfänger auch eine englische E-Mail Kampagne erhalten sollen). Wird die Eigenschaft auf FALSE gesetzt, dann werden nur Empfänger mit derselben Sprache wie die E-Mail Kampagne beschickt. Abonnenten mit einer anderen Sprache werden ausgeschlossen und scheinen im SendTriggerMails-Response unter Errors auf. Wird kein Wert angegeben, so wird standardmäßig TRUE verwendet.
Typ der Eigenschaft: BOOL

TimeToSend
Gibt den Versandzeitpunkt für das Triggermail an. Wird dieser Wert nicht gesetzt, so wird die Triggermail sofort gesendet.
Typ der Eigenschaft: DATE

TriggerMailData
Typ der Eigenschaft: Liste von ImportTriggerMailData

UseIRated
Gibt an, ob die Kampagne mit der iRated-Technologie gesendet werden soll.
Typ der Eigenschaft: BOOL

UseRTR
Gibt an, ob Empfänger, die auf der österreichischen ECG Liste stehen, vom Versand ausgeschlossen werden sollen. Wenn diese Eigenschaft auf TRUE ist, dann werden die Abonnenten der österreichischen ECG Liste vom Versand ausgeschlossen und scheinen im SendTriggerMailsResponse unter Errors auf. Wenn diese Eigenschaft auf FALSE ist, dann erfolgt kein Abgleich mit der österreichischen ECG Liste und es werden alle Empfänger beschickt. Wird kein Wert angegeben, so wird standardmäßig FALSE verwendet.
Typ der Eigenschaft: BOOL

Beispiel

JSON

//https://sys.mailworx.info/Services/JSON/ServiceAgent.svc/ImportSubscribers
{
  "request": {
    "Language": "DE",
    "SecurityContext": {..},
    "Subscribers": [..],
    "DuplicateCriteria": "email",

    "AfterImportActions": [{
      "__type": "SendTriggerMailAction:#Eworx.Mailworx.ServiceInterfaces.Subscribers.SubscriberImport",
      "ExecuteWith": 3,
      "CampaignId": "...",
      "UseIRated": false,
      "IgnoreCulture": false,
      "UseRTR": true,
      "ConsiderSubscriberExclusionCriterias": true,
      "ConsiderDOIStatus": true,
      "TimeToSend": "/Date(1704106800000+0100)/",
      "TriggerMailData": [..]
    }]
  }
}

XML

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
               xmlns:ser="http://www.mailworx.at/interfaces/serviceagent/"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Header/>
  <soap:Body>
    <ser:ImportSubscribers>
      <ser:request>
        <ser:Language>DE</ser:Language>
        <ser:SecurityContext>...</ser:SecurityContext>
        <ser:Subscribers>...</ser:Subscribers>
        <ser:DuplicateCriteria>email</ser:DuplicateCriteria>

        <ser:AfterImportActions>
          <ser:AfterImportAction xsi:type="ser:SendTriggerMailAction">
            <ser:ExecuteWith>Insert Update</ser:ExecuteWith>
            <ser:CampaignId>...</ser:CampaignId>
            <ser:UseIRated>false</ser:UseIRated>
            <ser:IgnoreCulture>false</ser:IgnoreCulture>
            <ser:UseRTR>true</ser:UseRTR>
            <ser:ConsiderSubscriberExclusionCriterias>true</ser:ConsiderSubscriberExclusionCriterias>
            <ser:ConsiderDOIStatus>true</ser:ConsiderDOIStatus>
            <ser:TimeToSend>2024-01-01T12:00:00</ser:TimeToSend>
            <ser:TriggerMailData>..</ser:TriggerMailData>
          </ser:AfterImportAction>
        </ser:AfterImportActions>
      </ser:request>
    </ser:ImportSubscribers>
  </soap:Body>
</soap:Envelope>