automations
Email Parser Google Contacts Integration for Identity-Safe Contact Ops
Build an email parser Google Contacts integration that normalizes inbound contact updates with dedupe rules and merge-safe identity controls.
Use this pattern when sales, support, or operations mailboxes receive contact updates that should become clean, searchable Google Contacts records.
Identity resolution ladder
Resolve contacts in this order:
- canonical email match
- external system ID match
- phone + name composite match
- manual review queue for ambiguous matches
Contact normalization contract
| Parsed field | Google Contacts target | Validation rule |
|---|---|---|
primary_email |
required for create operations | |
full_name |
display name | split and normalize whitespace |
organization |
company | standardize suffixes and casing |
phone_e164 |
phone | enforce E.164 or route to review |
source_channel |
notes/label | required for provenance tracking |
Merge and dedupe policy
- never auto-merge records when match confidence is below threshold.
- preserve original source text in notes for auditability.
- allow only one primary email per contact unless explicit alias policy exists.
Implementation sequence
- ingest inbound message with MailSlurp.
- parse contact fields and confidence scores.
- run identity ladder and dedupe checks.
- create/update record in Google Contacts.
- record trace, source message ID, and merge decision.
Operational metrics to monitor
- duplicate-contact rate per 1,000 writes
- low-confidence records routed to review
- write success vs parser success delta
- mean time to resolve ambiguous identity events