Embedding Quick Actions
When you run a business, you will have the necessity to send automated emails to your users for various purposes such as, to confirm their subscription, request a rating, review, ticket confirmation to an event, event reservations etc. To ensure that your users can follow up on emails from the listing, you can embed Quick Actions in your email.
Schema.org is a collaborative community that is working on creating and promoting schemas for structured data markup on the internet. The format defined by schema.org is understood by Zoho Mail and this markup will be rendered as Quick Actions in the email listing. To add Quick Actions in the email that you are sending, you can add a Microdata or JSON-LD markup (as defined by schema.org) in the HTML content of the email.
Things to do for Zoho Mail to identify Quick Actions
To embed these quick actions in the emails you send, there are two things that need to be checked.
- The email that you're sending should contain a specific script embedded in either the Microdata or the JSON-LD format.
- The domain from which you send these email should be registered in our identified list of domains.
Format for embedding Quick Actions
To embed Quick Actions in the emails that you send out, you will have to embed a script in the email that you're sending. Zoho Mail supports both JSON-LD and Microdata formats in the email markup.
Microdata
Microdata is a markup language that has been designed to describe and highlight specific parts of an email. Each of this markup can contain associated attributes. In the Microdata format, the three basic attributes used are itemtype, itemprop and itemscope.
Itemscope - The usage of this attribute within a div tag denotes that all information enclosed within this div tag belongs to a single entity.
Itemtype - When you mention an itemtype, it denotes that all elements within that scope come under the class that is mentioned. You can set this to any of the classes available under the schema.org class.
Itemprop - Additional information about the class mentioned as the itemtype can be provided using this attribute.
JSON-LD
JSON-LD is a JSON based syntax that's another markup language which is commonly used. In the JSON-LD format, the @context is set to http://schema.org, the @type is set to any of the classes available under the schema.org class, and the properties of that class are defined in the script.
Syntax for Text Markup
Save Action
The Save Action button can be added to emails where restaurant coupons/offers are sent with emails and need to be saved. This action can be performed only once from the email listing.
Embed either the JSON-LD or the Microdata syntax below in the HTML body of the email for Zoho Mail to identify and add the Save Action button to your emails.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "SaveAction",
"name": "Save Coupon",
"handler": {
"@type": "HttpActionHandler",
"url": "https://nearbuy.com/save?offerId=hse237"
}
},
"description": “10% off at The Fat Duck"
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/SaveAction">
<meta itemprop="name" content="Save Coupon"/>
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://nearbuy.com/save?offerId=hse237"/>
</div>
</div>
<meta itemprop="description" content="10% off at The Fat Duck”/>
</div>
Confirm Action
The Confirm Action button can be added to emails where the user is required to confirm their subscription to a specific service or website.
Embed either the JSON-LD or the Microdata syntax below in the HTML body of the email for Zoho Mail to identify and add the Confirm Action button to your emails.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ConfirmAction",
"name": “Confirm Subscription",
"handler": {
"@type": "HttpActionHandler",
"url": "https://nigella.com/confirm?subscriptionId=567qwe"
}
},
"description": “Confirm your subscription to Nigella Lawson’s Newsletter"
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
<meta itemprop="name" content=“Confirm Subscription"/>
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://nigella.com/confirm?subscriptionId=567qwe"/>
</div>
</div>
<meta itemprop="description" content="Confirm your subscription to Nigella Lawson’s Newsletter"/>
</div>
View Action
The View Action button can be added in cases where you want to redirect the user to a different web page to view some content. It is quite usual to receive order confirmation emails from e-commerce websites. These emails generally contain an option where you can view your order list. This is a perfect example of the View Action type.
Embed either the JSON-LD or the Microdata syntax below in the HTML body of the email for Zoho Mail to identify and add the View Action button to your emails.
JSON-LD
http://schema.org",https://www.saltychocolate.com/gp/ref=nav_youraccount_orders", Microdata
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="target" href="https://www.saltychocolate.com/gp/ref=nav_youraccount_orders"/>
<meta itemprop="name" content="View Order"/>
</div>
<meta itemprop="description" content="View Order Details and Tracking Information"/>
</div>
Track Action
The Track Action button can be added to emails where users will be required to track an order they've placed or a package that they're expecting.
Embed either the JSON-LD or the Microdata syntax below in the HTML body of the email for Zoho Mail to identify and add the Confirm Action button to your emails.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ParcelDelivery",
"deliveryAddress": {
"@type": "PostalAddress",
"streetAddress": "42 Shirley Ave.",
"addressLocality": “West Chicago",
"addressRegion": “CA",
"addressCountry”: “US",
"postalCode": “60185"
},
"expectedArrivalUntil": "2017-03-12T12:00:00-08:00",
"carrier": {
"@type": "Organization",
"name": “DHL"
},
"itemShipped": {
"@type": "Product",
"name": “Dark Chocolate Syrup"
},
"partOfOrder": {
"@type": "Order",
"orderNumber": “127963",
"merchant": {
"@type": "Organization",
"name": “Rebecca Anderson"
}
},
"trackingUrl": "https://dhl.com/track/645287829"
"potentialAction": {
"@type": "TrackAction",
"target": "https://dhl.com/track/645287829"
},
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/ParcelDelivery">
<div itemprop="deliveryAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="42 Shirley Ave."/>
<meta itemprop="addressLocality" content=“West Chicago"/>
<meta itemprop="addressRegion" content=“IL"/>
<meta itemprop="addressCountry" content="US"/>
<meta itemprop="postalCode" content="60185"/>
</div>
<meta itemprop="expectedArrivalUntil" content="2017-03-12T12:00:00-08:00"/>
<div itemprop="carrier" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content=“DHL"/>
</div>
<div itemprop="itemShipped" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content=“Dark Chocolate Syrup"/>
</div>
<div itemprop="partOfOrder" itemscope itemtype="http://schema.org/Order">
<meta itemprop="orderNumber" content="127963"/>
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content=“Rebecca Anderson"/>
</div>
</div>
<link itemprop="trackingUrl" href="https://dhl.com/track/645287829"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/TrackAction">
<link itemprop="target" href="https://dhl.com/track/645287829"/>
</div>
</div>
RSVP Action
Consider an email where you're invited to an event. The basic HTML content of the email will contain information regarding the date and time, the location where the event is take place, attendees, host etc. Further, it will ask for consent on whether you will be attending the event. All event invites usually have 3 options - 'Yes', 'No' and 'Maybe'. In such cases, you can insert a script to embed the RSVP quick action in the email listing. When this option is clicked, a breif event summary with the three options will be displayed.
Embed either the JSON-LD or the Microdata syntax below in the HTML body of the email for Zoho Mail to identify and add the View Action button to your emails.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Event",
"name": “Marketers Monthly Meet",
"startDate": “2017-10-08T15:30",
"endDate": “2027-10-08T16:30",
"location": {
"@type": "Place",
"address": {
"@type": "PostalAddress",
"name": “Zylker Inc.",
"streetAddress": "24 Goldfield Avenue, Knit Conference Room",
"addressLocality": "South Windsor",
"addressRegion": "CT",
"postalCode": “06074",
"addressCountry": "USA"
}
},
"potentialAction": [
{
"@type": "RsvpAction",
"rsvpResponse": "yes",
"handler": {
"@type": "HttpActionHandler",
"url": "https://sitename.com/rsvp?eventId=123&value=yes"
},
"attendance": "http://schema.org/RsvpAttendance/Yes"
},
{
"@type": "RsvpAction",
"rsvpResponse": "no",
"handler": {
"@type": "HttpActionHandler",
"url": "https://sitename.com/rsvp?eventId=123&value=no"
},
"attendance": "http://schema.org/RsvpAttendance/No"
},
{
"@type": "RsvpAction",
"rsvpResponse": "maybe",
"handler": {
"@type": "HttpActionHandler",
"url": "https://sitename.com/rsvp?eventId=123&value=maybe"
},
"attendance": "http://schema.org/RsvpAttendance/Maybe"
}
]
}
</script>
Simiarly, you can also insert the Microdata script in the body of the HTML content while sending the email.
Microdata
<div itemscope itemtype="http://schema.org/Event">
<meta itemprop="name" content=“Marketers Monthly Meet"/>
<meta itemprop="startDate" content="2017-10-08T15:30"/>
<meta itemprop="endDate" content="2017-10-08T16:30"/>
<div itemprop="location" itemscope itemtype="http://schema.org/Place">
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content=“Zylker Inc."/>
<meta itemprop="streetAddress" content="24 Goldfield Avenue, Knit Conference Room"/>
<meta itemprop="addressLocality" content="South Windsor"/>
<meta itemprop="addressRegion" content="CT"/>
<meta itemprop="postalCode" content=“06074"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
</div>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/RsvpAction">
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://sitename.com/rsvp?eventId=123&value=yes"/>
</div>
<link itemprop="attendance" href="http://schema.org/RsvpAttendance/Yes"/>
<meta itemprop="rsvpResponse" content="yes">
</div>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/RsvpAction">
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://sitename.com/rsvp?eventId=123&value=no"/>
</div>
<link itemprop="attendance" href="http://schema.org/RsvpAttendance/No"/>
<meta itemprop="rsvpResponse" content="no">
</div>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/RsvpAction">
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://sitename.com/rsvp?eventId=123&value=maybe"/>
</div>
<link itemprop="attendance" href="http://schema.org/RsvpAttendance/Maybe"/>
<meta itemprop="rsvpResponse" content="maybe">
</div>
</div>
Rating and Review
After visiting a restaurant or staying at a hotel or a resort for a vacation, emails are usually sent requesting for a rating of their services or to collect a feedback on it. While sending out emails like these, you can embed a script to add a Rate Us or Review Quick Action to the emails.
Numeric Rating
This option lets you enter the numeric rating for that restaurant by clicking the Rate Us button.
Embed either the JSON-LD or the Microdata syntax below in the HTML body of the email for Zoho Mail to identify and add the Rate Us button to your emails.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ReviewAction",
"review": {
"@type": "Review",
"itemReviewed": {
"@type": "FoodEstablishment",
"name": “The Fat Duck"
},
"reviewRating": {
"@type": "Rating",
"bestRating": "5",
"worstRating": "1"
}
},
"handler": {
"@type": "HttpActionHandler",
"url": "https://thefatduck.com/review?id=abc123",
"requiredProperty": {
"@type": "Property",
"name": "review.reviewRating.ratingValue"
},
"method": "http://schema.org/HttpRequestMethod/POST"
}
},
"description": “We hope you had an amazing time dining with us. Please rate your experience here."
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ReviewAction">
<div itemprop="review" itemscope itemtype="http://schema.org/Review">
<div itemprop="itemReviewed" itemscope itemtype="http://schema.org/FoodEstablishment”>
<meta itemprop="name" content=“The Fat Duck”/>
</div>
<div itemprop="reviewRating" itemscope itemtype="http://schema.org/Rating">
<meta itemprop="bestRating" content="5”/>
<meta itemprop="worstRating" content="1”/>
</div>
</div>
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://thefatduck.com/review?id=abc123"/>
<div itemprop="requiredProperty" itemscope itemtype="http://schema.org/Property">
<meta itemprop="name" content="review.reviewRating.ratingValue"/>
</div>
<link itemprop="method" href="http://schema.org/HttpRequestMethod/POST"/>
</div>
</div>
<meta itemprop="description" content="We hope you had an amazing time dining with us. Please rate your experience here."/>
</div>
Review Text
If you want to request for a review along with the rating in the email that you're sending out, you can embed the Review Quick Action the email listing.
Embed either the JSON-LD or the Microdata syntax below in the HTML body of the email for Zoho Mail to identify and add the Review button to your emails.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org”,
"@type": "EmailMessage",
"potentialAction": {
"@type": "ReviewAction",
"review": {
"@type": "Review",
"itemReviewed": {
"@type": "FoodEstablishment",
"name": “The Fat Duck"
},
"reviewRating": {
"@type": "Rating",
"bestRating": "5",
"worstRating": "1"
}
},
"handler": {
"@type": "HttpActionHandler",
"url": "https://thefatduck.com/review?id=abc123",
"requiredProperty": {
"@type": "Property",
"name": "review.reviewRating.ratingValue"
},
"optionalProperty": {
"@type": "Property",
"name": "review.reviewBody"
},
"method": "http://schema.org/HttpRequestMethod/POST”
}
},
"description": “We hope you enjoyed your seafood experience with The Fat Duck. Tell us more about it"
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ReviewAction">
<div itemprop="review" itemscope itemtype="http://schema.org/Review">
<div itemprop="itemReviewed" itemscope itemtype="http://schema.org/FoodEstablishment">
<meta itemprop="name" content=“The Fat Duck"/>
</div>
<div itemprop="reviewRating" itemscope itemtype="http://schema.org/Rating">
<meta itemprop="bestRating" content="5"/>
<meta itemprop="worstRating" content="1”/>
</div>
</div>
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://thefatduck.com/review?id=abc123"/>
<div itemprop="requiredProperty" itemscope itemtype="http://schema.org/Property">
<meta itemprop="name" content="review.reviewRating.ratingValue"/>
</div>
<div itemprop="optionalProperty" itemscope itemtype="http://schema.org/Property">
<meta itemprop="name" content="review.reviewBody"/>
</div>
<link itemprop="method" href="http://schema.org/HttpRequestMethod/POST”/>
</div>
</div>
<meta itemprop="description" content="We hope you enjoyed your seafood experience with The Fat Duck. Tell us more about it”/>
</div>
Registration form for embedding Quick Actions:
For Zoho Mail to identify the schema that you're embedding in your email, and to ensure that the domain it's being sent from is valid, it has to be registered with us. Fill in the below form and Submit it to register with us, so that your Email Snippets can be identified by Zoho Mail. The domain registration process will be completed after a review of the domain. The organization that has sent the registration request will be contacted, in case there are any further clarifications in this regard.
Note:
- It is recommended that you use the View Action and Track Action options than the Save and Confirm Actions.
- If the Save and Confirm Actions are being used, the authentication part should be taken care of by the sender.