Customization - Email Parser

Customization - Email Parser

This guide will help you with the following:
  1. Create an Email Parser
    1. Naming and Module selection
    2. Prepare Template for parsing
    3. Select Fields to be updated
    4. Assign Record Owner
    5. Add Approved Email Addresses
  2. Manage Email Parsers
  3. Use the parser in Vertical Solution
Using an Email Parser, you can automatically fetch data from the emails you receive and add them as records in your Vertical Solution. Consider a situation where you obtain job applications through your website. When an applicant submits a job application through a form in the website, an email with details of the application will be sent to a person in the recruitment team. Using an email parser, the details in the email can be directly added as a record in the Vertical Solution, eliminating the need to add the details manually. Email parsers can be created for Leads, Contacts, Accounts, and Custom modules. Up to 20 email parsers can be created for a Vertical Solution, of which no more than 10 parsers can be active at a time.

Create an Email Parser

The various steps comprising the creation and configuration of an Email parser are described in the sections below. The example used will be that of the submission of job applications through the company website.

1. Naming and Module selection

In the first step, assign a name to the parser and select the module that you want to create the parser for.

  1. Log in to Zoho Developer Console and click Vertical Solutions.
  2. Select the application you'd like to modify and click Edit.
  3. Click Components in the left pane and select Email Parser.
  4. Click Create your first parser if you are creating for the first time. Otherwise, click Create New Parser.
  5. In the Create New Parser pop-up, provide the following details:
    1. A Parser Name.
    2. Select the Module in which you want the records with the data parsed from the emails to be created.
    3. Click Next

A Parser Email Address will be generated when a parser is created. This is the address that the email to be parsed has to be sent to. The Parser Email Address can be viewed in Sandbox as well as in your Vertical Solution.

2. Prepare Template for parsing

For the content of the emails to be parsed, it should be in a specific type of template. In this step, you will provide a sample email content that will be used as the template for parsing all the emails. There are two types of templates that you can use to parse your data:
  1. Key-value pair
  2. Paragraph format
Key-value pair: A pair consisting of a Key and a Value, which are separated by a delimiter. The Key is a unique identifier for some item of data. For example, First name or Email. These keys will have values associated with them. For example Sam for First name, sam.neil@gmail.com for Email, etc. The delimiter could be a colon (:), equal sign (=), or hyphen (-).
Sample
First name: Cody
Last name: James
Phone: 8980765639
Position: Senior Manager

Paragraph format: A whole sentence or paragraph will be considered a single value, and will be mapped to a Vertical Solution field. This format does not use any delimiters.
Sample
Autogenerated for the vacancy posted on 25th Nov.
A delimiter is a separator that is used to indicate the start or end of your data.
The steps to add these templates are as below:
1. In the Give us the email content to be used as template for parsing by dropdown, select the Copy and pasting email content option.

2. Paste the sample email content in the pop-up and click Parse.
Key-Value pair

The key in the key-value pair is mapped to the fields in the selected module. If the field mapping is not done automatically, then you can select the needed field.

Paragraph format
To use the paragraph format, paste the sample text in the Paste the content to be parsed pop-up and click Parse. Click the parsed text and in the popup, then select the field you want to map the value to. Click Save.

3. Choose the Add attachments present in email to the record created option if you want to send attachments from your email. Click Next.

Clicking Change Content enables you to edit the sample email content that is being used as the template for the parser.
Click How it works? to learn more about parsing. You can also change the delimiter used in the email content to another one, provided it is already being used in the content.

3. Select Fields to be updated

While adding a record, you can mention a value that a particular field in the module should be updated with. Use the / symbol to add or remove the entries.

4. Assign Record Owner

You can select the owner of the record. In the Assign based on, choose either a User or a Role and click Next. If more than one users are added, then the round-robin method of assignment will be used.

5. Add Approved Email Addresses

  1. Provide the email address that you will be sending the emails from to the parser email address.
  2. Click Add.
  3. Click Save.

Manage Email Parsers

You can edit, delete, and deactivate the email parsers that you have created.
  1. Click Components in the left pane, then select Email Parser.
  2. Click the name of the parser you want to edit.
  3. Make the necessary changes and click Update.
  4. Click the delete icon [] next to the name of the parser.
  5. In the confirmation message, click Yes, delete to confirm deletion.
  6. You can activate or deactivate a parser using the toggle switch.
  7. Under the Email Details column, you can view the statistics regarding the emails which were received by the parser.

Use the parser in Vertical Solution

The end user of the Vertical solution can obtain the details of the email parser from the Setup page.
  1. Log in to the Vertical Solution.
  2. Go to Setup > Channels > Email and select the Email Parser tab. The Parser Email Address will be displayed under the name of the email parser. It can be copied by clicking the copy [] icon. 
Add the required email addresses in the Enter the approved email addresses field.

The end user can also prepare the template for parsing using the Sending an Email option. The steps involved are mentioned below:
  1. Log in to the Vertical Solution.
  2. Go to Setup > Channels > Email and select the Email Parser tab. Click Create your first parser if you are creating for the first time. Otherwise, click Create New Parser.
  3. In the Create New Parser pop-up, provide the following details and click Next:
    1. A Parser Name.
    2. Select the Module in which you want the records with the data parsed from the emails to be created.
    3. A Parser Email Address will be generated when a parser is created. This is the address to which the email to be parsed is to be sent.
  4. In the Give us the email content to be used as template for parsing by dropdown, select the Sending an email option. 
     
  5. Send an email to the pre-parser address (highlighted in the screenshot below) with the content to be used as the template for parsing. Then click click here. The pre-parser address is a temporary email address. Its value will keep changing. Two types of templates can be used for parsing. 
  6. The text in the email will be parsed and displayed as shown below. The key in the key-value pair will be mapped to the fields in the selected module. If the field mapping is not done automatically, then you can select the needed field. Click here to learn more about the paragraph format.
  7. Choose the Add attachments present in email to the record created option if you want to send attachments from your email. Click Next.
  8. Refer to sections 'Selected Fields to be updated', 'Assign Record Owner' and 'Add Approved Email Addresses' for the remaining steps.


    Access your files securely from anywhere

      Zoho CRM Training Programs

      Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

      Zoho CRM Training
        Redefine the way you work
        with Zoho Workplace

          Zoho DataPrep Personalized Demo

          If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

          Zoho CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION









                                            You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                Manage your brands on social media

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • Related Articles

                                                                                                              • Configuring Email Accounts

                                                                                                                Vertical Solutions allows the subscribers to configure email accounts such as Zoho Mail, Gmail, Yahoo, Outlook and others, in their Solutions account, and be able to send, receive emails and do much more right from their solution account. Configuring ...
                                                                                                              • Customization - Sign Up Function

                                                                                                                The Sign Up function allows you to adjust the user sign up settings for your Vertical Solutions. Some adjustable features include setting default input values, sending out email notifications, and setting custom organization variables for later use. ...
                                                                                                              • Customization - Creating Custom Fields

                                                                                                                This guide will help you with the following: Custom Fields Custom Field Limits Add Custom Fields Edit Custom Fields Delete Custom Fields Create Currency Fields Add Pick List Values Add Multi-Select Pick List Values Create Lookup Field Create Auto ...
                                                                                                              • Customization - Using Custom Buttons

                                                                                                                This guide will help you with the following: Create Custom Button  Define Button Action  Edit Custom Button  Delete Custom Button  In addition to modules, fields, pages, links, and a lot of other elements, Zoho Developer also allows you to create new ...
                                                                                                              • Customization - Working with Custom Modules

                                                                                                                This guide will help you with: Add Custom Modules  Edit Custom Modules  Link Custom Modules With Other Modules  Manage Modules  Delete Custom Modules  Zoho Developer offers more than 10 standard modules for Sales, Marketing, Customer Support and ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  Resources

                                                                                                                  Videos

                                                                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                  eBooks

                                                                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                  Webinars

                                                                                                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                  CRM Tips

                                                                                                                  Make the most of Zoho CRM with these useful tips.



                                                                                                                    Zoho Show Resources