# 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.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mercuri.cx/mercuri-docs-pt/guia-de-integracoes/hubspot/usando-a-mercuri-no-hubspot/hubspot-contact-sync.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.