Hi, Humans. How may we help you?

How to set Emails in Standard Format
13 min
Created by MLMC on 2/15/2023 11:09 AM
Updated by Karine Moreira on 7/27/2023 2:31 PM
This email format, designed by Zenvia Conversion, is intended to simplify the app's connection with other systems, which is able to work with an email type that is very simple to construct.

Keep in mind that Zenvia Conversion prioritizes resolving bugs that occur in this format, so we recommend using it whenever possible.

 

How can I check whether my email format is correct?

Zenvia Conversion has an email address that you can send test emails to:

test-en@development.zenvia.com

We'll explain how to send emails to this address below.

 

Email subject

Should be one of the following:

  • Zenvia - Email Estándar

  • Zenvia - Standard Email

  • Zenvia - Email Padrão

make sure the subject does not include "FWD" if you are forwarding the email.

 

Email body

The body of the email should not include HTML. It must be plain text and needs to comply with the following 3 requirements:

  • The content of the email should contain only text and must be structured in a "field: value" format.

  • Each field should be separated by a line break.

  • The names of the fields should match the fields in the following tables.

FIELD

OBLIGATORY

DESCRIPTION

EXAMPLE

Full Name

YES (If there are no First Name and Last Name fields)

Represents the lead's name or surname

Full Name: John Towers

First Name

YES

Represents the lead's name

First Name: John

Last Name

YES

Represents the lead's surname

Last Name: Towers

Email

YES (If there is no phone number)

Represents lead's email. Expected to be valid and correct email

Email: jtowers@mail.com

Phone Number

YES

Represents phone number of the lead

Telephone: +5591132302023

Source

YES

Shows lead's source

Source: Web

Industry

YES

Indicate which industry the lead belongs to. The accepted values are:

  • For the automative industry: "car"

  • For the savings plan industry: "savingPlan"

  • For the real estate industry: "realEstate"

  • For the insurance industry: "Insurance"

  • For the retail sales industry: "retail"

Industry: Car

Mails of the type idk@idk.com or nothave@gmail.com, among other fictitious ones, cannot be taken. Here you will see a list of emails that will not be considered.

 

Optional fields for all email types

 

Next, several optional fields are specified that can be included (not obligatory) in emails:

FIELD

OBLIGATORY

DESCRIPTION

EXAMPLE

Campaign

NO

Marketing campaign name

Campaign: HotSale

UTM_Medium

NO

Identifies what type of link or media was used to get the lead

UTM_Medium: email

Comment

NO

Comment or message which lead left

Comment: I want to know what are the different prices

Category

NO

The lead category. The only valid values are: "New" or "Used"

Category: New

Shop

NO

Name of the store that should receive the lead. Using this field, the same values must be respected in all emails

Shop: Branch123

Country

NO

Lead Country

Country: United States

Region / State /

Province

NO

Lead Region, State or Province. Only one of the fields must be used

State:

New Jersey

City / County

NO

Lead City or County. Only one of the fields must be used

City: Detroit

Zip Code

NO

Lead Postal Code

Zip Code: 14323-778

 

Non-Standard Optional Fields

 

If you'd like to add other non-standard fields not covered in the section above, you can add them to the Comments fields, separated by | and replacing : with > or ->

For example, if you want to add the fields: Health Plan and Age
The comments field should be formatted as follows:

Comments: I want to find out about the price of treatment | Health Plan -> Health Premium | Age -> 28

 

Extra Optional Fields by Industry

 

Below we illustrate several optional fields that you can add to an email according to the industry of each lead. The possible industries are:

  • Car 

  • Retail

  • savingPlan (Savings Plans)

  • insurance

  • realEstate

     

Car

FIELD

OBLIGATORY

DESCRIPTION

EXAMPLE

Brand

NO

Product Brand

Brand: Ford

Model

NO

Product Model

Model: Mustang

Version

NO

Product Version

Version: Ghia

Mileage

NO

Mileage

Mileage: 10000

Car License

NO

Car License Plate

Car License Number: ABC123

Retail

FIELD

OBLIGATORY

DESCRIPTION

EXAMPLE

Brand

NO

Product Brand

Brand: Sony

Model

NO

Product Model

Model: Xperia

Details

NO

Product Details

Details: 16GB ROM, 2GB RAM

SKU

NO

Product ID

SKU: 0-399923-4

Price

NO

Product Price

Price: $250

Currency

NO

Currency in which price was published

Currency: US$

 

Savings Plan

FIELD

OBLIGATORY

DESCRIPTION

EXAMPLE

Advance payment

NO

Initial money I owe for acess to funding plan

Advance payment: $50.000

Dues

NO

Plan Portions

Portions: $2.500

Financing

NO

Financing

Financing: 12 months

the real estate industry doesn't require specialized fields.

 

Examples of emails in Standard Format

 

Here are some examples of how to use Zenvia Conversion's standart format. Here, you'll see multiple examples of sending e-mail with Mollusco® Format are presented, with successful and unsuccessful cases.

 

Successful Cases

 

Successful Case 1: e-mail with required and optional information (for the auto industry)

 

E-mail sent

  • Subject: Zenvia - Standard Email

  • Body

First Name: Pedro


Last Name: García


E-mail: pedro.garcia@example.com


Phone: +54 9 11 5123 4567


Source: Website


Industry: car


UTM_Campaign: CyberMonday 2017


Comments: I'd like more information about financing for this car.


Category: New


Company: Northern Automobiles


Store: Liberty Avenue Branch


ZipCode: 1425


Make: Chevrolet


Model: Cruze


Version: LTZ Diesel

 

 

Response:

 

 

 

Successful Case 2: email with required information only

 

Email Sent

  • Subject: Zenvia - Standard Email

  • Body

First Name: Pedro


Last Name: García


E-mail: pedro.garcia@example.com


Phone: +54 9 11 5123 4567


Source: Website


Industry: car

 


Response:

 

Failed Cases


Below, we present some examples of errors that may occur in the case of a failed e-mail.

 

Failed Case 1: Incorrect subject/ no phone number and/or email/ no first and/or last name

 

Email Sent

  • Subject: Test email

  • Body

Source: Website


Industry: car


Campaign: CyberMonday 2017


Comments: I'd like more information about financing for this ecar


Category: New


Company: Northern Automobiles


Store: Liberty Avenue Branch


Postal Code: 1425


Make: Chevrolet


Model: Cruze


Version: LTZ Diesel

 


Response:

 

Failed Case 2: No name

 

E-mail Sent

  • Subject: Zenvia - Standard Email

  • Body

E-mail: pedro.garcia@example.com


Telephone: +54 9 11 5123 4567


Source: Website


Industry: car


Campaign: CyberMonday 2017


Comments: I'd like more information about financing for this car


Category: New


Company: Northern Automobiles


Store: Liberty Avenue Branch


Postal Code: 1425


Make: Chevrolet


Model: Cruze


Version: LTZ Diesel

 

 

Response:

 

Failed Case 3: No phone number or email

 

E-mail Sent

  • Subjet: Zenvia - Standard Email

  • Body:

Firstname: Pedro


Source: Website


Industry: car


Campaign: CyberMonday 2017


Comments: I'd like more information about this car


Category: New


Company: Northern Automobiles


Store: Liberty Avenue Branch


Postal Code: 1425


Make: Chevrolet


Model: Cruze


Version: LTZ Diesel

 

 

Response:

 

If you have questions about this article or cannot find a solution to your problem, remember that you can contact our Support Team.