> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> Sincronize contatos do Wave com o HubSpot CRM em tempo real

<Info>
  Disponível nos planos **Pro**, **Teams** e **Enterprise**.
</Info>

A integração com HubSpot sincroniza automaticamente os contatos que você captura pelo Wave para o seu HubSpot CRM como Contatos. Quando um contato é criado, atualizado ou excluído no Wave, o HubSpot é atualizado em tempo real — sem necessidade de importações manuais. As notas dos contatos são mantidas sincronizadas como Notas vinculadas no HubSpot.

## Como Conectar

<Steps>
  <Step title="Abra a integração">
    Acesse **Integrações → HubSpot**.
  </Step>

  <Step title="Ative a sincronização automática (opcional)">
    Ative a **Sincronização automática** para importar todos os contatos Wave existentes para o HubSpot imediatamente.
  </Step>

  <Step title="Conecte o HubSpot">
    Clique em **Conectar** e faça login na sua conta HubSpot.
  </Step>
</Steps>

O Wave solicita permissão para ler e escrever contatos no CRM, ler o schema de contatos (para criar propriedades personalizadas) e ler os proprietários do HubSpot (para atribuir contatos).

## O Que É Sincronizado

| Campo no Wave                | Campo no HubSpot                                   |
| ---------------------------- | -------------------------------------------------- |
| Nome                         | `firstname`                                        |
| Sobrenome                    | `lastname`                                         |
| E-mail principal             | `email`                                            |
| Telefone principal           | `phone`                                            |
| Empresa                      | `company`                                          |
| Cargo                        | `jobtitle`                                         |
| Cidade                       | `city`                                             |
| Idioma                       | `hs_language`                                      |
| URL do perfil                | `website`                                          |
| Nota do contato              | Nota vinculada no HubSpot                          |
| Membro da equipe responsável | Proprietário no HubSpot (correspondido por e-mail) |

**Direção da sincronização**: Wave → HubSpot (somente de saída)

**Quando sincroniza**: Em tempo real ao criar, atualizar ou excluir um contato

## Funcionalidades

* **Sincronização automática ao conectar**: importa todos os contatos Wave existentes para o HubSpot na primeira conexão.
* **Deduplicação**: se um contato com o mesmo e-mail principal já existir no HubSpot, o Wave o atualiza em vez de criar uma duplicata.
* **Sincronização de notas**: notas de contatos escritas no Wave são criadas ou atualizadas como Notas vinculadas no HubSpot.
* **Atribuição de proprietário**: os contatos são automaticamente atribuídos ao proprietário HubSpot correspondente com base no endereço de e-mail.

## Limitações e Requisitos

* Se o seu plano HubSpot atingiu o limite de contatos, novos contatos não serão sincronizados.
* A correspondência de proprietários é feita por e-mail. Se o e-mail de um membro da equipe não corresponder a nenhum proprietário no HubSpot, o contato é criado sem proprietário.
* Duas propriedades personalizadas ocultas (`wave_sync_id`, `wave_note_id`) são criadas na sua conta HubSpot durante a configuração. Elas são usadas para deduplicação e não devem ser excluídas.

## Desconectar

Acesse **Integrações → HubSpot** e clique em **Desconectar**. Isso remove a integração e revoga o acesso do Wave à sua conta HubSpot. Os contatos já sincronizados permanecem no HubSpot.