Contact Synchronization

This pattern demonstrates how to synchronize contacts between your CRM and HealthSherpa's system. The flow ensures that each contact in your CRM has a corresponding record in HealthSherpa, and stays up-to-date.

Overview

1. Initial Setup

   • Create an API client with your HealthSherpa API key

   • Store the API key securely in your system

   • Configure your agents' email addresses - must match their HealthSherpa account

2. Agent Authentication

   • Provide a "Login to HealthSherpa" button in your CRM

   • When clicked, opens HealthSherpa login page in a new tab

   • Agent logs in to HealthSherpa separately

3. Contact Synchronization Flow

   • When a user clicks the "Sync to HealthSherpa" button in your CRM:

     1. Check if the contact has a HealthSherpa ID stored in your CRM

        1. If no HealthSherpa ID exists:

           • Create a new contact in HealthSherpa

           • Store the returned HealthSherpa ID in your CRM

        2. If HealthSherpa ID exists:

           • Update the existing contact in HealthSherpa

     2. Redirect the user to the quote page in HealthSherpa (the redirect URL will be returned from both the create and update contact endpoints).

        1. If a zip code was provided, it will be pre-populated. If not, the agent will be prompted to provide one. In either case, the agent has to confirm the county in order to access the quote.

4. Data Mapping

   • Map your CRM fields to HealthSherpa fields

   • Required fields: external_id, first_name, last_name

   • Optional fields: email, phone, address, Medicare information

5. Error Handling

   • Handle API errors and show user-friendly error messages