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:

  1. canonical email match
  2. external system ID match
  3. phone + name composite match
  4. manual review queue for ambiguous matches

Contact normalization contract

Parsed fieldGoogle Contacts targetValidation rule
emailrequired for create operations
display namesplit and normalize whitespace
companystandardize suffixes and casing
phoneenforce E.164 or route to review
notes/labelrequired 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

  1. ingest inbound message with MailSlurp.
  2. parse contact fields and confidence scores.
  3. run identity ladder and dedupe checks.
  4. create/update record in Google Contacts.
  5. 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