- DarkLight
Malomo - Integration Guide for Yotpo SMS & Email
- DarkLight
Goals and Outcomes
The Malomo and Yotpo integration allows merchants to send personalized and targeted emails or SMS messages based on the shipping events and status of orders tracked by Malomo. This integration will allow Malomo to send tracking information back to Yotpo, so you can incorporate shipping data into automated flows in near real-time.
In this article, you will learn how to connect Malomo and Yotpo and how to set up email and SMS flows for Malomo events.
Malomo Integration Overview
Malomo is a branded order tracking & analytics platform that helps connect users. Malomo proactively monitors every shipment you send and can detect dozens of different post-purchase events. Use those events to trigger email and SMS messages to your customers, or alert your Customer experience team of critical issues.
Send transactional messages directly from your marketing platforms so you can easily control the design and content. Transactional messages also see a 3x higher open and click-through rate. Use them to re-market and turn delivery from a cost center into a powerful retention engine.
Connecting Malomo with Yotpo SMS & Email
To connect Malomo with Yotpo:
In your Yotpo SMS & Email main menu, go to Integrations.
Search for Malomo in the navigation bar and click Connect.
Complete the prompts of the install flow. Once complete, you’ll see the integration is successfully installed within your Yotpo account.
You are all set to use the integration and set up your flows.
Note:
You will need to create a Full Access Private API key in Malomo to complete the integration. See Malomo’s instructions on generating API keys.
Setting up SMS & Email flows
To make the most out of the integration, we recommend setting up flows for the following statuses as the main shipping emails:
Pre Transit
In Transit
Out for Delivery
Delivered
And then, these as add-ons for shipping issues:
Failure (Delivery Attempted)
Available for Pickup
Return to Sender
Click below to view the full list of available Malomo events.
List of Malomo events
The Malomo and Yotpo SMS & Email integration supports the following events as triggers in Yotpo for SMS flows.
Event name | Description |
---|---|
Malomo Fulfillment Stalled | The order that has been created but has not been fulfilled in the specified time frame.
|
Malomo Order confirmation | Triggered to notify the customer to confirm their order including Malomo tracking information.
|
Malomo Shipment Available for Pickup | The shipment is available for pickup form the carrier’s facility, such as a post office. |
Malomo Shipment Canceled | The delivery has been canceled typically by either the seller or recipient. |
Malomo Shipment Pre Transit | A shipping label was created and has been registered in the carrier’s system. However, the carrier has not yet taken possession of the shipment. |
Malomo Shipment Delivered | The local delivery vehicle has reported the package was delivered. |
Malomo Shipment Error | An unknown delivery error occurred. |
Malomo Shipment Failure | A delivery was attempted but the shipment could not be delivered. |
Malomo Shipment In Transit | The shipment is in the carrier’s possession and is en route to its destination.
|
Malomo Shipment Out For Delivery | The shipment is currently on its last mile and is en route to the destination. |
Malomo Shipment Pre Transit | A shipping label was created and has been registered in the carrier’s system. However, the carrier has not yet taken possession of the shipment. |
Malomo Shipment Returned to Sender | The order that has been fulfilled or is in transity and has not recieved a scan update in the specified time frame. |
Malomo Shipment Stalled | The order that has been fulfilled or is in transit and has not received a scan update in the specified time frame. |
Malomo Shipment Unknown | The carrier doesn’t know the current status of the shipment. This is typically seen when a shipping label has been created, but before the label has registered in the carrier’s system. |
To set up a flow:
In your Yotpo SMS & Email main menu, go to Flows and click Create Flow from Scratch.
Click Choose Trigger and search for Malomo.
Select the relevant flow trigger based on the event you are looking for.
Choose SMS/MMS Message or Email as an action. This means an SMS/MMS message or email (depending on what you choose) will be sent as an outcome once the Trigger, i.e., shipment delivered, is updated to Shipment Delivered in Malomo.
When configuring the text of your SMS or Email, select Personalization tags below the message box to open the list of available properties sent to Yotpo via Malomo.
Create the message with the help of personalization tags. In place of these personalization tags customer, order, and tracking data will be auto-populated with the relevant information.
Personalization Tag
Description
Example
Order Status URL
The URL of your shop’s order tracking page. It can be a Shopify page or a Malomo-hosted page
“https://ppeev.myshopify.com/pages/order-tracking?_m_id=001d961a-2c3b-4cee-b22c-2a3d3b64b5e8"
Order Number
The order number assigned by Shopify
“1000”
Tracking EDD
The shipment’s original estimated delivery date provided by the carrier, if available
“2019-01-30 13:30:00”
Tracking Latest Status Detail
Standardized tracking message with relevant shipment information
“arrived_at_destination”
Tracking Latest Status
Current tracking status of the shipment
“delivered”
Customer Email
Customer email address
“john@example.com”
Tracking Number
Package tracking number
“9400000000000000000000”
Customer Name
The customer’s first and last name
“John Smith”
Shipping Address
Customer shipping address
“INDIANAPOLIS, US, 46203, IN”
Tracking Latest Update
The timestamp of the latest shipment update provided by the carrier
2019-01-30 13:30:00
Tracking URL
The carrier’s tracking page URL
https://tools.usps.com/go/TrackConfirmAction?qtc_tLabels1=9400000000000000000000
Carrier Name
Carrier name
USPS
Carrier Service
Carrier service level
First-Class Package Service
Subtotal_Price
The price before any shipping or sales tax
103.3
Tax_Price
The price of sales tax
33
Total_Discounts
The total of all discounts
12.2
Discount_Code_Amount
Discount code amount
20
Discount_code
Discount Code
OFF20
Items_count
Total amount of items in order
3
Currency
Order currency
USD
Shipping_Price
The total price for shipping
23
Total_Price
The total price including sales tax
65.7
Product_Title
Product name
Cotton Modal Capri Leggings
Variant_Information
Information on the product variant
Medium Heather Grey/Medium
Product_Image
Product image
Having issues with the integration?
Please reach out to Yotpo support.