You are here: Email Marketing / EmailLabs > Triggers > Using the Transactional API Trigger

Using the Transactional API Trigger

Transactional messages result from a significant or unusual event in a customer’s life; e.g., . a purchase, a larger than normal bank deposit, birthday, graduation, marriage, Web site visit, or direct email conversation with a company. Typically, you would send a transactional `(or event-based) message immediately after an event occurs, but you can also sequence them at strategically-timed intervals. Purchase notifications, payment and shipping status, renewal reminders, and special offers are all examples of transactional messaging.

The EmailLabs Transactional API trigger is designed for users who know of a transaction on their Web site. It allows them to specify a recipient of the message, the envelope information, and the message itself and route that information through the EmailLabs transactional processers. By doing this they are taking advantage of EmailLabs’ advanced reporting and deliverability.

  1. Create the trigger stub in EML to hold reporting data.
  2. Follow the normal trigger creation process.
  3. When you come to Select Action, select API fire-trigger method is invoked
  4. Create the default message by using the create message option.  The default message is used if you pass us data that does not contain a message to deploy.  This is useful when you have a standard thank you or welcome message to deploy.
  5. Save the trigger, make note of the trigger ID:

  6. Generate a script to utilize the API call. API call data below:


Activity: FIRE-TRIGGER

Transfers data to EmailLabs to enable a transactional message to be sent from the system.  Must be paired with a trigger stub in the EmailLabs application.  See help manual for full implementation.

 

Functional Description

Trigger_id[required]

Tells the system which trigger stub to use for reporting and default message (if using)

 

Recipients[requiredl]

Comma delimited list of email address to receive email.  Can be one address or many.

 

Recipients_data[optional]

Location of CSV or TXT file with large list of recipients.  Must be in URL format (http://example.com/data.csv)

 

Subject[optional]

Subject of the message if not using the default specified in the user interface.

 

From_email[optional]

From email address to use in the message envelope if not using the default specified in the user interface.

 

From_name[optional]

YYYY-MM-DD - Limits the results to this end date

 

Tracking[optional]

Enabled open and click tracking for the message (if not using the default message specified in the user interface)

 

Message[optional]

URL of location to fetch HTML content or actual raw HTML (URL encoded).

Parameter Req? Type ID

Value

         
Site_ID Yes N/A N/A (Site ID of account)
MLID Yes N/A N/A (Mailing list ID of trigger)
trigger_ID Yes Extra trigger_ID (id of trigger)
recipients No Extra recipients (single or comma delimited list of recipients)
recipient_data No Extra recipient_data (URL location of CSV file with recipients)
subject No Extra subject (Subject Line)
from_email No Extra from_email (From Email Address)
from_name No Extra from_name (From Name)
tracking No Extra tracking on
message content Yes Extra message URL of location to fetch html or full HTML

 

EXAMPLE

 

Type=triggersfdd

Activity = fire-trigger

 

Input=

<DATASET>
     <SITE_ID>123</SITE_ID>

     <MLID>345</MLID>

     <DATA type="extra" id="trigger_id">123</DATA>

     <DATA type="extra" id="recipients">
alice@example.com,bob@example.com</DATA>
     <DATA type="extra" id="recipients_data">
http://example.com/data.csv</DATA>
     <DATA type="extra" id="subject">Subject</DATA>

     <DATA type="extra" id="from_email">
reply@lyris.com</DATA>
     <DATA type="extra" id="from_name">Lyris</DATA>

     <DATA type="extra" id="tracking">on</DATA>

     <DATA type="extra" id="message">
http://example.com/message.html</DATA>
</DATASET>

 

NOTE:  You can utilize the default message in the trigger if you choose.  Simply send only the trigger ID and the recipient information.

NOTE: You can send a single recipient or a comma delimited list of recipients.  You can also send a CSV file of recipients via a web location.

NOTE: You can use personalization inside the message being sent along, simply use the existing mail merge tags or dynamic content.