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

# Salesforce

> Sincronize contatos do Wave com o Salesforce como Leads ou Contatos

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

A integração com Salesforce sincroniza contatos do Wave para o Salesforce como Leads ou Contatos — sua escolha na configuração. O Wave usa um campo de ID externo personalizado para fazer upsert dos registros, evitando duplicatas mesmo que um registro já exista. Ambientes de produção e sandbox do Salesforce são suportados.

## Como Conectar

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

  <Step title="Escolha o tipo de registro">
    Escolha se deseja sincronizar os contatos como **Leads** ou **Contatos**.
  </Step>

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

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

O Wave solicita acesso offline (para manter a conexão ativa sem logins repetidos) e acesso de leitura/escrita para criar e atualizar registros no Salesforce.

## O Que É Sincronizado

| Campo no Wave                | Campo no Salesforce                  |       Leads       | Contatos |
| ---------------------------- | ------------------------------------ | :---------------: | :------: |
| Nome                         | `FirstName`                          |        Sim        |    Sim   |
| Sobrenome                    | `LastName`                           |        Sim        |    Sim   |
| E-mail principal             | `Email`                              |        Sim        |    Sim   |
| Telefone principal           | `Phone`                              |        Sim        |    Sim   |
| Cargo                        | `Title`                              |        Sim        |    Sim   |
| Empresa                      | `Company`                            | Sim (obrigatório) |     -    |
| Nota do contato              | `Description`                        |        Sim        |    Sim   |
| Origem do lead               | `LeadSource` = "Wave Connect"        |        Sim        |     -    |
| Membro da equipe responsável | `OwnerId` (correspondido por e-mail) |        Sim        |    Sim   |

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

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

## Funcionalidades

* **Leads ou Contatos**: escolha o tipo de registro Salesforce que se adapta ao seu fluxo de trabalho.
* **Suporte a sandbox**: conecte-se a um ambiente sandbox do Salesforce para testes.
* **Sincronização automática ao conectar**: importa todos os contatos Wave existentes na primeira conexão.
* **Deduplicação**: um campo de ID externo personalizado (`WaveConnectId__c`) é criado automaticamente e usado para upserts, garantindo que a ressincronização nunca crie duplicatas.
* **Atribuição de proprietário**: os contatos são atribuídos ao usuário Salesforce cujo e-mail corresponde ao do membro da equipe no Wave.

## Adicionar Manualmente o Campo de ID Externo

O Wave normalmente cria o campo de ID externo `WaveConnectId__c` automaticamente quando você conecta. Você só precisará desta etapa se se conectar **sem uma conta de administrador Salesforce**, pois criar um campo personalizado requer permissões de administrador. Nesse caso, peça ao administrador Salesforce para adicionar o campo manualmente.

<Steps>
  <Step title="Abra o objeto Lead">
    No **Configuração** do Salesforce, acesse o **Gerenciador de Objetos** e selecione o objeto **Lead**.
  </Step>

  <Step title="Verifique o campo">
    Em **Campos e Relacionamentos**, verifique se `WaveConnectId__c` já existe.
  </Step>

  <Step title="Crie o campo">
    Se não existir, clique em **Novo**, selecione **Texto** como tipo de campo e nomeie-o de modo que o nome da API seja `WaveConnectId__c`.
  </Step>

  <Step title="Configure a segurança em nível de campo">
    Confirme que o **Usuário Padrão** tem acesso de leitura/escrita ao campo.
  </Step>

  <Step title="Adicione aos layouts de página e salve">
    Adicione o campo aos layouts de página relevantes e salve.
  </Step>
</Steps>

<Note>
  Se o campo já existir, abra-o e selecione **Definir Segurança em Nível de Campo** para confirmar que o **Usuário Padrão** tem acesso de leitura/escrita. Para mais detalhes, consulte o [guia de configuração do Salesforce](https://support.wavecnct.com/en/articles/10492839-salesforce).
</Note>

## Limitações e Requisitos

* O campo personalizado `WaveConnectId__c` é criado automaticamente na sua conta Salesforce. Não o exclua nem renomeie. Ele é usado para deduplicação.
* Para Leads, o campo `Company` é obrigatório pelo Salesforce. Se um contato do Wave não tiver empresa, o padrão é `N/A`.
* Se o Salesforce detectar uma duplicata por meio de suas regras de duplicatas, o Wave substitui a regra e salva o registro.
* A correspondência de proprietários é feita por e-mail. Se nenhum usuário Salesforce correspondente for encontrado, o contato é salvo sem proprietário.

## Desconectar

Acesse **Integrações → Salesforce** e clique em **Desconectar**. Isso remove a integração e revoga o acesso do Wave. Os registros já sincronizados com o Salesforce não são excluídos.