# HubSpot Contact Sync

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2F4Cr9BqrBUvFhtP6ScvP7%2FScreenshot%202025-08-12%20at%205.35.41%E2%80%AFPM.png?alt=media&#x26;token=d409d813-8bba-413b-aa7f-6a1b9e3aa7e2" alt=""><figcaption></figcaption></figure>

#### Visão geral da sincronização de contatos

O botão **Sync Contacts** no Mercuri facilita a manutenção do seu banco de dados de contatos sincronizado com o HubSpot. Ao clicar, o Mercuri busca automaticamente todos os contatos da sua conta HubSpot conectada e atualiza a lista de contatos do Mercuri.

***

#### Como funciona

1. **Iniciar sincronização**\
   Na visualização **Contacts** do Mercuri, clique no botão **Sync Contacts** no canto superior direito.
2. **Busca no HubSpot**\
   O Mercuri usará seu token OAuth do HubSpot conectado para chamar a HubSpot Contacts API.
3. **Dados importados**
   * Todos os contatos do HubSpot são buscados.
   * Campos padrão como Primeiro Nome, Sobrenome, Telefone e E-mail são mapeados no Mercuri.
   * Se a sincronização bidirecional estiver habilitada, os contatos existentes no Mercuri serão atualizados com os dados mais recentes do HubSpot.
4. **Tratamento de duplicados**\
   Se o Mercuri detectar contatos com o mesmo número de telefone ou e-mail, eles serão sinalizados como duplicados. Você pode revisá-los clicando em **Manage** no banner Duplicate Contacts.
5. **Status de assinatura**\
   O Mercuri pode marcar contatos como **Subscribed** ou **Not Subscribed** com base nas propriedades de opt-in do HubSpot (se configuradas nas definições).

***

#### Boas práticas

* **Normalize os números de telefone** no HubSpot para o formato E.164 para melhor correspondência.
* Configure uma programação de sincronização regular se sua lista de contatos do HubSpot mudar com frequência.
* Revise e mescle duplicados periodicamente para manter os dados limpos.
* Certifique-se de que as propriedades do HubSpot usadas para mapeamento (como status de opt-in) estejam sempre atualizadas.

***