What is an event and what does it trigger?
Zest Gift Notes keeps track of gifter and recipient details and actions so you can send timely transactional emails, tracking updates, and marketing to both audiences (when they opt in, of course).
Events, like when a customer places a gift order or when a recipient accepts a gift order, are automatically sent to your marketing tool when you integrate. Use these events to trigger automated email and SMS sequences for your gift-buying customers and their recipients. These events give you the critical information you need to deploy post-purchase comms, like order confirmations and tracking updates, as well as personalized messages that keep gifters and recipients engaged all year long so they come back to gift again! **
Events
Order Placed
Event information
Name: zest_gift_order_placed
Customer attached to the event: Gifter
Description: Event triggered when a customer places a gift order through your store. This event tracks the initial order creation.
Example event data:
{ "order_id": "GFT-12345", "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345", "gift_message": "Congratulations on your promotion! Enjoy this gift.", "gift_from": "John Smith", "digital_card": "https://your-store.com/images/congrats-card.png", "recipient_name": "Jane Doe", "recipient_email": "[email protected]", "recipient_phone": "", "digital_card_name": "Description of my digital card", "digital_card_occasion": "Congratulations" }Send Gift
Event information
Name: zest_send_gift
Customer attached to the event: Gift recipient
Description: Event triggered the when you should send the gift link to the recipient. The timing of this event respects the customer’s selection (e.g. sent immediately, sent upon shipment, sent upon delivery, etc.), and you do not need to configure any additional timing logic in your workflows.
Example event data:
{ "order_id": "GFT-12345", "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345", "gift_message": "Happy birthday! Hope you enjoy this little surprise.", "gift_from": "Sarah Johnson", "digital_card": "https://your-store.com/images/birthday-card.png", "recipient_name": "Michael Brown", "digital_card_name": "Description of my digital card", "digital_card_occasion": "Birthday" }Send Thank You
Event information
Name: zest_send_thank_you
Customer attached to the event: Gifter
Description: Event triggered when a recipient sends a thank you message to the gift sender.
Example event data:
{ "order_id": "GFT-12345", "thank_you_message": "Thank you so much for the thoughtful gift! I love it!", "recipient_name": "Emily Wilson" }Tracking Opt-in (formerly: Gift Accepted)
Event information
Name: zest_tracking_opt_in (formerly: zest_gift_accepted)
Customer attached to the event: Gift recipient
Description: Event triggered when a recipient opts in to receiving tracking information.
Example event data:
{ "order_id": "GFT-12345", "customer_id": "cust_987654", "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345", "gift_from": "David Chen" }Gift Shipped
Event information
Name: zest_gift_shipped
Customer attached to the event: Gift recipient
Description: Event triggered the when you should send the gift link to the recipient. The timing of this event respects the customer’s selection (e.g. sent immediately, sent upon shipment, sent upon delivery, etc.), and you do not need to configure any additional timing logic in your workflows.
Example event data:
{ "order_id": "GFT-12345", "customer_id": "cust_987654", "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345", "gift_from": "Alex Taylor", "tracking_link": "https://tracking.carrier.com/1Z9999999999999999", "tracking_number": "1Z9999999999999999", "tracking_company": "UPS" }Gift Out For Delivery
Event information
Name: zest_gift_out_for_delivery
Customer attached to the event: Gift recipient
Description: Event triggered when the gift is out for delivery and will arrive at the recipient’s address soon. Only sent after if the recipient has opted in to receiving tracking information.
Example event data:
{ "order_id": "GFT-12345", "customer_id": "cust_987654", "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345", "gift_from": "Jessica Miller", "tracking_link": "https://tracking.carrier.com/1Z9999999999999999", "tracking_number": "1Z9999999999999999", "tracking_company": "FedEx" }Gift Delivered
Event information
Name: zest_gift_delivered
Customer attached to the event: Gift recipient
Description: Event triggered when the gift has been successfully delivered to the recipient. Only sent after if the recipient has opted in to receiving tracking information.
Example event data:
{ "order_id": "GFT-12345", "customer_id": "cust_987654", "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345", "gift_from": "Robert Wilson", "tracking_link": "https://tracking.carrier.com/1Z9999999999999999", "tracking_number": "1Z9999999999999999", "tracking_company": "USPS" }