Transactional Emails
General Information
For transactional emails, you can either use the default Adobe Commerce emails or choose a prepared message from the integrated Mapp Engage system.
Mapp Connect does not support order state updates in the transactional Related Data table. To use order states in the message sendout, prepare an email message template that uses the state value email parameter. For more information, see Mapp Engage Functions.
Procedure
- Go to Stores > Mapp Connect > Messages to see a list of all Adobe Commerce transactional emails.
In the General section, enable emails via Mapp.
- For each Email message that you want to send from Mapp Engage, uncheck the Use system value checkbox. If checked, this will override the settings for this message and send the Adobe Commerce Default message.
Select an Email Template for each event. Examples:
Sends prepared email messages from Engage:
- Sends default messages from Adobe Commerce:
- Click Save Config.
Placeholders
Below are the placeholders for creating Mapp Engage email templates (Prepared Messages).
Placeholders for email templates
sales_email_order_template
• parameter.billing_address
• parameter.email_order_note
• parameter.order_id
• parameter.order_items_grid
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_message
In <%/ForEach%> loop:
- timestamp
- currency
- productSKU
- productName
- productPrice
- productQuantity
- imageURL
- productURL
- category
sales_email_order_guest_template
• parameter.billing_address
• parameter.email_order_note
• parameter.guest_customer_name
• parameter.order_created_at_datetime
• parameter.order_id
• parameter.order_items_grid
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_message
In <%/ForEach%> loop:
- timestamp
- currency
- productSKU
- productName
- productPrice
- productQuantity
- imageURL
- productURL
- category
sales_email_order_comment_template
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status
sales_email_order_comment_guest_template
• parameter.guest_customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status
sales_email_invoice_template
• parameter.billing_address
• parameter.customer_account_url
• parameter.customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.invoice_items_grid
• parameter.order_id
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_description
sales_email_invoice_guest_template
• parameter.billing_address
• parameter.guest_customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.invoice_items_grid
• parameter.order_id
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_description
sales_email_invoice_comment_template
• parameter.customer_account_url
• parameter.customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.order_id
• parameter.order_status
sales_email_invoice_comment_template
• parameter.guest_customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.order_id
• parameter.order_status
sales_email_shipment_comment_template
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status
• parameter.shipment_id
sales_email_invoice_comment_guest_template
• parameter.guest_customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.order_id
• parameter.order_status
sales_email_shipment_comment_template
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status
• parameter.shipment_id
sales_email_shipment_comment_guest_template
• parameter.guest_customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status
• parameter.shipment_id
sales_email_creditmemo_template
• parameter.billing_address
• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.credit_memo_items_grid
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_id
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_description
sales_email_creditmemo_guest_template
• parameter.billing_address
• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.credit_memo_items_grid
• parameter.guest_customer_name_billing
• parameter.order_id
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_description
sales_email_creditmemo_comment_template
• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_id
• parameter.order_status
sales_email_creditmemo_comment_guest_template
• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.guest_customer_name
• parameter.order_id
• parameter.order_status
customer_create_account_email_template
• parameter.customer_account_url
• parameter.customer_email
• parameter.customer_name
customer_create_account_email_no_password_template
• parameter.customer_account_url
• parameter.customer_email
• parameter.customer_name
customer_create_account_email_confirmation_template
• parameter.account_confirmation_url
• parameter.customer_account_url
• parameter.customer_email
• parameter.customer_name
customer_create_account_email_confirmed_template
• parameter.customer_account_url
• parameter.customer_email
• parameter.customer_name
customer_password_forgot_email_template
• parameter.customer_name
• parameter.reset_password_url
customer_password_remind_email_template
• parameter.customer_account_url
• parameter.customer_name
customer_account_information_change_email_template
• parameter.product_name
• parameter.recipient_email_address
• parameter.recipient_name
• parameter.sender_custom_message
• parameter.sender_email
• parameter.sender_name
• parameter.url_for_product
• parameter.url_for_product_small_image_75_px
customer_account_information_change_email_and_password_template
• parameter.product_name
• parameter.recipient_email_address
• parameter.recipient_name
• parameter.sender_custom_message
• parameter.sender_email
• parameter.sender_name
• parameter.url_for_product
• parameter.url_for_product_small_image_75_px
sendfriend_email_template
• parameter.product_name
• parameter.recipient_email_address
• parameter.recipient_name
• parameter.sender_custom_message
• parameter.sender_email
• parameter.sender_name
• parameter.url_for_product
• parameter.url_for_product_small_image_75_px
catalog_productalert_email_price_template
• parameter.alert_data_grid
• parameter.customer_name
• parameter.email_footer_template
• parameter.email_header_template
catalog_productalert_email_stock_template
• parameter.alert_data_grid
• parameter.customer_name
• parameter.email_footer_template
• parameter.email_header_template
wishlist_email_email_template
• parameter.customer_name
• parameter.view_wish_list_url
• parameter.wish_list_items
• parameter.wish_list_message
Unique List
• parameter.billing_address
• parameter.email_order_note
• parameter.order_id
• parameter.order_items_grid
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_message
• parameter.guest_customer_name
• parameter.order_created_at_datetime
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_comment
• parameter.order_status
• parameter.invoice_comment
• parameter.invoice_id
• parameter.invoice_items_grid
• parameter.shipment_id
• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.credit_memo_items_grid
• parameter.guest_customer_name_billing
• parameter.customer_email
• parameter.account_confirmation_url
• parameter.reset_password_url
• parameter.product_name
• parameter.recipient_email_address
• parameter.recipient_name
• parameter.sender_custom_message
• parameter.sender_email
• parameter.sender_name
• parameter.url_for_product
• parameter.url_for_product_small_image_75_px
• parameter.alert_data_grid
• parameter.email_footer_template
• parameter.email_header_template
• parameter.view_wish_list_url
• parameter.wish_list_items
• parameter.wish_list_message
Email Example
<html>
<body>
<p>Dear
<%parameter.firstname%>
<%parameter.lastname%>
</p>
<p> Thank you for shopping , please see your order no. <%parameter.orderId%> details below: </p>
<br>
<%InsertIf expression="${not empty parameter['orderNote']}" id="0"%>
<h3>Order notes:</h3>
<p>
<%parameter.orderNote%>
</p>
<%/InsertIf%>
<table class="order-details">
<tr>
<td class="address-details">
<h3>Billing Info</h3>
<p>
<%parameter.billingAddress%>
</p>
</td>
<td class="address-details">
<h3>Shipping Info</h3>
<p>
<%parameter.shippingAddress%>
</p>
</td>
</tr>
<tr>
<td class="method-info">
<h3>Payment Method</h3>
<p>
<%parameter.paymentInfo%>
</p>
</td>
<td class="method-info">
<h3>Shipping Method</h3>
<p>
<%parameter.shippingMethod%>
</p>
<%InsertIf expression="${not empty parameter['shippingMessage']}" id="1"%>
<h3>Shipping message:</h3>
<p>
<%parameter.shippingMessage%>
</p>
<%/InsertIf%>
</td>
</tr>
</table>
<%ForEach var="product" items="${transaction_details}"%>
<table width="100%" cellpadding="0" cellspacing="0" border="0" style="width:100%;">
<tr>
<td align="top" style="padding-top:20px;">
<table width="100%" cellpadding="0" cellspacing="0" border="0" style="width:100%;">
<tr>
<td align="center" class="someCSSSstyle">
<a href="<%${product['productURL']}%>" style="text-decoration:none;">
<img src="<%${product['imageURL']}%>" width="280" border="0" style="display:block; width:100%; max-width:280px;" /></a>
</td>
</tr>
<tr>
<td style="padding-top:20px;">
<table width="100%" cellpadding="0" cellspacing="0" border="0" style="width:100%;">
<tr>
<td align="center" style="font-family: Arial, Helvetica, sans-serif; font-size:14px; line-height:18px; color:#aead9e; text-align:center;">
<a href="url" target="_blank" style="text-decoration:none; color:#aead9e;">
<%${product['brand']}%>
</a>
</td>
</tr>
<tr>
<td align="center" style="font-family: Arial, Helvetica, sans-serif; font-size:16px; line-height:20px; color:#57574f; text-align:center; padding-top:5px;">
<a href="url" target="_blank" style="text-decoration:none; color:#57574f;">
<%${product['productName']}%>
</a>
</td>
</tr>
<tr>
<td align="center" style="font-family: Arial, Helvetica, sans-serif; font-size:16px; line-height:20px; color:#57574f; text-align:center; padding-top:5px;">
<a href="url" target="_blank" style="text-decoration:none; color:#57574f;">
Quantity: <%${product['productQuantity']}%>, Price per item: <%${product['productPrice']}%> <%${product['currency']}%>
</a>
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
<%/ForEach%>
<table class="order-details">
<tr>
<td class="address-details">
<h3>Shiping Price:</h3>
<p>
<%parameter.shippingTotal%>
</p>
</td>
<td class="address-details">
<h3>Order items total:</h3>
<p>
<%parameter.orderItemsTotal%>
</p>
</td>
</tr>
</table>
<br>
<h2> TOTAL:
<%parameter.orderTotal%>
<%${product['currency']}%>
</h2>
<br>
<p>Greetings!</p>
</body>
</html>