# Sync contacts from an integration

**Sync contacts** copies the people of a connected integration into **Contacts**: CRM contacts, ERP or e-shop customers, helpdesk contacts. Calls then show the caller's name and company, the agent can [greet a known caller by name](https://docs.voicelogica.ai/agent-configuration/welcome-message/), and new people arrive every few hours. It is **off** by default, per integration, because not every company wants its CRM copied in.

1. Sidebar - **Integrations** - **Connected**. Open the integration.

2. Switch on **Sync contacts**. The first sync starts right away; after that it runs every few hours.

3. **Sync contacts now** runs it at once, whether the switch is on or off. The row shows the last sync and how many contacts were new and updated.

4. After the first sync, in Claude or ChatGPT ask to *show contact names on past calls* (`link_calls_to_named_contacts`). It merges the number-only contacts that past calls created into the named ones.

## What it copies

- Name, email, phones and company. The company becomes a company record in Contacts.
- Only **empty** fields are filled. Nothing someone typed in Voice Logica is overwritten.
- A person is matched by an earlier sync, then by phone, then by email, so running it again does not make duplicates.
- People with **only a phone number** are skipped: a call already makes a contact for a number.

## Which integrations

Every integration that keeps its contacts or customers in Voice Logica: HubSpot, GoHighLevel, Salesforce, Freshdesk, Zendesk, SoftOne, Galaxy, Galaxy ERP, Entersoft, Pylon, SAP, Odoo, Megasoft, Splynx, WooCommerce, Shopify, Magento, PrestaShop, OpenCart, GonnaOrder, Guesty (owners) and Hosthub (guests). Zoho and WebHotelier are looked up live and have no copy to sync, so they show no switch.

## From Claude or ChatGPT

- `crm_query` action `get_contact_sync`: each integration with its switch, last sync and result.
- `crm_execute` action `update_contact_sync` with `provider` and `enabled`.
- `crm_execute` action `sync_contacts_now` with `provider`.
- `crm_execute` action `import_contacts_from_crm` imports page by page, with `dryRun` to count first.

**What happens to the contacts when I switch Sync contacts off?**

They stay in Contacts. Off only stops new syncs.

**Someone I added in the CRM today is not in Contacts yet. Why?**

Sync contacts copies from the integration's own sync, which refreshes daily or more often depending on the integration. The person arrives on the next run after that.

**Do I lose the switch if I reconnect the integration?**

No. Reconnecting keeps **Sync contacts** and the caller-card settings.
