๐Ÿ“– User Guide

Everything you need to know about Data Guardian

๐Ÿš€ Getting Started

Data Guardian is a Zoho CRM Sigma Extension that automatically scores, verifies, and monitors your CRM data quality. It works across Leads, Contacts, Accounts, and Deals modules.

What It Does

  • Health Scoring: Calculates a 0-100% score based on field completeness
  • Email Validation: Verifies emails via external API
  • Address Verification: Validates addresses via API
  • Phone Validation: Checks phone format for 60+ countries
  • Account Validation: Verifies business registration numbers
  • Task Automation: Creates tasks for records needing attention
  • Reports: Weekly & monthly consolidated reports

Supported Modules

ModuleHealth ScoreEmailAddressPhoneBusiness Details
Leadsโœ…โœ…โœ…โœ…-
Contactsโœ…โœ…โœ…โœ…-
Accountsโœ…-โœ…โœ…โœ…
Dealsโœ…----

๐Ÿ”ง Installation

Step-by-Step Setup

  1. Install from Marketplace: Go to Zoho CRM Marketplace, search "Data Guardian", and click Install.
  2. Create Custom Fields: The extension requires specific custom fields. See the Custom Fields section below.
  3. Configure API Keys: Add your email validation and address verification API keys in the extension settings.
  4. Set Up Workflows: Configure workflow rules to trigger health checks on record create/edit.
  5. Verify Installation: Update any Lead, Contact, or Account record to see the health score appear.
๐Ÿ’ก Tip: After installation, update a few records to verify everything is working correctly before relying on automated processes.

๐Ÿ“Š Understanding Health Scores

The health score is calculated as: (Filled Fields รท Total Fields) ร— 100

Score Categories

Score RangeStatusMeaning
80-100%ExcellentData is complete and verified
60-79%GoodMinor improvements possible
40-59%FairSeveral fields need attention
20-39%PoorMajor data gaps
0-19%CriticalImmediate action required

Score Deductions

IssueDeduction
Invalid phone number-5 points
Invalid mobile number-5 points
Primary email missing-5 points
Invalid email (score <40)-5 points
Account Name missing-5 points
Account Type missing-5 points
Account Number invalid-5 points

๐Ÿ“ง Email Validation

The extension validates both Primary Email and Secondary Email fields.

Credit-Saving Logic

Once an email is marked as "Valid", it will NOT be re-verified unless the email field changes. This saves API credits.

๐Ÿ“ Note: If you update an email and want it re-verified, reset the Email Status field to blank first.

๐Ÿ  Address Verification

Requirements

Address verification requires at full physical delivery address: Street Number / House Number / Building Name / Street Name, Zip/Postal Code, City, State/Province and Country.

What It Returns

  • Address Status: Valid, Invalid, or Missing
  • Timezone: Auto-detected from verified address
Recommendation: To ensure accurate address verification, we recommend combining the Flat/Door Number, Building Name, and Street Name into the Street field.

๐Ÿ“ž Phone Validation

Phone numbers are validated against country-specific formats for 60+ countries.

Validation Flow

  1. Address must be verified first
  2. Country extracted from verified address

Supported Countries (60+)

Includes: USA, Canada, UK, India, China, Japan, Germany, France, Australia, Brazil, UAE, Saudi Arabia, South Africa, Singapore, and many more.

๐Ÿ”ข Account Validation (Accounts Only)

For the Accounts module, the extension validates:

  • Account Name: Not empty, not numbers-only, reasonable length
  • Account Type: Must match CRM picklist values
  • Account Number: Validated against 60+ country business registration formats (EIN, VAT, CNPJ, ABN, etc.)

โœ… Task Automation

The extension automatically creates or updates tasks based on health scores.

Task Priority Rules

Health ScoreTask SubjectPriorityStatus
< 20%CRITICALHighestIn Progress
20-39%URGENTHighIn Progress
40-59%ATTENTIONLowIn Progress
60-79%LOWESTLowestIn Progress
80-89%NORMALNormalIn Progress
90-99%GOODNormalCompleted
100%EXCELLENTNormalCompleted
๐Ÿ’ก Smart Updates: If a health task already exists for a record, it updates it instead of creating a duplicate.

๐Ÿ“ˆ Automated Reports

Weekly Report (Every Monday)

Covers the previous week. Includes: Leads, Contacts, Accounts, Deals & Tasks summary with new records count.

Monthly Report (1st of Month)

Full CRM health analysis with detailed breakdowns per module, score distributions, and recommendations.

Report Features

  • Mobile-responsive HTML email design
  • Color-coded score banners
  • Module summary cards
  • Action recommendations
  • Toggle ON/OFF via Settings

โš™๏ธ Settings

The Settings widget lets you control which reports run:

  • Weekly Report: Toggle ON/OFF
  • Monthly Report: Toggle ON/OFF
  • Email Verification Report: Toggle ON/OFF

Default: All reports are enabled.

โ“ Frequently Asked Questions

Q: How often does the health check run?

A: On every record create/edit. Optional nightly bulk check can be configured.

Q: How do I reset a validation status?

A: Clear the status field (set to blank) on the record. The extension will re-verify on next save.